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

Tool	What it returns	API key scope
list_plans	Plans, traffic packs, prices, cities, free trial availability	none
get_account	Your account	services:read
list_services	Your services	services:read
get_service	One service: hosts, ports, capabilities, limits	services:read
get_traffic_used	Traffic used and remaining	services:read
get_live_traffic	Live download and upload speed, traffic used today	services:read
get_usage_history	Connection success, traffic and connection errors over 24h, 7d or 30d	services:read
list_invoices	Your invoices	billing:read
get_invoice	One invoice	billing:read
generate_endpoints	Proxy connection lines, including the username and password	proxy:read
check_connection	The result and exit IP of one request through your service. It uses a little traffic and starts an unused free trial.	proxy:read
list_trusted_ips	Trusted IPs of a service	proxy:read

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 TRUEPROXIES_API_KEY 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