Sign up

Products

Use cases

LanguageEnglishRussian

Try for $1.99
Log in Sign up

Proxies your agent
connects itself

MCP server GonzoProxy for Claude Code, Cursor and VS Code. Sign in with your GonzoProxy account: your agent lists countries, checks its balance and gets a connection for your target country.The agent gets a connection from the dashboard or REST API, sets the country with a username code and reads the balance through the API. Each agent has an individual gigabyte limit.

  • Claude
  • Cursor
  • VS Code
  • ChatGPT
Try for $1.99 Add to Cursor API documentation
  • Account sign-in, no API key in the configConnection from the dashboard or REST API
  • Balance is checked before a connection is issuedRead the balance through the API
  • A separate gigabyte limit for each agent

Claude Code·~/price-monitor

> Give the price scraper a proxy from Germany and verify the exit country

gonzo_list_countries(product: "residential")read only

└ DE is on the list

gonzo_get_balance()read only

└ Residential: 24.6 GB

gonzo_generate_proxy(country: "DE")issues a connection

└ socks5h://LOGIN_c_de:PASS@connect.gonzoproxy.app:10000

Done: connection issued, exit country DE (ipinfo.io/country).

isError · balance_exhausted

Your residential pool balance is empty. No proxy was issued. Top up your balance in the dashboard.

The agent gets a clear error when requesting a connection, instead of guessing from script failures.

REST API·connection for your agent

 
API documentation
 
 
    
 
 
 
 
 
 
 
One command 
in your client
 
Add the server with one command and sign into your GonzoProxy account in the browser. A dashboard API key is needed only for CI and scripts.
 
 
 
  
 
 
 
Claude Code
 
Endpoint: https://mcp.gonzoproxy.app/mcp · Streamable HTTP
 
 
Where agents can discover us
llms.txt   /.well-known/mcp.json
 
 
Cursor and VS Code install the same configuration with a button. For CI, replace sign-in with a dashboard API key in the header x-api-key.
 
 Add to Cursor Add to VS Code Full MCP server description 
 
 
 
 
    
 
 
 
 
Connection for your agent 
from the dashboard or API
 
The agent needs a standard proxy connection. Set the country with a code in the username and read the balance through the API.
 
 
 
 
REST API
 
 
 
 
Create a key in the dashboard. Your agent uses it to get connections in the required country, while you track usage by subaccounts.
 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
 
     
  1.   
  2.   
  3.   
  4.   
  5.   
  6.   
    7.  
 
 
  
 $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
    •  
 
 
 
 
 
 
 
 
 
Give your agent a ready-to-use prompt
 
Paste the text into your agent’s chat. It will connect the server, check countries and balance, and get a connection itself.
 
 
 
 
 
prompt.md
 
 
 
 
 
 
 
 
 
Six tools, 
the connection is issued by one
 
Five of six tools are read only. Connection generation checks the balance first.
 
 
 
 
 GonzoProxy MCP server tools 
ToolWhat it doesSign inMode
 
gonzo_list_countriesCountries in the selected poolNo sign-in requiredRead only
gonzo_list_geoRegions in the selected countryNo sign-in requiredRead only
gonzo_list_ispsCarriers by countryNo sign-in requiredRead only
gonzo_get_balanceBalances across all three poolsSign-in requiredRead only
gonzo_generate_proxyReturns a proxy connectionSign-in requiredReturns a connection
gonzo_list_sub_accountsSub-accounts and their balancesSign-in requiredRead only
 
 
 
 
Reading reference data and balances is free. Gigabytes are charged only for requests made through the gateway using the issued connection.
 
Tool parameters and server responses on the MCP server page
 
 
 
 
 
 
Three tasks 
your agent handles itself
 
The agent chooses the country and session type for its task. Top up the balance when needed.
 
 
 
 
Claude Code
 
     
  1. > Refresh the RAG knowledge base with documentation pages from the United States
    gonzo_generate_proxy(country: "US", session: "rotating")
    └ new IP for every request
  2. > Check the pricing page as a shopper in Germany would see it
    gonzo_generate_proxy(country: "DE", session: "sticky", ttl: "30m")
    └ one IP for 30 minutes
  3. > Compare the assistant’s answers in the United States, Germany and United Kingdom
    gonzo_generate_proxy(country: "US" | "DE" | "GB")
    └ three connections, one account
    4.  
 
 
 
BalanceResidential
 
18.4 GB
 sample data 
Top-ups
 25 GB$137.50 · USDT 2 GB$13 · USDT 
Traffic never expires between runs
 
 
 
 
 
 
 
 
The agent knows what is allowed 
and how much is left
 
Each call returns a clear response: a list, a balance or an error.
 
 
 
 
MCP server response
 
 
gonzo_list_countries(product: "residential") no sign-in required
└ Residential pool countries: DE, FR, GB, NL, US…
 
gonzo_get_balance() no sign-in required
└ 401 · GonzoProxy sign-in required
 
gonzo_generate_proxy(country: "DE") balance 0
└ isError · balance_exhausted
Your residential pool balance is empty. No proxy was issued. Top up your balance in the dashboard.
 
 
 
 
What the agent can access
 
     
  • gonzo_list_countriesRead only
  • gonzo_list_geoRead only
  • gonzo_list_ispsRead only
  • gonzo_get_balanceRead only
  • gonzo_list_sub_accountsRead only
    •  
  • gonzo_generate_proxyReturns a connection
    •  
  • Changes and access revocation sub-accountsin the dashboard
    •  
 
 
 
Traffic passes through connect.gonzoproxy.app:10000 using the issued connection. MCP only issues connections and shows balances.
 
 
 
 
 
 
A separate limit for each agent 
in gigabytes
 
Create an agent’s sub-account with a gigabyte limit, then give it that sub-account: the agent can use only its allocated gigabytes. Your agent reads balances through gonzo_list_sub_accounts. You can check them in the dashboard or CLI.Balances are visible in the dashboard and through the API.
 
 
 
 
Sub-accountsDashboard
 
 
research-rag ActiveDisabled  
 
Residential · 5 GB limit
  0.7 of 5 GB remaining 
 
monitor-us ActiveDisabled  
 
Residential · 2 GB limit
  1.4 of 2 GB remaining 
 
contractor Close to the limitDisabled  
 
Residential · 10 GB limit
  0.8 of 10 GB remaining 
 
 
 
CLI gonzoFor people and CI
 
 
 
 
 
REST API·agent balances
 
 
 
 
 
 
 
 
 
 
 
Test your website with our proxies for free
 
Enter a website and country to see the exit IP, residential ISP and your website’s response through our proxy.
 
  
 
 
 
 
  Your website opens through our proxies 
 
200 OK · 1.2 s
 
 
shop.example.de · tested through a residential IP
 
 
Exit IP
91.64.•••.•••
 
Country and city
Germany, Berlin
 
ISP
Deutsche Telekom
 
IPQS fraud score
0 out of 100
 
Scamalytics
0 out of 100
 
Blocklists
0 out of 7
 
 
 
 
 
 
 
 
 
Frequently asked questions
 
 
Still have questions? Message us on Telegram for a clear answer.
 
Message us on Telegram 
 
 
Or ask AI about GonzoProxy:
 
 Ask ChatGPT Ask Claude 
 
 
 
 
 
 
Who tops up the balance?
 
Account owner in the dashboard, by card or cryptocrypto: USDT, BTC, ETH and 20+ other coins. The agent reads its balance with gonzo_get_balance. At zero, connection generation returns a clear balance_exhausted error.The agent reads its balance through the API.
 
 
What happens when the balance reaches zero?
 
gonzo_generate_proxy will not issue a connection. The agent receives a clear balance_exhausted error with a link to top up in the dashboard.The connection stops passing traffic until the balance is topped up. Your agent checks the balance through the API.
 
 
Which clients are supported?
 
Claude Code, Cursor, VS Code, Claude Desktop, claude.ai and ChatGPT. Add the server with a command or button and sign in with your GonzoProxy account. For CI, use a key from the dashboard.Any client that accesses the internet via HTTP proxies or SOCKS5: the agent gets a connection from the dashboard or REST API.
 
 
Do I need an API key to try it?
 
Just sign into your GonzoProxy account. Use a dashboard API key for CI and scripts without a browser.No API key is needed for a dashboard connection. Create an API key in the dashboard when the agent needs to fetch connections itself.
 
 
Where does the agent’s traffic go?
 
Through the gateway connect.gonzoproxy.app:10000 using the issued connection. MCP only issues connections and shows remaining traffic, so reading reference data and balances is free.
 
 
What should I do if the website returns 403?
 
Websites check more than the IP, including client headers and browser fingerprint. Ask your agent to change the country code or enable rotation, and configure the client as a regular browser.
 
 
 
 
 
 
 
 
 
Connect your agent 
to GonzoProxy
 
The MCP server is free. See how your target website responds through a residential IP in the selected country. Free, in about a minute.
 
  Message us on Telegram  
 
   
 
 
   
     
 
Test any domain 
with our proxies
 
    
  
No signup required. The test uses a real residential IP in your chosen country.