1001Proxy - Proxy MCP Server for AI Agents

Use Claude, OpenAI Cursor, and any MCP-compatible AI agent to buy and manage proxies using natural language. No custom integrations needed - simply connect your client to the server and start chatting.

Let Claude, GPT, Cursor, and any MCP-compatible AI agent buy and manage proxies through natural language. No custom integrations required — just point your client at the server and start talking.

Works with:Claude DesktopClaude CodeCursorWindsurfAny MCP client

What MCP is and why it matters for proxy automation.

TheModel Context Protocol (MCP)is an open standard that lets AI agents communicate with external services through a structured tool-call interface. Instead of building brittle prompt-based integrations, MCP gives your AI agent typed, documented tools it can call with confidence.

The1001Proxy MCP Serverbridges your AI client directly to 1001Proxy's proxy infrastructure. The agent can check your balance, browse available proxy types and countries, price out an order, place it, and retrieve credentials — all through natural-language conversation, with no custom code on your end.

Add one JSON block to your AI client config and you are live.

Destructive tools like create_order require explicit user confirmation in the agent loop.

12 tools covering purchasing, management, credentials, and billing.

Log in to your 1001Proxy dashboard, navigate toSettings → API Keys, and create a new key. Copy it — you will need it in the next step.

Install globally with npm, or skip installation entirely and usenpx(the server will be fetched automatically).

Open your Claude Desktop config file (claude_desktop_config.json) and add the server block below. Replaceyour_api_key_herewith your actual key.

{ "mcpServers": { "1001proxy": { "command": "npx", "args": ["-y", "@1001proxy-mcp/server"], "env": { "PROXY_API_KEY": "your_api_key_here" } } } }

Restart Claude Desktop. The 1001Proxy tools will appear automatically in the tool list.

Multiple install options and environment variable reference.

Usenpx -yto run the latest version without installing anything globally. This is the recommended approach for most MCP client configs.

Config examples for every supported MCP client.

Config file location:~/Library/Application Support/Claude/claude_desktop_config.json(macOS) or%APPDATA%\Claude\claude_desktop_config.json(Windows).

{ "mcpServers": { "1001proxy": { "command": "npx", "args": ["-y", "@1001proxy-mcp/server"], "env": { "PROXY_API_KEY": "your_api_key_here" } } } }

Add the server from your terminal with theclaude mcp addcommand.

claude mcp add 1001proxy \ --command "npx -y @1001proxy-mcp/server" \ --env PROXY_API_KEY=your_api_key_here

Open Cursor Settings, go toFeatures → MCP Servers, and add the following JSON:

{ "mcpServers": { "1001proxy": { "command": "npx", "args": ["-y", "@1001proxy-mcp/server"], "env": { "PROXY_API_KEY": "your_api_key_here" } } } }

Any client that follows the MCP spec can connect via stdio. Launch the server process and pipe stdin/stdout:

PROXY_API_KEY=your_api_key_here npx -y @1001proxy-mcp/server

12 tools covering the full proxy lifecycle — from discovery to credential retrieval.

Retrieve account information and current balance.

List all available proxy types with current pricing.

Fetch countries, rental periods, and tariffs for a given proxy type.

Params: type: ipv4 | ipv6 | mobile | isp | resident

Preview the total cost of an order before committing. No balance deducted.

Params: type, countryId, periodId, quantity, protocol, tarifId

Place a new proxy order. Debits your balance immediately.

Params: type, countryId, periodId, quantity, protocol, tarifId, idempotency_key

List existing orders with optional filters.

Retrieve full details for a specific order.

Get the proxy host, port, and credentials for an order.

Download the proxy list as a plain-text or CSV file.

Extend an active order's duration. Charges your balance.

Retrieve your balance transaction history (deposits, charges, refunds).

List your crypto deposit wallet addresses.

How an AI agent handles real proxy tasks end-to-end.

Workflow 1 — "Buy 10 datacenter proxies in the US"

Buy me 10 datacenter proxies in the United States for 30 days.

Calling get_reference_data to find the US country ID and the 30-day period ID for IPv4 proxies.

get_reference_data({ type: "ipv4" }) → countryId: 1 (United States), periodId: 3 (30 days)

calculate_order({ type: "ipv4", countryId: 1, periodId: 3, quantity: 10, protocol: "http" }) → total: $3.00

10 US datacenter proxies (HTTP) for 30 days will cost $3.00. Your current balance is $45.20. Shall I proceed?

create_order({ type: "ipv4", countryId: 1, periodId: 3, quantity: 10, protocol: "http", idempotency_key: "ord_20260406_001" }) → order_id: "ord_abc123", status: "active"

Order placed. Fetching your proxy credentials now.

get_proxies({ order_id: "ord_abc123" }) → 10 proxies returned

Done! Here are your 10 US proxies (HTTP, 30 days, expires 2026-05-06): user_abc:pass_xyz@us1.1001proxy.io:10001 user_abc:pass_xyz@us1.1001proxy.io:10002... (8 more)

Workflow 2 — "Check my balance and list active orders"

What's my balance and do I have any active proxy orders?

Fetching account info and active orders in parallel.

get_account() → balance: $42.20 list_orders({ status: "active", per_page: 10 }) → 3 active orders returned

Your balance is $42.20. You have 3 active orders: • ord_abc123 — 10x IPv4 US (expires 2026-05-06) • ord_def456 — 5x IPv6 DE (expires 2026-04-20) • ord_ghi789 — 2x Mobile UK (expires 2026-04-15)

Workflow 3 — "Download proxy list for order ord_abc123"

Download my proxy list for order ord_abc123 as a text file.

Calling download_proxies with txt format.

download_proxies({ order_id: "ord_abc123", format: "txt" }) → plain-text proxy list returned

Here is your proxy list as plain text (host:port:user:pass format): us1.1001proxy.io:10001:user_abc:pass_xyz us1.1001proxy.io:10002:user_abc:pass_xyz... (8 more) You can paste this directly into your scraper or bot config.

API key not set — tools return an auth error

Make sure the PROXY_API_KEY environment variable is set in your MCP client config. In Claude Desktop, check that the "env" block in claude_desktop_config.json contains your key and restart the app. The server will refuse all requests if the variable is missing or blank.

# Verify the variable is set before running echo $PROXY_API_KEY # Or pass it inline for a quick test PROXY_API_KEY=sk_live_... npx -y @1001proxy-mcp/server

Confirm that Node.js 18+ is installed and available on your PATH. The npx command must be able to reach the npm registry to download the package on first run. Check your network or corporate proxy settings if you are behind a firewall.

# Check Node.js version (18+ required) node --version # Confirm npx works npx --version

The 1001Proxy API enforces per-minute rate limits. If your agent is calling tools in a tight loop, add a short pause between calls or reduce the frequency. The MCP server will surface the 429 status in the tool result so the agent can back off automatically.

# The server returns structured error results: { "error": "rate_limited", "message": "Too many requests. Retry after 10s.", "retryAfter": 10 }

Insufficient balance (402 on create_order)

Your account balance is too low for the requested order. Use get_account to check your current balance, then deposit funds via get_deposit_addresses and send crypto to the returned wallet address.

Create your account, fund your balance, and have an AI agent buying proxies in under five minutes.

Enable AI agents to get structured data from unstructured web with AgentQL.

Web scraping, crawling, and change detection with AI

Automate browser interactions in the cloud (e.g. web navigation, data extraction, form filling, and more)

Easy web data access. Simplified retrieval of information from websites and online sources.

Adds powerful web scraping and search capabilities to LLM clients like Cursor and Claude.

Hyperbrowser is the next-generation platform empowering AI agents and enabling effortless, scalable browser automation.