MCP for agents

Trancepad ships a read-only Model Context Protocol server under mcp/. Use it from Cursor, Claude Desktop, or Claude Code to discover tokens, charts, portfolios, Raises, and stats via the public Developer API. It does not launch tokens, buy, sell, or expose admin routes.

Prerequisites

• Node.js 22+
• A checkout that includes mcp/
• Reachable Trancepad API (production or local backend on :4000)

Install and smoke test

cd mcp
npm install
# optional: cp .env.example .env  # TRANCEPAD_API_URL=http://localhost:4000
npm start

The process waits on stdio (no interactive banner on stdout). Stop with Ctrl+C. Run npm run typecheck and npm test for a typed check.

Wire Cursor

Use an absolute path to this repo:

{
  "mcpServers": {
    "trancepad": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/Trancepad/mcp/src/index.ts"],
      "env": {
        "TRANCEPAD_API_URL": "https://api.trancepad.xyz"
      }
    }
  }
}

Reload MCP servers, then ask: "Use Trancepad MCP to list trending tokens." Claude Desktop and Claude Code take the same mcpServers.trancepad block (restart the host after saving).

Tools

Tools are named trancepad_*, including:

• trancepad_health
• trancepad_list_tokens / trancepad_get_token
• trancepad_get_token_chart / trancepad_get_token_trades / trancepad_get_token_holders
• trancepad_search, trancepad_get_stats, trancepad_get_leaderboard, trancepad_get_portfolio
• Raises and launchpad feed tools
• trancepad_external_market

Resources: trancepad://docs/overview, trancepad://docs/fees-graduation, trancepad://config. Prompts: explore_trending, analyze_token, wallet_snapshot.

Troubleshooting

Tools missing

Confirm absolute path, npm install in mcp/, and host restart.

Timeout / connection errors

Check TRANCEPAD_API_URL, VPN/firewall, or local API on :4000.

Empty lists

Production may be quiet; try a seeded local API or trancepad_get_stats.

Product landing: Integration overview. SDK status page in the app: /sdk. Repo quickstart: docs/mcp.md. Full tool table: mcp/README.md. Machine-readable site index for LLMs: /llms.txt.