com.trueproxiesPublished by trueproxies.comOfficial publisherv1.0.6Updated Nov 7, 2026
Plans, services, usage, invoices, endpoints and connection checks for your TrueProxies account
Read-only access to a TrueProxies account: plans, services, traffic, usage history, invoices, proxy endpoints and connection checks.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/com.trueproxies%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"trueproxies": {
"type": "http",
"url": "https://mcp.trueproxies.com/mcp"
}
}
}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.
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.
Hosted (nothing to install):
Cursor (~/.cursor/mcp.json):
Local, with Docker. Build the image once:
Local, with Go: go install github.com/trueproxies-com/trueproxies-mcp@latest, then run trueproxies-mcp stdio with TRUEPROXIES_API_KEY set.
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.
MIT
Source: README.md at commit 6c707fa
Check connection
Sends one request through the service from TrueProxies and reports the outcome and exit IP, to tell a proxy problem apart from a website refusing you. It counts as use of the service: it uses a little traffic and starts an unused free trial. Does not measure speed. Limited to a few checks a minute.
asncityregioncountrysessionlifetimeprotocolservice_idrequiredGenerate endpoints
Builds proxy connection lines for a service with the chosen protocol, format, location targeting and session type: one line, or up to 50,000 sticky sessions with session sticky. Does not change the service. The output contains the proxy username and password, which let anyone who has them use the service.
asncitycountformatregioncountrysessionlifetimeprotocolservice_idrequiredGet your account
Returns the TrueProxies account that owns the API key: account reference, email, role, status and billing details.
Takes no parameters.
Get an invoice
Returns one invoice: status, amounts in cents, payment attempts and its service. Does not start a payment.
invoice_idrequiredGet live traffic
Returns live traffic for one service: download and upload speed in bits per second over the last ten seconds, traffic used today (UTC) and recent connection outcomes. last_activity_at shows how fresh the data is.
service_idrequiredGet a service
Returns one service: status, expiry, connection hosts and ports, capabilities (the targeting and session options it supports) and effective limits. Does not return the proxy password.
service_idrequiredGet traffic used and remaining
Returns traffic for one service, in bytes: bytes_out is downloaded and bytes_in is uploaded since the service started, remaining_bytes is traffic remaining and allowance_bytes is the allowance. traffic_batches lists traffic packs; traffic bought now never expires, and only older packs carry an expiry. Traffic can take about a minute to appear.
service_idrequiredGet usage history
Returns usage history for one service, or for the whole account when service_id is empty: connection success, traffic and connection errors over the last 24h, 7d or 30d. In series, bytes_out is downloaded and bytes_in is uploaded. Can lag recent traffic.
rangeservice_idList invoices
Lists invoices with status (open, paid or cancelled), kind, amount in cents and the service each belongs to. Paginated: pass next_cursor from the previous response as cursor.
kindlimitcursorstatusservice_idList plans and prices
Lists TrueProxies plans and traffic packs: price in US cents, term, speed, connection limits, traffic allowance and targeting capabilities. Also returns the cities available for city targeting and whether the free trial is open. Traffic packs (residential_ipv4_gb, residential_ipv4_premium, residential_ipv4_lite) have no term, and their traffic never expires. Static ISP (isp_dedicated) is priced per IP for each carrier, named in display_name. No API key needed.
termproductList your services
Lists the services on the account with status, product, plan, expiry and connection hosts. Paginated: pass next_cursor from the previous response as cursor.
viewlimitcursorList whitelisted IPs
Lists the IP whitelist of a service: addresses allowed to connect without the proxy password.
service_idrequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
claude mcp add --transport http trueproxies https://mcp.trueproxies.com/mcp \ --header "Authorization: Bearer $TRUEPROXIES_API_KEY"{ "mcpServers": { "trueproxies": { "url": "https://mcp.trueproxies.com/mcp", "headers": { "Authorization": "Bearer ${env:TRUEPROXIES_API_KEY}" } } }}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_..." } } }}