TrueProxies MCP server

TrueProxies MCP server

Connect Claude, Cursor or any MCP client to your TrueProxies account. Ask about plans and prices, your services, traffic used, live traffic, usage history and invoices, generate endpoints and check a connection.

The server cannot buy, pay, change your proxy password or change trusted IPs. Every tool only reads, except check_connection, which sends one request through your service.

Tools

API key

Create an API key in the TrueProxies dashboard under API keys. For read-only use, give it services:read and billing:read. Add proxy:read only if the assistant should generate endpoints, check connections or list trusted IPs: endpoints contain your proxy password.

Connect

Hosted (nothing to install):

claude mcp add --transport http trueproxies https://mcp.trueproxies.com/mcp \
  --header "Authorization: Bearer $TRUEPROXIES_API_KEY"

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "trueproxies": {
      "url": "https://mcp.trueproxies.com/mcp",
      "headers": { "Authorization": "Bearer ${env:TRUEPROXIES_API_KEY}" }
    }
  }
}

Local, with Docker. Build the image once:

docker build -t trueproxies-mcp https://github.com/trueproxies-com/trueproxies-mcp.git

{
  "mcpServers": {
    "trueproxies": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "TRUEPROXIES_API_KEY", "trueproxies-mcp"],
      "env": { "TRUEPROXIES_API_KEY": "tp_api_..." }
    }
  }
}

Local, with Go: go install github.com/trueproxies-com/trueproxies-mcp@latest, then run trueproxies-mcp stdio with TRUEPROXIESAPIKEY set.

Privacy

The hosted server forwards your API key to api.trueproxies.com for each call and keeps nothing. It logs the tool name, status, request ID and duration, never arguments, results or keys. mcp.trueproxies.com is served through Cloudflare, which decrypts traffic in transit like any Cloudflare-proxied site, so your API key and any endpoints pass through Cloudflare. To avoid that, run the server locally.

Links

• TrueProxies
• API reference
• Pricing

License

MIT