AeonProxy MCP server

One address gives your AI assistant AeonProxy tools: it looks up locations and prices, makes proxy lines from your account and loads pages through residential or mobile IPs in the country you pick.

Server URL
https://aeonproxy.com/mcp, Streamable HTTP
Sign-in
Your AeonProxy account through the app's Connect button, or your API key as a Bearer token
Without sign-in
Locations, prices, IP stock, site blocks, service status, proxy tests and docs search
Works with
Claude, ChatGPT, Cursor, VS Code, Claude Code, Windsurf and other MCP clients

What the assistant can do

The Model Context Protocol (MCP) is how AI apps call outside tools. With our server added, the assistant answers proxy questions with live data, and with your sign-in it works on your own account.

Without sign-in:

  • list_proxy_locations: countries, regions, cities, ISPs and carriers with their login keys
  • get_proxy_prices: prices per GB and per IP, unlimited plans, the free trial
  • quote_proxy_price: the exact price of a purchase
  • get_ip_stock: ISP and datacenter IPs in stock, by country
  • check_site_access: whether the gateway blocks a site or port by default
  • get_service_status: the live state shown on the status page
  • test_proxies: checks proxy lines from any provider for latency, exit IP and country
  • search_aeonproxy_docs: finds the right guide or docs section

With your sign-in or API key:

  • get_account: balance, traffic left, orders and your proxy logins
  • generate_proxy_lines: up to 100 ready lines, rotating or sticky up to 6 hours
  • fetch_via_proxy: loads a page through your proxy in the chosen country
  • get_traffic_usage: traffic per day, last 1–30 days
  • list_orders, get_order: orders, and the IPs and logins of ISP and datacenter orders

Nothing in the server buys, tops up or changes your account: purchases stay in the dashboard.

Claude

  1. In Claude on the web or the desktop app, open Customize → Connectors and choose Add custom connector.
  2. Name it AeonProxy, paste https://aeonproxy.com/mcp as the URL and add it.
  3. Ask, for example: "Which cities can I target with mobile proxies in Japan?" Public tools answer at once.
  4. When a tool needs your account, Claude shows Connect: sign in to AeonProxy and choose Allow. Claude then repeats the call.

ChatGPT

  1. Turn on developer mode: Settings → Apps → Advanced settings. Workspace plans need an admin to allow it first.
  2. Create an app with https://aeonproxy.com/mcp as the server URL and OAuth as the authentication.
  3. ChatGPT opens our sign-in page: sign in, choose Allow, then pick the app in a chat.

Claude Code

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

Run /mcp in Claude Code and choose AeonProxy to sign in in your browser. To use the API key instead, add --header "Authorization: Bearer ap_live_YOUR_KEY" to the command.

Cursor, VS Code and Windsurf

Cursor reads ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

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

VS Code takes .vscode/mcp.json with { "servers": { "aeonproxy": { "type": "http", "url": "https://aeonproxy.com/mcp" } } }, and Windsurf mcp_config.json with serverUrl in place of url. Each offers to sign in the first time a tool needs your account.

Sign-in or API key

Sign-in is the easiest: the app opens a page on our site that names the app and what it may do. After Allow the connection shows in Settings → Security as "AeonProxy MCP · Claude" (or the app's name); End session there disconnects it. The app gets a token for the MCP server only, never your password or API key.

An API key suits scripts and apps that let you set headers: copy it from Settings → API and send Authorization: Bearer ap_live_… or X-API-Key. It is the REST API key and shares its limit. Keys in the URL are ignored.

{
  "mcpServers": {
    "aeonproxy": {
      "url": "https://aeonproxy.com/mcp",
      "headers": {
        "Authorization": "Bearer ap_live_YOUR_KEY"
      }
    }
  }
}

Apps that only start local servers can use the mcp-remote bridge (Node.js). Without the header it signs you in through the browser:

{
  "mcpServers": {
    "aeonproxy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://aeonproxy.com/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer ap_live_YOUR_KEY" }
    }
  }
}

Pages through your proxy

fetch_via_proxy loads a page the way a visitor in another country sees it: local prices, search results, ads or stock. Pick residential or mobile, a country and, from list_proxy_locations, a region or city. The answer has the status, the final URL, the page as Markdown, text or HTML, and the KB of traffic used.

  • One GET request, up to five redirects, no JavaScript, no images or files.
  • Up to 5 MB on the wire and 30 seconds per page; longer text is cut to the length asked for.
  • The same session_id keeps one exit IP for 10 minutes across calls.
  • The gateway's default blocks apply as for any connection.

Lines the tools make

generate_proxy_lines writes lines for the gateway below with your login and password, ready for a scraper, a browser profile or a config file. Targeting values come from list_proxy_locations, as in location targeting.

Connection details
Host
gate.aeonproxy.com
Port (HTTP / HTTPS)
7000
Port (SOCKS5)
7001
Login
your proxy login, with targeting keys if you need them: LOGIN-cc-us-sid-abc123
Password
your proxy password

Copy the login and password from the Residential or Mobile page of the dashboard; the generator there also writes ready lines. Key syntax: targeting and sessions.

Limits

  • 120 requests a minute per account, shared with the REST API key; 300 a minute per address without sign-in.
  • 20 page loads a minute and 3 at a time per account.
  • Up to 100 proxy lines per call; proxy tests take 10 lines per call without sign-in and 50 with it.

If it does not work

What you seeWhat to check
The app keeps asking to connectThe connection was ended in Settings → Security, the password changed, or it sat unused for 14 days. Connect again.
"This API key is not valid"The key was rotated: copy the current one from Settings → API.
No traffic leftBuy traffic on the Residential or Mobile page.
The gateway refused the targetingUse a region or city from list_proxy_locations.
A site answers 403 or a challengeThe site refuses that IP: try again without session_id, or switch to mobile.

Questions

No. Reading data and making lines are free; page loads use your traffic like any proxy request.

No. No tool buys, tops up or changes settings.

No. Like the gateway, it does not log the addresses of pages you load.

Proxy questions? Ask support in the live chat.