Skip to main content
Glama

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 the IP whitelist. 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

The IP whitelist of a service

proxy:read

Related MCP server: proxy

API key

Create an API key in the TrueProxies dashboard under API. 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 whitelisted 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables fetching web URLs through authenticated residential egress with provider, country, and session controls. It also exposes tools for checking the exit IP, account status, and masked connection URL.
      15 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables MCP clients to manage a Webshare account through the official API, including subscription and traffic checks, proxy listing, targeted IP replacement, and IP whitelist management, with safe previews and confirmations for destructive actions.
      14
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to check Proxy302 account usage, browse countries, regions and plans, obtain rotating residential proxy URLs, list dynamic proxies and static IPs, and fetch web pages through a chosen country's exit. It is read-only and spend-free, handing proxy credentials to browsers or Playwright for JavaScript-heavy sites.
      7
      339 npm
      1
      MIT