NEWModel Context Protocol

MCP Server for AI Agents

Real 4G/5G Mobile Proxies for Autonomous AI

The definitive proxy infrastructure for AI agents. 89 MCP tools for natural language proxy control with your account + API key (the main path), plus optional x402 instant USDC payments for account-less autonomous agents. Real mobile + residential IPs from 100+ countries and growing, with a 92% success rate on major platforms.

89 MCP Tools
Real 4G/5G Mobile IPs
x402 Instant USDC
100+ Countries
@proxies-sx/mcp-serverNOW AVAILABLE
MIT License
npx @proxies-sx/mcp-server
Or install globally: npm install -g @proxies-sx/mcp-server

Are You an Agent or Human?

Choose your interface for the best experience

🤖

AI Agent Detected

Visit this page to understand how to use the MCP server:

MCP Server Integration Guide
agents.proxies.sx/mcp/

💡 Pro Tip: This page is optimized for AI agents. Visit it to understand the complete MCP integration and start managing proxies through natural language.

What is MCP?

Model Context Protocol (MCP) is an open standard that allows AI assistants to securely interact with external tools and services. Instead of copying and pasting data, you simply tell the AI what you want to do - it handles the rest.

Natural Language

"Create a proxy in Poland" - no code or API calls needed. Just describe what you want.

Secure

API key stays local on your machine, never shared with the AI model. Full control over permissions.

Instant

Execute complex workflows in seconds through conversation. No dashboard switching needed.

Real-World Use Cases

See how teams are using MCP to streamline their proxy operations

🤖

AI Agents & Automation

Build autonomous agents that manage their own proxy infrastructure

  • Agent creates proxies when needed, deletes when done
  • Auto-rotate IPs after each task completion
  • Monitor proxy health and replace failing ones
💻

Development Workflows

Integrate proxy management into your coding workflow

  • Ask Cursor to create a German proxy for testing
  • Debug network issues with ping and speed tests
  • Generate connection strings for your apps
🕷️

Web Scraping

Dynamic proxy management for large-scale data collection

  • Rotate IP when rate-limited
  • Switch countries for geo-specific content
  • Monitor traffic usage to stay within budget
📱

Social Media Management

Manage multiple accounts with authentic mobile IPs

  • Create unique proxy for each account
  • Rotate IPs to avoid detection
  • Match OS fingerprint to account device type
📊

Market Research

Access geo-locked content and localized data

  • Create proxies in specific cities/carriers
  • Compare content across regions
  • Test ads from mobile perspectives

Crypto-Native Teams

Top up and manage everything with cryptocurrency

  • Pay with BTC, ETH, USDT, or 50+ coins
  • Check payment status through AI
  • Manage balance without leaving terminal

Why AI + Mobile Proxies?

Traditional proxy management requires switching between dashboards, remembering API endpoints, and writing integration code. With MCP, your AI assistant becomes a proxy operations expert.

Without MCP

  • Open dashboard, navigate to ports, click create...
  • Copy connection string, paste into config file...
  • Check documentation for API endpoint format...
  • Write code to handle rotation and monitoring...

With MCP

  • "Create a proxy in Poland"
  • "Show me the curl command for my main proxy"
  • "Rotate the IP and tell me the new address"
  • "Set up auto-rotation every 30 minutes"
x402 Protocol

Instant Proxy Access for Autonomous Agents

x402 uses HTTP 402 Payment Required to enable permissionless proxy access. AI agents pay with USDC on Base or Solana and receive credentials instantly - zero registration required.

How x402 Works

1
Agent Requests Proxy
GET /v1/x402/proxy?country=US&duration=3600
2
Server Returns 402
Payment requirements in X-PAYMENT-REQUIRED header
3
Agent Signs USDC Payment
Using wallet on Base or Solana network
4
Credentials Returned
HTTP + SOCKS5 proxy ready to use

🤖Perfect for AI Agents

  • Zero Registration
    No account signup, no API keys needed
  • Fully Autonomous
    Agents manage their own proxy infrastructure
  • Instant Access
    From payment to proxy in one HTTP request
  • Flexible Pricing
    Pay per GB - $4/GB, 0.1 GB ($0.40) minimum, duration free
Python with x402 SDKFull Documentation →
from x402 import X402Client

# Initialize x402 client with your wallet
client = X402Client(private_key="0x...", network="base")

# Request a proxy - handles 402 flow automatically
response = client.get(
    "https://api.proxies.sx/v1/x402/proxy",
    params={"country": "US", "duration": 3600, "traffic": 1}
)

proxy = response.json()
print(f"HTTP: {proxy['proxy']['http']}")  # Ready to use!

Building a Fully Autonomous Agent?

MCP tools plus x402 payments mean your agent can discover, pay for, and manage its own infrastructure with zero human input - all running on 500+ physical 4G/5G modems we own and operate. Start with our full guide to proxies your AI agent can buy itself via x402 + MCP.

Autonomous Proxy Access for AI Agents

Get Started in 5 Minutes

Create your API key and configure your AI tool in just a few steps

1

Get Your API Key

Go to the Documentation page and create a key with these scopes:

ports:readports:writeports:rotatebilling:readbilling:writeaccount:readtraffic:read
Create API Key
2

Configure Your AI Tool

.mcp.json
{
  "mcpServers": {
    "proxies-sx": {
      "command": "npx",
      "args": ["-y", "@proxies-sx/mcp-server"],
      "env": {
        "PROXIES_API_KEY": "psx_your_api_key_here"
      }
    }
  }
}

Tip: Place in ~/.mcp.json for global access, or in your project folder for project-specific configuration.

3

Verify Installation

After configuration, test by asking your AI assistant:

You

What's my Proxies.sx account balance?

AI

Your account balance is $45.00. You have 5/10 endpoints in use and 2.5/10 GB traffic remaining.

If you see your account info, the MCP server is working correctly!

Environment Variables

VariableRequiredDescription
PROXIES_API_KEYYesYour API key from the Documentation page
PROXIES_API_URLNoCustom API URL (default: https://api.proxies.sx/v1)
PROXIES_EMAILAltAlternative: Use email/password instead of API key

Why AI Agents Choose PROXIES.SX

The only mobile proxy service built specifically for AI agents and autonomous systems. Real 4G/5G devices, not datacenter IPs.

📱

Real Mobile IPs

Authentic 4G/5G IPs from real devices. Not datacenter, not residential - genuine mobile carrier traffic.

🎯

92% Success Rate

Industry-leading success on major platforms. Mobile IPs bypass most anti-bot systems without detection.

🌍

100+ Countries

US, UK, Germany, France, Poland, and more. Target specific carriers and cities for geo-precise access.

🔄

Instant Rotation

Rotate to a new device and IP on demand. Auto-rotation schedules. New identity in seconds.

Technical Specifications

HTTP/HTTPS
+ SOCKS5
<500ms
Avg Latency
95%
Uptime SLA
OS Spoof
iOS/Android/Win/Mac

89 MCP Tools for AI Agents

89 tools total - 70 in API-key mode (the main path - account + deposited GB) plus 19 in x402 wallet mode (optional, for account-less agents paying in USDC). Highlights below; the server lists the complete set via MCP tools/list

🌐

Pool Gateway (flagship - 100+ countries)

16 shown
pool_get_stockLive Pool Gateway availability - online endpoint counts per country (no auth needed)
pool_build_proxy_urlBuild a ready-to-use proxy URL via the DSL (pool/country/carrier/city/iptype/sid/rot) - pure local, no network call
pool_list_sessionsList live Pool Gateway sessions (traffic, exit IP, country)
pool_close_sessionClose one live gateway session
pool_get_my_credentialsGet your own proxyUsername + ready HTTP/SOCKS5 connect strings
pool_get_my_statsGet your own usage plus aggregated pool health
pool_set_proxy_passwordSet or update your proxy authentication passwordproxyPassword
pool_mint_keyMint a Pool Access Key (pak_) for a customer (reseller role)label, trafficCapGB?
pool_list_keysList your Pool Access Keys (masked)
pool_update_keyUpdate a key's label/enabled/trafficCapGB/expiresAt/qualityTierkeyId
pool_topup_keyAtomically add traffic cap and/or extend expiry on a keykeyId, addGB?
pool_regenerate_keyRotate a key's secret pak_ valuekeyId
pool_reveal_keyReveal the full pak_ secret (audit-logged)keyId
pool_delete_keyDelete a Pool Access KeykeyId
pool_key_usageDaily in/out MB bandwidth time-series for one keykeyId, days?
pool_key_auditForensic audit log for one keykeyId, limit?

x402 Autonomous Payment

11 shown
x402_get_proxyPurchase a dedicated mobile proxy with USDC on-chain, returns credentialscountry, traffic, tier
x402_get_pricingGet current pricing tiers and available countries with device counts
x402_list_sessionsList all active proxy sessions for your wallet
x402_check_sessionGet detailed session info including port credentialssessionId
x402_wallet_balanceCheck USDC balance on Base or Solana
x402_rotate_ipRotate to a new IP using rotation tokenrotationToken
x402_list_countriesList proxy availability by country with device counts
x402_list_citiesList available cities in a countrycountry
x402_list_carriersList mobile carriers available in a countrycountry
x402_extend_sessionExtend session duration for free (duration-only top-up)sessionId, duration?
x402_service_statusHealth check - verify x402 service is running
🪪

x402 Pool Gateway

8 shown
x402_get_pool_accessBuy Pool Gateway access with USDC - one credential for every country in your tier
x402_pool_creditCheck remaining pool credit (allocated/used/remaining GB)
x402_pool_topupAdd GB (paid, USDC) and/or duration (free) to a pool session
x402_pool_regenerateRotate the pool credential secret (same username, new password)
x402_pool_connectionRe-emit pool proxy credentials (recovery)
x402_pool_usagePer-day bandwidth usage for a pool session
x402_pool_pricingPool Gateway tier catalog + username DSL (no auth needed)
get_pool_stockPublic online endpoint counts per country (no IPs, no auth)
👤

Account

2 shown
get_account_summaryGet balance, email, and resource usage
get_account_usageDetailed traffic breakdown by category
🔌

Port Management

7 shown
list_portsList all proxy ports with filterstype?, status?, countryId?, limit?
get_portGet detailed port info with connection stringsportId
create_portCreate a new proxy portcountryId, type, carrierId?, cityId?
delete_portDelete a proxy portportId
update_port_credentialsChange login/passwordportId, proxyLogin?, proxyPassword?
update_os_fingerprintSet OS fingerprint spoofingportId, osFingerprint
reconfigure_portChange port locationportId, countryId, carrierId?, cityId?
📡

Status & Monitoring

4 shown
get_port_statusCheck if port is online/offlineportId
get_port_ipGet current public IP addressportId
ping_portTest connectivity and latencyportId
speed_test_portMeasure download/upload speedportId
🔄

IP Rotation

5 shown
rotate_portRotate to a new IP addressportId
check_rotation_availabilityCheck if rotation is availableportId
configure_auto_rotationSet up automatic rotationportId, enabled, intervalMinutes?
get_rotation_historyView past rotationsportId, limit?
get_rotation_token_urlGet public rotation URLportId
💳

Billing & Pricing

3 shown
get_pricingGet pricing, volume discounts, and progression
calculate_priceCalculate price with volume discounts appliedamountGB
purchase_shared_trafficBuy traffic in GB, charged against account balancequantityGB
🪙

Crypto Payments

5 shown
create_crypto_paymentCreate payment order ($10-$1000)amount
check_crypto_payment_statusCheck payment statusorderId
get_pending_crypto_paymentsList all pending payments
cancel_crypto_paymentCancel pending paymentorderId
get_crypto_payment_infoGet supported currencies and limits
🌍

Reference Data

1 shown
list_available_countriesList all available proxy countries with device counts
🛠️

Utilities

3 shown
get_proxy_connection_stringGenerate ready-to-use proxy URLportId, protocol?
get_all_proxy_formatsGet all proxy formats (curl, Python, Node.js)portId
get_os_fingerprint_optionsList available OS fingerprint options
🎫

Support Tickets

5 shown
create_support_ticketSubmit a ticket to contact human supportsubject, message, priority?
list_my_ticketsList all your support ticketsstatus?, limit?
get_ticketGet ticket details with full conversation historyticketId
reply_to_ticketReply to an existing support ticketticketId, message
close_ticketClose a resolved support ticketticketId
🔑

x402 Session Management

8 shown
get_x402_sessionGet full session details with port credentialssessionToken
list_x402_portsList all ports in session with statussessionToken
get_x402_port_statusCheck single port status and current IPsessionToken, portId
get_sessions_by_walletGet all sessions for a wallet addresswalletAddress
get_session_statusQuick check if session is activesessionToken
replace_x402_portReplace offline port with new device (free, max 3)sessionToken, portId
topup_x402_sessionPay USDC to extend session traffic/durationsessionToken, addTrafficGB?, addDurationSeconds?
calculate_x402_topupPreview cost of extending a sessionsessionToken, addTrafficGB?, addDurationSeconds?
🛡️

Ops (admin-only)

11 shown
ops_get_userCustomer 360 view: balance, gateway usage, ports, farmer note
ops_get_user_auditRecent ops-agent actions taken on a user
ops_reconcile_paymentsRead-only Stripe-vs-DB payment view for a user
ops_list_ticketsList support tickets (admin view)
ops_reply_ticketPost an admin reply to a ticket
ops_set_slotsSet a user's port slot limits (capped)
ops_credit_balanceCredit a user's balance (capped, daily budget, audited)
ops_email_userSend a personalized email to one user (rate-capped)
ops_list_farmersList farmer AI notes (shared operational memory)
ops_get_farmerFarmer fleet funnel plus AI note
ops_write_farmer_noteWrite/append a farmer AI note

Example Conversations

See how to interact with the MCP server through natural language

Creating a Proxy

You

Create a proxy in Poland

AI
I'll create a proxy in Poland for you.

**Port created successfully!**

```
HTTP: http://user123:pass456@pl.proxies.sx:8080
SOCKS5: socks5://user123:pass456@pl.proxies.sx:1080
```

Country: Poland | Carrier: Play | Expires: 30 days

Rotating IP Address

You

Rotate the IP on my Polish proxy

AI
Rotating your Polish proxy now...

**IP rotated successfully!**

New IP: `185.123.xxx.xxx`
Device: Samsung Galaxy S21 | Carrier: Play

Crypto Payment

You

I need to add $50 to my balance using crypto

AI
**Crypto payment order created!**

Amount: $50.00
Order ID: `topup_xyz789_1702134567890`

[Payment Link](https://pay.coingate.com/invoice/abc123)

Supported: BTC, ETH, USDT, USDC, LTC, DOGE, and 50+ more

Configure Auto-Rotation

You

Set up auto-rotation every 30 minutes on my main proxy, and match the carrier

AI
**Auto-rotation configured!**

| Setting | Value |
|---------|-------|
| Enabled | Yes |
| Interval | 30 minutes |
| Match Carrier | Yes |

Your proxy will rotate to a new device on the same carrier every 30 minutes.

Quick Command Examples

Ready to Give Your AI Agents Real Mobile Proxies?

Choose your path: MCP Server for AI assistants like Claude and Cursor, or x402 Protocol for fully autonomous agents with USDC wallets.