Give your agent
a real IP.
One config line adds AEGIS to Claude, Cursor, or any MCP-compatible tool. Your agent gets residential IPs in 190+ countries — billed per request, no session management.
Three steps.
Get an API key
Connect your Solana wallet at /agent, top up USDC, and generate your aegis_xxx key.
Get key →Add to config
Paste the JSON snippet below into your Claude Desktop, Cursor, or Continue config file.
Use it
Call aegis_fetch, aegis_get, or aegis_post in your prompts. AEGIS handles the exit routing.
View tools →claude_desktop_config.json
Add the mcpServers block to your config file. Replace aegis_your_key_here with your real key from the agent page.
Claude Desktop config location:
macOS: ~/Library/Application Support/Claude/
Windows: %APPDATA%\Claude\
{
"mcpServers": {
"aegis": {
"command": "npx",
"args": ["@aegisprivacy/mcp"],
"env": {
"AEGIS_API_KEY": "aegis_your_key_here"
}
}
}
}Available in every session.
aegis_fetch(url, options?)Fetch any URL through a residential exit node. Supports GET, POST, custom headers, and body.
aegis_get(url, country?)Convenience GET. Returns response body as text. Country defaults to US.
aegis_post(url, body, country?)POST with a JSON body through a residential node. Returns response text.
aegis_balance()Check your current USDC balance. Returns a number. Use to guard against running out mid-task.
Use it like any other tool.
Tell Claude to use aegis_fetch when you need a residential IP. The model handles tool selection — you just describe the task.
// Your agent, unmodified — AEGIS MCP handles routing
const price = await aegis_get(
"https://store.example.com/api/product/123",
"JP" // exit from Japan
)
const search = await aegis_fetch(
"https://api.example.com/search",
{
method: "POST",
country: "DE",
ip_class: "residential",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ q: "test" })
}
)Ready to start?
Generate an API key, add 5 lines to your config, and your agent has residential IPs in 190+ countries.
Get your API key