TrueProxies

Official12 toolsLive

by trueproxies-com · Go

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

com.trueproxies/mcp (Model Context Protocol) Server

The com.trueproxies/mcp MCP server provides access to plans, services, usage, invoices, endpoints, and connection checks for a TrueProxies account. Its purpose is to expose account-related information and operational checks through MCP for developers integrating with TrueProxies.

🛠️ Key Features

Plans
Services
Usage
Invoices
Endpoints
Connection checks
TrueProxies account coverage

🚀 Use Cases

Reviewing subscription or plan details
Fetching service information tied to an account
Checking usage and billing invoices
Validating or discovering API endpoints
Performing connection checks for account connectivity

⚡ Developer Benefits

Centralized retrieval of account data categories (plans, services, usage, invoices)
Access to endpoint information and connectivity status via connection checks

Captured live from the server via tools/list.

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.

Parameters8

service_id	string	required	Service ID (a UUID) from list_services
protocol	string	optional	http, https or socks5
country	string	optional	Two-letter country code, if the service supports country targeting
city	string	optional	City in lowercase letters, digits and underscores, if the service supports city targeting
region	string	optional	Region code, if the service supports region targeting
asn	string	optional	ASN digits without the AS prefix, if the service supports ASN targeting
session	string	optional	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.
lifetime	integer	optional	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

Raw schema

{
  "type": "object",
  "properties": {
    "service_id": {
      "type": "string",
      "description": "Service ID (a UUID) from list_services"
    },
    "protocol": {
      "type": "string",
      "description": "http, https or socks5",
      "enum": [
        "http",
        "https",
        "socks5"
      ]
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code, if the service supports country targeting"
    },
    "city": {
      "type": "string",
      "description": "City in lowercase letters, digits and underscores, if the service supports city targeting"
    },
    "region": {
      "type": "string",
      "description": "Region code, if the service supports region targeting"
    },
    "asn": {
      "type": "string",
      "description": "ASN digits without the AS prefix, if the service supports ASN targeting"
    },
    "session": {
      "type": "string",
      "description": "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.",
      "enum": [
        "none",
        "sticky",
        "rotate"
      ]
    },
    "lifetime": {
      "type": "integer",
      "description": "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",
      "minimum": 1,
      "maximum": 86400
    }
  },
  "required": [
    "service_id"
  ],
  "additionalProperties": false
}

generate_endpoints

Builds proxy connection lines for a service with the chosen protocol, format, location targeting and session type: one line, or up to 1,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.

Parameters10

service_id	string	required	Service ID (a UUID) from list_services
protocol	string	optional	http, https or socks5
format	string	optional	Line format: host:port:user:pass (default), user:pass@host:port, user:pass, host:port, url or curl
count	integer	optional	With session sticky, how many sticky sessions to return, 1 to 1000. Other session types return one line.
country	string	optional	Two-letter country code, if the service supports country targeting
city	string	optional	City in lowercase letters, digits and underscores, if the service supports city targeting
region	string	optional	Region code, if the service supports region targeting
asn	string	optional	ASN digits without the AS prefix, if the service supports ASN targeting
session	string	optional	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.
lifetime	integer	optional	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

Raw schema

{
  "type": "object",
  "properties": {
    "service_id": {
      "type": "string",
      "description": "Service ID (a UUID) from list_services"
    },
    "protocol": {
      "type": "string",
      "description": "http, https or socks5",
      "enum": [
        "http",
        "https",
        "socks5"
      ]
    },
    "format": {
      "type": "string",
      "description": "Line format: host:port:user:pass (default), user:pass@host:port, user:pass, host:port, url or curl",
      "enum": [
        "host:port:user:pass",
        "user:pass@host:port",
        "user:pass",
        "host:port",
        "url",
        "curl"
      ]
    },
    "count": {
      "type": "integer",
      "description": "With session sticky, how many sticky sessions to return, 1 to 1000. Other session types return one line.",
      "minimum": 1,
      "maximum": 1000
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code, if the service supports country targeting"
    },
    "city": {
      "type": "string",
      "description": "City in lowercase letters, digits and underscores, if the service supports city targeting"
    },
    "region": {
      "type": "string",
      "description": "Region code, if the service supports region targeting"
    },
    "asn": {
      "type": "string",
      "description": "ASN digits without the AS prefix, if the service supports ASN targeting"
    },
    "session": {
      "type": "string",
      "description": "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.",
      "enum": [
        "none",
        "sticky",
        "rotate"
      ]
    },
    "lifetime": {
      "type": "integer",
      "description": "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",
      "minimum": 1,
      "maximum": 86400
    }
  },
  "required": [
    "service_id"
  ],
  "additionalProperties": false
}

get_account

Returns the TrueProxies account that owns the API key: account reference, email, role, status and billing details.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "additionalProperties": false
}

get_invoice

Returns one invoice: status, amounts in cents, payment attempts and its service. Does not start a payment.

Parameters1

invoice_id

string

required

Invoice ID (a UUID) from list_invoices

Raw schema

{
  "type": "object",
  "properties": {
    "invoice_id": {
      "type": "string",
      "description": "Invoice ID (a UUID) from list_invoices"
    }
  },
  "required": [
    "invoice_id"
  ],
  "additionalProperties": false
}

get_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.

Parameters1

service_id

string

required

Service ID (a UUID) from list_services

Raw schema

{
  "type": "object",
  "properties": {
    "service_id": {
      "type": "string",
      "description": "Service ID (a UUID) from list_services"
    }
  },
  "required": [
    "service_id"
  ],
  "additionalProperties": false
}

get_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.

Parameters1

service_id

string

required

Service ID (a UUID) from list_services

Raw schema

{
  "type": "object",
  "properties": {
    "service_id": {
      "type": "string",
      "description": "Service ID (a UUID) from list_services"
    }
  },
  "required": [
    "service_id"
  ],
  "additionalProperties": false
}

get_traffic_used

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 with their expiry. Traffic can take about a minute to appear.

Parameters1

service_id

string

required

Service ID (a UUID) from list_services

Raw schema

{
  "type": "object",
  "properties": {
    "service_id": {
      "type": "string",
      "description": "Service ID (a UUID) from list_services"
    }
  },
  "required": [
    "service_id"
  ],
  "additionalProperties": false
}

get_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.

Parameters2

service_id	string	optional	Service ID (a UUID) from list_services. Leave empty for the whole account.
range	string	optional	24h, 7d or 30d

Raw schema

{
  "type": "object",
  "properties": {
    "service_id": {
      "type": "string",
      "description": "Service ID (a UUID) from list_services. Leave empty for the whole account."
    },
    "range": {
      "type": "string",
      "description": "24h, 7d or 30d",
      "enum": [
        "24h",
        "7d",
        "30d"
      ]
    }
  },
  "additionalProperties": false
}

list_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.

Parameters5

service_id	string	optional	Only invoices for this service ID (a UUID)
status	string	optional	open, paid or cancelled
kind	string	optional	purchase, renewal, topup, custom, wallet_topup or white_label
cursor	string	optional	next_cursor from the previous page
limit	integer	optional	Page size, 1 to 100. Default 25.

Raw schema

{
  "type": "object",
  "properties": {
    "service_id": {
      "type": "string",
      "description": "Only invoices for this service ID (a UUID)"
    },
    "status": {
      "type": "string",
      "description": "open, paid or cancelled",
      "enum": [
        "open",
        "paid",
        "cancelled"
      ]
    },
    "kind": {
      "type": "string",
      "description": "purchase, renewal, topup, custom, wallet_topup or white_label",
      "enum": [
        "purchase",
        "renewal",
        "topup",
        "custom",
        "wallet_topup",
        "white_label"
      ]
    },
    "cursor": {
      "type": "string",
      "description": "next_cursor from the previous page"
    },
    "limit": {
      "type": "integer",
      "description": "Page size, 1 to 100. Default 25.",
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

list_plans

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) have no term; their traffic is valid for 30 days. No API key needed.

Parameters2

product	string	optional	Only this product: datacenter_ipv6, residential_ipv4_unlimited or residential_ipv4_gb
term	string	optional	Only this billing term: hour, day, week or month. Traffic packs have no term.

Raw schema

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string",
      "description": "Only this product: datacenter_ipv6, residential_ipv4_unlimited or residential_ipv4_gb",
      "enum": [
        "datacenter_ipv6",
        "residential_ipv4_unlimited",
        "residential_ipv4_gb"
      ]
    },
    "term": {
      "type": "string",
      "description": "Only this billing term: hour, day, week or month. Traffic packs have no term.",
      "enum": [
        "hour",
        "day",
        "week",
        "month"
      ]
    }
  },
  "additionalProperties": false
}

list_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.

Parameters3

view	string	optional	current (default) lists every service that is not closed; history lists closed services; all lists both
cursor	string	optional	next_cursor from the previous page
limit	integer	optional	Page size, 1 to 100. Default 25.

Raw schema

{
  "type": "object",
  "properties": {
    "view": {
      "type": "string",
      "description": "current (default) lists every service that is not closed; history lists closed services; all lists both",
      "enum": [
        "current",
        "history",
        "all"
      ]
    },
    "cursor": {
      "type": "string",
      "description": "next_cursor from the previous page"
    },
    "limit": {
      "type": "integer",
      "description": "Page size, 1 to 100. Default 25.",
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

list_trusted_ips

Lists the trusted IPs of a service: addresses allowed to connect without the proxy password.

Parameters1

service_id

string

required

Service ID (a UUID) from list_services

Raw schema

{
  "type": "object",
  "properties": {
    "service_id": {
      "type": "string",
      "description": "Service ID (a UUID) from list_services"
    }
  },
  "required": [
    "service_id"
  ],
  "additionalProperties": false
}

README.md3 KBView on GitHub

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

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):

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. 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

Install

Tools (12)

check_connectiongenerate_endpointsget_accountget_invoiceget_live_trafficget_serviceget_traffic_usedget_usage_history

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.trueproxies.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.trueproxies.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

TrueProxies

com.trueproxies/mcp (Model Context Protocol) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

check_connection

generate_endpoints

get_account

get_invoice

get_live_traffic

get_service

get_traffic_used

get_usage_history

list_invoices

list_plans

list_services

list_trusted_ips

TrueProxies MCP server

Tools

API key

Connect

Privacy

Links

License

Install

Remote endpoint

Related servers