TrueProxies — Claude Code MCP server: what it does, how to install
Wires your TrueProxies account into an MCP client so the assistant can read plans, services, traffic and invoices.
claude mcp add --transport http mcp https://mcp.trueproxies.com/mcpWhat TrueProxies does
This server exposes your TrueProxies account to the assistant: available plans with prices, your services, traffic spent and left, current download and upload speed, usage history across 24h, 7d or 30d windows, and invoices. It also builds proxy connection lines and can test a connection with a single request.
Every tool is read-only except check_connection. Buying, paying, rotating your proxy password or editing trusted IPs is out of scope. The connection check burns a bit of traffic and activates an unused free trial, so think twice if you were saving that trial.
You create the API key in the TrueProxies dashboard. Read-only use needs services:read and billing:read. Add proxy:read only when the assistant should generate endpoints, run connection checks or list trusted IPs, because endpoint lines carry your proxy password. The hosted endpoint sits behind Cloudflare, which decrypts traffic in transit, so your key and any endpoints pass through it. Run the server locally with Docker or Go if that matters to you.
What it helps with
- check remaining traffic on a service
- compare plans and prices before buying
- pull a list of invoices
- verify that a proxy actually responds
- build a connection line with username and password
Example prompts for the agent
- List my TrueProxies services and the traffic left on each
- Generate endpoints for my service and run a connection check
- What plans and prices does TrueProxies offer?
How to install TrueProxies
Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.trueproxies.com/mcpPlatform CLI: remote server
codex mcp add trueproxies --url https://mcp.trueproxies.com/mcpConfig file
{
"mcpServers": {
"trueproxies": {
"url": "https://mcp.trueproxies.com/mcp"
}
}
}Config file
{
"servers": {
"trueproxies": {
"type": "http",
"url": "https://mcp.trueproxies.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http trueproxies https://mcp.trueproxies.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about TrueProxies
How do I install TrueProxies in Claude Code?
Run claude mcp add --transport http trueproxies https://mcp.trueproxies.com/mcp, then pass your key in the Authorization: Bearer $TRUEPROXIES_API_KEY header.
What does TrueProxies do?
It gives the assistant read access to your TrueProxies account: plans, services, traffic, usage history, invoices, plus endpoint generation and a connection check.
Which API key scopes do I need?
services:read and billing:read cover read-only use. Add proxy:read if you want endpoints, connection checks or the trusted IP list.
