18Proxy 18Proxy
Log in Sign up
Docs · MCP

MCP for AI Agents

Plug your AI agent into 18Proxy via Model Context Protocol: the agent buys & manages proxies and pulls web data — fetch, search, scrape — through the proxy you own, bypasses Cloudflare, and never uses the server's IP.

What is MCP Quick start Configure your agent Tools Guarantees & limits Frequently asked questions
Referrals

What is MCP

01

MCP is the standard that lets an AI agent discover and call external tools. You plug the MCP server in once; the agent learns which tools exist and decides when to use them — no integration code. All the business logic (pricing, wallet, provisioning) stays in the system; MCP is just the bridge.

3 steps

Quick start

02
1

Create API key

Go to Dashboard → API keys and create a key psk_…. The key is shown once — save it now.

2

Plug into your agent

Add the MCP config below to Claude Desktop / n8n / your SDK, and paste in the API key.

3

Put the agent to work

For example: “buy the VN Rotating Monthly plan”, “fetch this page via a Vietnam proxy”, “search … then extract the titles & links”.

Connections

Configure your agent

03
Hosted (HTTP) — recommended

A shared server; each request carries the API key in the header X-API-Key.

{
  "mcpServers": {
    "18proxy": {
      "url": "https://mcp.example.com",
      "headers": {
        "X-API-Key": "psk_•••"
      }
    }
  }
}
Local (stdio) — Claude Desktop

Run the server locally; the agent spawns the process.

{
  "mcpServers": {
    "18proxy": {
      "command": "python",
      "args": ["-m", "app.server"],
      "cwd": "/path/to/mcp-server",
      "env": {
        "PROXYSELL_API_KEY": "psk_•••"
      }
    }
  }
}
Reference

Tools

04
Group ABuy & manage proxies
ToolsWhat it does
list_plans · get_planBrowse the plan catalogue
estimate_costQuote an à-la-carte config (call before buying)
purchase_plan · build_custom_proxyBuy a plan / à-la-carte — debits the wallet, needs confirm=true
list_credentials · get_credentialList / detail of proxies (ip:port:user:pass)
rotate_ip · get_current_ipRotate IP / show the current exit IP
get_usage · get_balanceBandwidth used / wallet balance
topup_balanceCreate a top-up — returns a link, never charges
Group BWeb data — through your proxy
ToolsWhat it does
fetchFetch a URL → markdown / text / html; bypasses Cloudflare
searchWeb search → a list of {title, url, snippet}
scrapeExtract by CSS selector → structured data
fetch_manyFetch several URLs at once (reuses the unblock session)
solve_captchaSolve a page's captcha → token (with the form field name to attach it to)
submit_formSubmit (POST) a form — auto-solves & injects the captcha token, through your proxy

Every Group B tool egresses through the proxy you own; bandwidth is metered by the proxy as usual (no hidden fees). With no active proxy, the tool errors and skips.

Safety

Guarantees & limits

05
🛡️
Always your proxy

Never the server's IP. No proxy purchased → it errors, no data is fetched.

💳
Spending safety

Every spend needs confirm; there's a daily limit. Top-ups return a link, never auto-charge.

🔐
Revocable keys

Keys are stored hashed, shown once; revoke any of them anytime in the dashboard.

🚫
No logs

Only total bandwidth is measured for quotas — no access logs.

FAQ

Frequently asked questions

06
Do I need to buy a proxy before using fetch/search/scrape?
Yes. Group B tools egress through the proxy you own — with no active proxy, the tool errors. Buy one quickly with purchase_plan or on the store page.
Can the agent spend money unintentionally?
No. Every purchase needs confirm=true and respects the daily spend limit; top-ups only return a payment link.
Does fetch use the server's IP to go out?
Never. Without a valid proxy, the tool refuses rather than leaking the server's IP.
How does the Cloudflare bypass work?
When a page is blocked, the system solves it with FlareSolverr — still through your proxy — then returns the real page. Cookies are cached, so most requests don't re-solve.
What happens when I revoke an API key?
Any app using that key loses access immediately. Other keys are unaffected.
Ready to plug in your agent?