TrueProxies

com.trueproxiesv1.0.2Updated Sep 29, 2026

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

VerifiedStreamable HTTPWeb executableBusiness & CommerceCloud & Infrastructure

Overview

AI-generated overview

Lets an assistant read your TrueProxies account: plans, services, traffic, usage history and invoices, and generate proxy endpoints.

What it does
Connects an MCP client to a TrueProxies account. Read tools cover plans and prices, account and service details, traffic used and remaining, live speeds, usage history, invoices and trusted IPs. generate_endpoints returns proxy connection lines including the username and password, and check_connection sends one request through your service and reports the result and exit IP.
When to use it
Use it when you want an assistant to answer questions about your proxy plans, services, traffic consumption or invoices without opening the dashboard, or to produce connection lines and verify that a proxy works.
Requirements
Remote endpoint at over streamable HTTP, or a local Docker or Go install. A TrueProxies API key is sent in the Authorization header as 'Bearer tp_api_...'; list_plans works without one. Scopes: services:read, billing:read, proxy:read. Network access to api.trueproxies.com.
Before you install
The API key is forwarded to api.trueproxies.com on each call. generate_endpoints returns proxy connection lines containing your proxy password, so grant proxy:read only when needed. check_connection sends a request through your service, uses a little traffic and can start an unused free trial. The server cannot buy, pay, change your proxy password or change trusted IPs.

Installation

In SourceWeft

  1. Open TrueProxies in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.trueproxies.com/mcp"
    }
  }
}

README

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 or check connections: endpoints contain your proxy password.

Connect

Hosted (nothing to install):

bash
claude mcp add --transport http trueproxies https://mcp.trueproxies.com/mcp \  --header "Authorization: Bearer $TRUEPROXIES_API_KEY"

Cursor (~/.cursor/mcp.json):

json
{  "mcpServers": {    "trueproxies": {      "url": "https://mcp.trueproxies.com/mcp",      "headers": { "Authorization": "Bearer ${env:TRUEPROXIES_API_KEY}" }    }  }}

Local, with Docker. Build the image once:

bash
docker build -t trueproxies-mcp https://github.com/trueproxies-com/trueproxies-mcp.git
json
{  "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.

Links

License

MIT

Source: README.md at commit 5587339

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.2LatestSep 29, 2026