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 keysget_proxy_prices: prices per GB and per IP, unlimited plans, the free trialquote_proxy_price: the exact price of a purchaseget_ip_stock: ISP and datacenter IPs in stock, by countrycheck_site_access: whether the gateway blocks a site or port by defaultget_service_status: the live state shown on the status pagetest_proxies: checks proxy lines from any provider for latency, exit IP and countrysearch_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 loginsgenerate_proxy_lines: up to 100 ready lines, rotating or sticky up to 6 hoursfetch_via_proxy: loads a page through your proxy in the chosen countryget_traffic_usage: traffic per day, last 1–30 dayslist_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
- In Claude on the web or the desktop app, open Customize → Connectors and choose Add custom connector.
- Name it
AeonProxy, pastehttps://aeonproxy.com/mcpas the URL and add it. - Ask, for example: "Which cities can I target with mobile proxies in Japan?" Public tools answer at once.
- When a tool needs your account, Claude shows Connect: sign in to AeonProxy and choose Allow. Claude then repeats the call.
ChatGPT
- Turn on developer mode: Settings → Apps → Advanced settings. Workspace plans need an admin to allow it first.
- Create an app with
https://aeonproxy.com/mcpas the server URL and OAuth as the authentication. - 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/mcpRun /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_idkeeps 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.
- 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 see | What to check |
|---|---|
| The app keeps asking to connect | The 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 left | Buy traffic on the Residential or Mobile page. |
| The gateway refused the targeting | Use a region or city from list_proxy_locations. |
| A site answers 403 or a challenge | The 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.