TrueScreen MCP Server

Local MCP server for the TrueScreen Public API.

This package runs as a local stdio MCP server and is designed to be launched by MCP clients such as Cursor or Claude Desktop. It gives AI clients access to curated TrueScreen tools for:

• credits and certification status,
• hash certifications,
• file certifications using files on your machine,
• template discovery,
• True Flow creation,
• True Flow attachment upload.

Public documentation: TrueScreen MCP integration guide.

Requirements

• Node.js >= 20
• A valid TrueScreen API key
• An MCP client that supports stdio

Important

Use this package as a command executed by your MCP client.

In normal usage, you do not add it to your application with:

npm i @truescreen/mcp

Instead, configure your MCP client to run:

npx -y @truescreen/mcp

Configuration

This package reads configuration from environment variables:

• TRUESCREEN_API_KEY required. Used for Public API calls.
• MCP_ENV optional. Supported values: stg, prod. If unset, production is used.

The API key can be provided either as the raw key or as a full Bearer value. For example, both of these work:

TRUESCREEN_API_KEY=abc...
TRUESCREEN_API_KEY=Bearer abc...

Cursor

Add the following to your mcp.json:

{
  "mcpServers": {
    "truescreen-local": {
      "command": "npx",
      "args": ["-y", "@truescreen/mcp"],
      "env": {
        "TRUESCREEN_API_KEY": "abc..."
      }
    }
  }
}

Cursor with staging

{
  "mcpServers": {
    "truescreen-local": {
      "command": "npx",
      "args": ["-y", "@truescreen/mcp"],
      "env": {
        "TRUESCREEN_API_KEY": "abc...",
        "MCP_ENV": "stg"
      }
    }
  }
}

Claude Desktop

Add the same server definition to claude_desktop_config.json:

{
  "mcpServers": {
    "truescreen-local": {
      "command": "npx",
      "args": ["-y", "@truescreen/mcp"],
      "env": {
        "TRUESCREEN_API_KEY": "abc..."
      }
    }
  }
}

Zed

Add the following to your settings.json:

{
  "context_servers": {
    "truescreen-local": {
      "command": {
        "path": "npx",
        "args": ["-y", "@truescreen/mcp"],
        "env": {
          "TRUESCREEN_API_KEY": "abc..."
        }
      },
      "settings": {}
    }
  }
}

GitHub Copilot CLI

Add the server to ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "truescreen-local": {
      "command": "npx",
      "args": ["-y", "@truescreen/mcp"],
      "env": {
        "TRUESCREEN_API_KEY": "abc..."
      }
    }
  }
}

What this package exposes

• truescreen_get_credits
• truescreen_list_templates
• truescreen_create_true_flow
• truescreen_create_hash_certification
• truescreen_get_certification
• truescreen_wait_for_certification
• truescreen_create_file_certification_attachments
• truescreen_upload_file
• truescreen_create_file_certification
• truescreen_create_true_flow_attachment

MCP to REST mapping

| MCP tool | REST call | |----------|-----------| | truescreen_get_credits | GET /v1/credits | | truescreen_list_templates | GET /v1/templates | | truescreen_create_true_flow | POST /v1/true-flows | | truescreen_create_hash_certification | POST /v1/hash-certifications | | truescreen_get_certification | GET /v1/certifications/{reportId} | | truescreen_wait_for_certification | polling GET /v1/certifications/{reportId} | | truescreen_create_file_certification_attachments | POST /v1/file-certifications-attachments | | truescreen_upload_file | PUT presigned upload URL | | truescreen_create_file_certification | POST /v1/file-certifications | | truescreen_create_true_flow_attachment | POST /v1/true-flows-attachments plus upload |

Notes

• This package uses stdio transport only.
• The MCP client starts the process for you.
• File upload tools are available only in this local package because they require access to local file paths.