About TrueProxies
TrueProxies is an MCP server for account holders to inspect proxy plans, services, usage, invoices, and connection details. Its tools are read-only except for a connection check that sends a request through the service.
Key features
- 01View plans and prices
- 02Inspect services and capabilities
- 03Check traffic and usage history
- 04Review invoices
- 05Generate endpoints and list trusted IPs
- 06Test a connection and view its exit IP
Use cases
- 01Check remaining traffic before a workload
- 02Review service limits and connection errors
- 03Retrieve an invoice or generate proxy endpoints
- 04Verify a proxy connection and exit IP
MCP support
Exposes TrueProxies account and proxy information to MCP clients through hosted or locally run server options. Most tools only read data; `check_connection` sends one request through the service.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.trueproxies.com/mcpclaude mcp add --transport http com-trueproxies https://mcp.trueproxies.com/mcp{"mcpServers":{"com-trueproxies":{"type":"http","url":"https://mcp.trueproxies.com/mcp"}}}Open in Cursor{"servers":{"com-trueproxies":{"type":"http","url":"https://mcp.trueproxies.com/mcp"}}}Open in VS Code{"mcpServers":{"com-trueproxies":{"type":"http","url":"https://mcp.trueproxies.com/mcp"}}}{"mcpServers":{"com-trueproxies":{"serverUrl":"https://mcp.trueproxies.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://mcp.trueproxies.com/mcpAuth requiredTools
12| Parameter | Type | Required | Description |
|---|---|---|---|
| asn | string | No | ASN digits without the AS prefix, if the service supports ASN targeting |
| city | string | No | City in lowercase letters, digits and underscores, if the service supports city targeting |
| region | string | No | Region code, if the service supports region targeting |
| country | string | No | Two-letter country code, if the service supports country targeting |
| session | enum | No | Session type. sticky (Sticky) reuses an IP while available, for the session lifetime. rotate (Rotating) requests a new IP per connection, and the same IP can appear again. none uses the service default.none | sticky | rotate |
| lifetime | integer | No | Sticky session lifetime in seconds, only with session sticky: 60 to 86400, or from 1 when the service has session_lifetime_seconds, at most 1800 with session_lifetime_30m, and whole minutes on Residential IPv4 Unlimited |
| protocol | enum | No | http, https or socks5http | https | socks5 |
| service_id | string | Yes | Service ID (a UUID) from list_services |
Details
From the project READMETrueProxies 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
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.