Repository avatar
AI Tools
v1.0.0
active

mcp

com.aeonproxy/mcp

Residential and mobile proxies for AI agents: locations, prices, proxy lines, pages by country

Documentation

AeonProxy MCP server

Residential and mobile proxies for AI agents. Connect Claude, ChatGPT, Cursor, VS Code, Claude Code, Windsurf or any other Model Context Protocol client to AeonProxy and the assistant can look up proxy locations and prices, make ready proxy lines from your account and load web pages through residential or mobile IPs in the country you choose.

https://aeonproxy.com/mcp

Remote server, Streamable HTTP. Nothing to install. Public tools work without an account; account tools ask you to sign in (OAuth) or take your API key.

Full guide: https://aeonproxy.com/docs/setup/mcp-server

Tools

ToolWhat it doesSign-in
list_proxy_locationsCountries, regions, cities, ISPs and mobile carriers, each with its login keyNo
get_proxy_pricesPrice per GB by volume, ISP and datacenter prices per IP, unlimited plans, the free trialNo
quote_proxy_priceThe exact price of an amount of traffic or a number of IPsNo
get_ip_stockCountries where ISP or datacenter IPs can be ordered now, with the number in stockNo
check_site_accessWhether the gateway blocks a site or port by defaultNo
get_service_statusLive state of the gateway and networksNo
test_proxiesChecks proxy lines from any provider: answers or not, latency, exit IP and countryNo
search_aeonproxy_docsFinds the setup guide or docs section for a tool, error or featureNo
get_accountBalance, traffic left, sub-users, active orders and your proxy loginsYes
generate_proxy_linesUp to 100 ready lines with country, region, city, ISP or carrier targeting, rotating or sticky up to 6 hoursYes
fetch_via_proxyLoads a page through your residential or mobile proxy in the chosen country and returns Markdown, text or HTMLYes
get_traffic_usageYour traffic per day over the last 1–30 daysYes
list_orders, get_orderYour orders, and every IP of an ISP or datacenter order with its loginYes

No tool buys anything, tops up or changes your account. fetch_via_proxy uses your paid traffic and reports the KB each page used.

Connect

Claude (web and desktop): Customize → Connectors → Add custom connector → https://aeonproxy.com/mcp. When a tool needs your account, Claude shows Connect: sign in to AeonProxy and choose Allow.

ChatGPT: turn on developer mode (Settings → Apps → Advanced settings), create an app with https://aeonproxy.com/mcp and OAuth.

Claude Code

claude mcp add --transport http aeonproxy https://aeonproxy.com/mcp

Then /mcp → AeonProxy → sign in in the browser.

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "aeonproxy": { "url": "https://aeonproxy.com/mcp" }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "aeonproxy": { "type": "http", "url": "https://aeonproxy.com/mcp" }
  }
}

Windsurf (mcp_config.json)

{
  "mcpServers": {
    "aeonproxy": { "serverUrl": "https://aeonproxy.com/mcp" }
  }
}

Clients that only start local servers, through mcp-remote (Node.js):

{
  "mcpServers": {
    "aeonproxy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://aeonproxy.com/mcp"]
    }
  }
}

Sign-in or API key

  • Sign-in (OAuth 2.1 with PKCE). The app opens a page on aeonproxy.com that names the app and what it may do. After Allow the connection appears in Settings → Security as "AeonProxy MCP · " and can be ended there. The token works on the MCP server only.
  • API key. For scripts and clients that let you set headers: copy the key from Settings → API and send Authorization: Bearer ap_live_… (or X-API-Key). It is the key of the AeonProxy REST API. Keys in the URL are not accepted.
{
  "mcpServers": {
    "aeonproxy": {
      "url": "https://aeonproxy.com/mcp",
      "headers": { "Authorization": "Bearer ap_live_YOUR_KEY" }
    }
  }
}

Limits

  • 120 requests a minute per account (shared with the REST API key), 300 a minute per address without sign-in.
  • fetch_via_proxy: one GET request per call, up to 5 redirects, no JavaScript, 5 MB and 30 seconds per page, 20 pages a minute and 3 at a time per account.
  • generate_proxy_lines: up to 100 lines per call. test_proxies: 10 lines per call without sign-in, 50 with it.

Privacy

The server does not log the addresses of the pages you load, and it stores nothing about your conversations. Account data is read only for the tools you call. AeonProxy's Privacy Policy and Terms of Service apply; use of the proxies is subject to the Acceptable Use Policy.

Support

Chat on aeonproxy.com or aeonproxy.com/contact.

Registry

Listed in the official MCP Registry as com.aeonproxy/mcp (server.json).

No installation packages available.

Remote