---
name: trueproxies
description: Route an AI agent's web requests through TrueProxies residential, static ISP or datacenter proxies, generate proxy connection lines, check a connection and read usage through the TrueProxies MCP server.
---

# TrueProxies proxies for AI agents

Use this skill when an agent must load pages from a residential IP in a chosen country or city (scraping, price and ad checks, local search results), or needs one static IP that stays the same for days or weeks (accounts, anti-detect browser profiles).

## Pick a product

- Unlimited Standard: unlimited traffic, priced by speed and time, from $4.08/hour at 10 Mbps. Country, city and ASN targeting. Best for steady crawls.
- Unlimited Pro: more IPs per country, from $10.99/day at 10 Mbps. Country targeting, city targeting in major cities.
- Residential IPv4 Lite, Standard and Premium: traffic packs billed per GB, traffic never expires. From $0.50 for 1 GB; Standard from $1.10 for 1 GB. Standard and Premium add region, city and ASN targeting.
- Static ISP: static IPv4 on 17 internet providers in 7 countries, one customer per IP, from $0.99/day per IP. One gateway port per IP. UDP over SOCKS5 on every provider.
- Datacenter IPv6: a private /48 in one city, from $3.99/day at 25 Mbps. Reaches only sites that have an IPv6 address.

Free trial: 1 hour of Unlimited Pro at 10 Mbps, unlimited traffic, no card: https://trueproxies.com/free-trial/

## Connect the MCP server

Create an API key in the TrueProxies dashboard under API. Give it services:read and billing:read for read-only use, and proxy:read only if the agent should see proxy connection lines.

Hosted server, nothing to install:

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

Tools: list_plans, get_account, list_services, get_service, get_traffic_used, get_live_traffic, get_usage_history, list_invoices, get_invoice, generate_endpoints, check_connection, list_trusted_ips. The server cannot buy, pay, change the proxy password or change the IP whitelist. check_connection sends one request through the service and uses a little traffic.

Source and other clients (Cursor, Docker): https://github.com/trueproxies-com/trueproxies-mcp

## Build proxy usernames

Targeting and sessions go on the proxy username after your username:

- USER-country-de: an exit in Germany.
- USER-country-de-city-berlin: an exit in Berlin, on products with city targeting.
- USER-country-us-session-agent01-lifetime-600: keep one exit for 600 seconds under the session ID agent01. Give every agent or task its own session ID, and reuse it for every request of that task.

Use generate_endpoints for the exact hosts, ports and protocols of a service (HTTP, HTTPS and SOCKS5).

## Rules

- Never print, log or paste the proxy password or the API key.
- Follow the acceptable use policy: https://trueproxies.com/acceptable-use/
- Check prices with list_plans or https://trueproxies.com/pricing/ before quoting them; this file can lag behind.

## More

- Documentation: https://docs.trueproxies.com/overview/
- Site summary for AI tools: https://trueproxies.com/llms.txt
- Static ISP: https://trueproxies.com/proxies/static-isp-proxies/
