TrueProxies
Plans, services, usage, invoices, endpoints and connection checks for your TrueProxies account
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mcp": {
"url": "https://mcp.trueproxies.com/mcp"
}
}
}Remote endpoints
https://mcp.trueproxies.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (12)
🟢check_connection(service_id, protocol, country, city, region, ...)
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.
Input 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(service_id, protocol, format, count, country, ...)
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.
Input 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.
Input Schema
{
"type": "object",
"additionalProperties": false
}🟢get_invoice(invoice_id)
Returns one invoice: status, amounts in cents, payment attempts and its service. Does not start a payment.
Input Schema
{
"type": "object",
"properties": {
"invoice_id": {
"type": "string",
"description": "Invoice ID (a UUID) from list_invoices"
}
},
"required": [
"invoice_id"
],
"additionalProperties": false
}🟢get_live_traffic(service_id)
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.
Input Schema
{
"type": "object",
"properties": {
"service_id": {
"type": "string",
"description": "Service ID (a UUID) from list_services"
}
},
"required": [
"service_id"
],
"additionalProperties": false
}🟢get_service(service_id)
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.
Input Schema
{
"type": "object",
"properties": {
"service_id": {
"type": "string",
"description": "Service ID (a UUID) from list_services"
}
},
"required": [
"service_id"
],
"additionalProperties": false
}🟢get_traffic_used(service_id)
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.
Input Schema
{
"type": "object",
"properties": {
"service_id": {
"type": "string",
"description": "Service ID (a UUID) from list_services"
}
},
"required": [
"service_id"
],
"additionalProperties": false
}🟢get_usage_history(service_id, range)
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.
Input 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(service_id, status, kind, cursor, limit)
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.
Input 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(product, term)
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.
Input 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(view, cursor, limit)
Lists the services on the account with status, product, plan, expiry and connection hosts. Paginated: pass next_cursor from the previous response as cursor.
Input 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(service_id)
Lists the trusted IPs of a service: addresses allowed to connect without the proxy password.
Input Schema
{
"type": "object",
"properties": {
"service_id": {
"type": "string",
"description": "Service ID (a UUID) from list_services"
}
},
"required": [
"service_id"
],
"additionalProperties": false
}Community
Evidence