resi.gg
MCP Server

Proxies for Your AI Agent

Connect Claude, Cursor or any MCP client to Resi.GG. Your agent can check prices, buy bandwidth, generate and test proxies, all within a spending limit you set.

Create API Key

Paste it into Claude, Cursor or any agent and it connects itself. See the prompt

“What's my balance?”“How much would 10 GB of residential cost?”“Buy 5 GB of residential proxies”“Buy 10 US ISP proxies for 30 days”“Give me 50 sticky US proxies with 30 minute sessions”“Test these proxies and drop the dead ones”“How much traffic do I have left?”
Capabilities

What Your Agent Can Do

The same products, prices and settings as your dashboard, as tools your agent can call.

Check balance & prices

Your balance, your key's daily limit and this account's prices for every product.

get_accountlist_products

Buy proxies

Get a quote, confirm the price with you, then pay from your balance. Never above your daily limit.

quotepurchase

Generate proxies

Up to 1,000 per call. Pick protocol, rotating or sticky sessions, country, state, city and format.

generate_proxieslist_locations

Track usage

List your plans and see the remaining traffic or time of each product.

list_my_plansget_usage

Fetch ISP, static & LTE proxies

List your active ISP, static datacenter and LTE orders and their proxies.

list_my_proxiesget_order_proxies

Test proxies

Check up to 20 proxies at once: alive, latency, exit IP, country and ISP.

test_proxies
Getting Started

Up and Running in 3 Steps

01

Create an API key

In the dashboard, open Profile → API keys (MCP) and create a key. It is shown once, so copy it right away. Using Claude.ai, Claude Desktop or another app with sign-in? Skip this: add the server as a connector and approve it in your dashboard.

02

Set a daily limit

Each key has a daily spending limit in USD. It starts at $0, which means the key can read and generate proxies but can't buy anything. Raise it only if you want your agent to make purchases.

03

Connect your agent

Add the Resi.GG server to your AI client with the snippet below, then just ask. Your agent picks the right tools on its own.

Setup

Connect Your Client

Give your agent the setup prompt, or add the server by hand. Replace the key placeholder with the key from your dashboard.

Where:Paste into Claude, Cursor or any agent chat
Connect to the Resi.GG MCP server so you can manage my proxies.

- URL: https://resi.gg/api/mcp/
- Transport: Streamable HTTP
- Header: Authorization: Bearer <MY_API_KEY>
- Server name: resi

Add it to your MCP config. In Claude Code, run:
claude mcp add --transport http resi https://resi.gg/api/mcp/ --header "Authorization: Bearer <MY_API_KEY>"

The server also supports OAuth: if your client can sign in to remote MCP servers, connect without a key and I'll approve it in my dashboard. Otherwise, if I haven't given you my API key, ask me for it. I can create one at https://dashboard.resi.gg/profile under "API keys (MCP)".

Once connected, call get_account to confirm it works. Before any purchase, show me the quote and wait for my OK.
Docs: https://resi.gg/mcp
Safeguards

You Stay in Control

Your agent works with your balance, but only on your terms.

Daily spending limit

Each key can only spend up to its limit in any rolling 24 hours. New keys start at $0.

Quote before you pay

Quotes charge nothing and expire after 10 minutes. Your agent confirms the price with you before buying.

No surprise price changes

A purchase re-checks the price, your balance and your limit, and fails if the price went up.

Your account stays yours

Keys can't change your profile, password or payment settings. Revoke a key at any time to cut access.

FAQ

Common Questions

What is MCP?

The Model Context Protocol is an open standard that lets AI assistants like Claude, Cursor and VS Code Copilot use external tools. The Resi.GG MCP server gives them tools to manage your proxies.

Can my agent spend my whole balance?

No. A key can only spend up to its daily limit in any rolling 24 hours, and new keys start at $0. You can change the limit or revoke the key from your dashboard at any time.

How does my agent add balance?

It can create a checkout link (crypto or card) that you open and pay yourself. The agent never handles your payment details.

Which products can my agent buy?

Residential, Budget Residential, Unlimited Residential, ISP (Static Residential), Rotating Mobile and Rotating Datacenter. Static datacenter and LTE proxies bought in the dashboard can still be listed and fetched by your agent.

Do I need an API key?

Only for clients that use a header, like Claude Code, Cursor and VS Code. Claude.ai, Claude Desktop and other apps that support sign-in open a Resi.GG page where you approve the connection and set its daily limit.

How many keys can I have?

Up to 10 per account, each with its own daily limit. Use one key per agent or machine so you can revoke them separately.

Does it cost extra?

No. The MCP server is free. You pay the same prices as in the dashboard.

Give Your Agent Proxies

Create a free account, add an API key and connect your agent in a couple of minutes.