Manage proxies
from an AI agent
API and integrations
GonzoProxy

The GonzoProxy MCP server gives your agent a proxy connection in your target country and shows the balance and sub-accounts. This is not a scraper: the server issues connections and traffic passes through the gateway. Proxy connections in your target country and sub-accounts with a dashboard API key: REST API for your scripts, CI and AI agents.

  • Claude
  • Cursor
  • VS Code
  • ChatGPT
Endpoint https://mcp.gonzoproxy.app/mcp
Terminal
 

Uses an API key from the dashboard

Agent

Get me a residential proxy from Germany with one sticky session

gonzo_generate_proxy · country: DE · session: sticky

socks5h://gz_7kd2_c_de_s_a91f:••••@connect.gonzoproxy.app:10000

REST API · proxy connection
 

Connection string

connect.gonzoproxy.app:10000:gz_7kd2_c_de_s_a91f:••••

Exit: Germany · one IP for up to 72 hours

Six tools,
the connection is issued by one

https://mcp.gonzoproxy.app/mcp
GonzoProxy MCP server tools
ToolWhat it doesAPI keyAccess
gonzo_list_countries Countries in the selected pool No API key Read only
gonzo_list_geo Regions in the selected country No API key Read only
gonzo_list_isps Carriers by country No API key Read only
gonzo_get_balance Balances across all three pools API key required Read only
gonzo_generate_proxy Returns a proxy connection API key required Returns a connection
gonzo_list_sub_accounts Sub-accounts and their balances API key required Read only

Disable client telemetry with the environment variable GONZO_TELEMETRY=off.

This is not a scraper

 

MCP issues proxy connections. The agent fetches pages itself through the gateway using its own client.

Reading is free

No API key

Reading reference data and balances is free. Gigabytes are charged only for requests made through the gateway using the issued connection.

Balance before generation

balance_exhausted

Connection generation checks the balance first. At zero, the agent gets a clear error with a top-up link.

Connections and sub-accounts
with a dashboard API key

One header x-api-key for all requests. API requests are free; traffic is charged only through the gateway.

https://api.gonzoproxy.app/functions/v1

  • POST/proxy-api/generateProxy connection in your target country
  • POST/list-sub-accountsSub-accounts and their limits

REST API documentation

Proxy pricing.
Traffic never expires

Larger packages mean a lower price per GB: from $6.50 down to $0.70/GB.

Price per GB

$5.50/GB$6.50/GB

$220 for 40 GB$260 save 15% with this volume

Buy 40 GB

Enter any volume from 2 GB or move the slider

Try 300 MB for $1.99

Test residential proxies on your own workflow before buying a package.

  • 300 MB of residential traffic
  • The same pool and features as regular packages
  • One payment, no subscription
Try for $1.99

Custom pricing from 1 TB

Get a custom price per GB in your dashboard. Company invoicing is available.

Telegram

Included in your price

No subscription. Your traffic never expires at the end of the month and stays available until you use it.

  • City and ISP at no extra cost
  • 20M+ real IP addresses
  • Keep one IP for up to 72 hours or rotate IPs
  • Unlimited connections
  • Authentication by IP or username and password
  • HTTP and SOCKS5 on one port
  • Sub-accounts for your team
  • No KYC: access in 30 seconds

Payment:

  • By card
  • USDT
  • BTC
  • ETH
  • and 20+ other coins

Frequently asked questions

Still have questions? Message us on Telegram for a clear answer.

Or ask AI about GonzoProxy:

Do I need an API key to try it?

Country, region and carrier reference data can be read without an API key. Balance checks and connection generation use an API key from the dashboard.

What happens when the balance reaches zero?

gonzo_generate_proxy will not issue a connection. The agent receives a clear error balance_exhausted with a link to top up in the dashboard.

Which clients can connect?

Claude Code, Cursor and VS Code connect via API key with one command. Claude Desktop, claude.ai and ChatGPT connect through OAuth. A CLI is available for scripts and CI.

Connect your agent
with one command

Read reference data without an API key. See how your target website responds through a residential IP in the selected country. Free, in about a minute.

MCP documentation

Let’s test
your website

through our IPs

See whether your website opens through a residential IP in your chosen country. Free, in about a minute.

Create an account

Test any domain
with our proxies

No signup required. The test uses a real residential IP in your chosen country.