@ton/mcp-developer-portal

@ton/mcp-developer-portal

TON Developer Portal — Model Context Protocol (MCP) bridge for AI agents.

A small Node bridge that authorizes you to your TON developer account via browser, then exposes TON Developer Portal tools (project management, analytics, testnet faucet, docs search) over stdio to any MCP-capable AI agent.

Install

Claude Code

claude mcp add ton-developer-portal -- npx -y @ton/mcp-developer-portal

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) — or %APPDATA%\Claude\claude_desktop_config.json (Windows) / ~/.config/Claude/claude_desktop_config.json (Linux):

{
  "mcpServers": {
    "ton-developer-portal": {
      "command": "npx",
      "args": ["-y", "@ton/mcp-developer-portal"]
    }
  }
}

Fully quit and reopen Claude Desktop (cmd+Q, not just close window) to pick up the new server.

Cursor / Cline / VS Code

Same JSON shape, different config file path:

{
  "mcpServers": {
    "ton-developer-portal": {
      "command": "npx",
      "args": ["-y", "@ton/mcp-developer-portal"]
    }
  }
}

• Cursor: ~/.cursor/mcp.json
• Cline: ~/.config/cline/mcp_settings.json
• VS Code (Anthropic MCP extension): user settings.json under mcp.servers

First run

Your AI agent will start the bridge automatically the first time it needs a TON tool. The bridge will print a verification URL and open your browser — sign in and approve. Subsequent runs reuse the cached token.

What you get

• Public tools (no auth): documentation search, SDK package lookup, code snippets, jetton metadata
• Authenticated tools (browser-approved): list projects, read project metrics, manage analytics keys, claim testnet TON, submit applications

Configuration

Override defaults via environment variables in your MCP client config:

• TON_MCP_URL — MCP HTTP endpoint (default https://builders-mcp.ton.org/)
• TON_OAUTH_ISSUER — OAuth issuer base URL (default https://builders-backend.ton.org)
• TON_OAUTH_CLIENT_ID — OAuth client id (default ton-developer-portal)
• TON_TOKEN_FILE_PATH — token cache path (default ~/.config/ton-developer-portal/tokens.json)
• TON_MCP_NO_BROWSER — set to any value to suppress auto-opening the browser (URL still printed on stderr)

Requirements

Node.js ≥ 20. No external dependencies.

License

MIT