English Français العربية

TrueProxies

Official registry Finance and payments

Plans, services, usage, invoices, endpoints and connection checks for your TrueProxies account

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http trueproxies 'https://mcp.trueproxies.com/mcp' --header 'Authorization: <TrueProxies API key as '\''Bearer tp_api_...'\''. list_plans works without one.>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "trueproxies": {
            "type": "http",
            "url": "https://mcp.trueproxies.com/mcp",
            "headers": {
                "Authorization": "<TrueProxies API key as 'Bearer tp_api_...'. list_plans works without one.>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. TrueProxies MCP server
  2. Tools
  3. API key
  4. Connect
  5. Privacy
  6. Links
  7. License

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

ToolWhat it returnsAPI key scope
list_plansPlans, traffic packs, prices, cities, free trial availabilitynone
get_accountYour accountservices:read
list_servicesYour servicesservices:read
get_serviceOne service: hosts, ports, capabilities, limitsservices:read
get_traffic_usedTraffic used and remainingservices:read
get_live_trafficLive download and upload speed, traffic used todayservices:read
get_usage_historyConnection success, traffic and connection errors over 24h, 7d or 30dservices:read
list_invoicesYour invoicesbilling:read
get_invoiceOne invoicebilling:read
generate_endpointsProxy connection lines, including the username and passwordproxy:read
check_connectionThe 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_ipsTrusted IPs of a serviceproxy: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.

License

MIT

Frequently asked questions

What is TrueProxies?

Plans, services, usage, invoices, endpoints and connection checks for your TrueProxies account

How do I install TrueProxies?

It runs as a remote server. In Claude Code: claude mcp add --transport http trueproxies 'https://mcp.trueproxies.com/mcp' --header 'Authorization: <TrueProxies API key as '\''Bearer tp_api_...'\''. list_plans works without one.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does TrueProxies need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is TrueProxies open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains TrueProxies?

It is published by trueproxies-com. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.