trodomcp

Stdio wrapper for Trodo's MCP server. Lets any stdio MCP client (Claude Code CLI, Cursor, MCP Inspector, custom scripts) connect to mcp.trodo.ai with a direct API key — no browser OAuth flow needed.

Quick start

1. Generate an API key from app.trodo.ai/settings/integrations/mcp. Requires a Growth or Enterprise plan.
2. Use npx -y trodomcp as the stdio command in your client config.

Claude Code CLI

claude mcp add trodo \
  --transport stdio \
  --command "npx -y trodomcp" \
  --env TRODO_MCP_API_KEY=trodo_mk_xxx

Or for HTTP transport (no wrapper needed):

claude mcp add trodo \
  --transport http \
  --url https://mcp.trodo.ai/mcp \
  --header "Authorization: Bearer trodo_mk_xxx"

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "trodo": {
      "command": "npx",
      "args": ["-y", "trodomcp"],
      "env": { "TRODO_MCP_API_KEY": "trodo_mk_xxx" }
    }
  }
}

MCP Inspector

TRODO_MCP_API_KEY=trodo_mk_xxx npx @modelcontextprotocol/inspector npx -y trodomcp

Claude.ai web / Claude Desktop

These use OAuth, not API keys. Add a custom connector with URL https://mcp.trodo.ai/mcp and complete the consent flow in your browser.

Configuration

| Variable | Default | Description | |---|---|---| | TRODO_MCP_API_KEY | (required) | Key prefixed with trodo_mk_. | | TRODO_MCP_URL | https://mcp.trodo.ai/mcp | Override for staging. | | TRODO_MCP_TIMEOUT_MS | 60000 | Per-request timeout. | | TRODO_MCP_DEBUG | 0 | Set to 1 to log diagnostics to stderr. |

CLI flags --url, --api-key, --debug override the env vars.

How it works

JSON-RPC messages on stdin → forwarded to mcp.trodo.ai/mcp over HTTPS with the bearer header → response written back to stdout. Same protocol both sides; the wrapper is just a transport adapter.

Zero runtime dependencies. Pure Node 18+ (uses native fetch).

Troubleshooting

• TRODO_MCP_API_KEY is required — generate one at the Settings link above.
• HTTP 401 — key has been revoked or expired. Issue a new one.
• HTTP 402 — your team is on the Free plan; upgrade to Growth/Enterprise to use MCP.
• HTTP 429 — rate-limited. Default is 600 calls/minute per key.
• HTTP 403 with "scope" in the message — the key needs an additional scope (e.g. mcp:user:read_pii for user-lookup tools). Re-issue with the right scopes from Settings.

For everything else: see docs.trodo.ai/mcp or email [email protected].

License

Apache-2.0