What can you do with this server?

This server enables AI agents to autonomously purchase, configure, and manage mobile proxies (real 4G/5G carrier IPs) via an API key or on-chain USDC payments (x402), with no human intervention required. Account & Billing * Get account summary (balance, email, slot & traffic usage), detailed usage breakdowns, live pricing, and volume discounts * Purchase shared or private traffic GB from account balance * Create, list, and cancel crypto payment orders (BTC, ETH, USDT, 50+ coins via CoinGate) Port Management * List, create, inspect, reconfigure, update credentials, and delete proxy ports * Target specific countries, cities, and carriers * Set OS fingerprint spoofing (Windows, macOS, iOS, Android) Proxy Status & Utilities * Check if a port is online/offline, get its current public IP, ping for latency, and run speed tests * Generate ready-to-use HTTP/SOCKS5 connection strings in multiple formats * List available countries, carriers, and OS fingerprint options IP Rotation * Rotate a port to a new IP on demand, check rotation availability (cooldowns), configure automatic scheduled rotation, view rotation history, and get public no-auth rotation URLs Customer Support * Create, list, view, reply to, and close support tickets x402 Session Management (on-chain purchased sessions) * Retrieve session details and associated ports, check per-port status and traffic usage * Recover sessions by wallet address * Replace offline/broken ports for free (up to 3 per session) * Calculate and execute session top-ups (add traffic or duration) x402 Autonomous Proxy Purchasing (no account needed) * Buy a dedicated mobile proxy by paying USDC on-chain (Base or Solana) — returns live credentials instantly * Get pricing quotes, check wallet USDC balance, rotate IP via rotation token * Browse available countries, cities, and carriers; check service health status x402 Pool Gateway * Purchase a single DSL credential providing access to mobile proxies across multiple countries * Check remaining pool GB credit, top up traffic, regenerate pool credentials, and view tier pricing

Which integrations are available for this server?

Allows AI agents to purchase and manage mobile proxies autonomously by paying with USDC on the Solana blockchain through the x402 protocol.

How do I use @proxies-sx/mcp-server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@proxies-sx/mcp-server Create a new US mobile proxy with 2 GB and rotate the IP." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@proxies-sx/mcp-server

by bolivian-peru

Overview Schema Related Servers Score Discussions

TypeScript

Remote

This server enables AI agents to autonomously purchase, configure, and manage mobile proxies (real 4G/5G carrier IPs) via an API key or on-chain USDC payments (x402), with no human intervention required.

Account & Billing

Get account summary (balance, email, slot & traffic usage), detailed usage breakdowns, live pricing, and volume discounts
Purchase shared or private traffic GB from account balance
Create, list, and cancel crypto payment orders (BTC, ETH, USDT, 50+ coins via CoinGate)

Port Management

List, create, inspect, reconfigure, update credentials, and delete proxy ports
Target specific countries, cities, and carriers
Set OS fingerprint spoofing (Windows, macOS, iOS, Android)

Proxy Status & Utilities

Check if a port is online/offline, get its current public IP, ping for latency, and run speed tests
Generate ready-to-use HTTP/SOCKS5 connection strings in multiple formats
List available countries, carriers, and OS fingerprint options

IP Rotation

Rotate a port to a new IP on demand, check rotation availability (cooldowns), configure automatic scheduled rotation, view rotation history, and get public no-auth rotation URLs

Customer Support

Create, list, view, reply to, and close support tickets

x402 Session Management (on-chain purchased sessions)

Retrieve session details and associated ports, check per-port status and traffic usage
Recover sessions by wallet address
Replace offline/broken ports for free (up to 3 per session)
Calculate and execute session top-ups (add traffic or duration)

x402 Autonomous Proxy Purchasing (no account needed)

Buy a dedicated mobile proxy by paying USDC on-chain (Base or Solana) — returns live credentials instantly
Get pricing quotes, check wallet USDC balance, rotate IP via rotation token
Browse available countries, cities, and carriers; check service health status

x402 Pool Gateway

Purchase a single DSL credential providing access to mobile proxies across multiple countries
Check remaining pool GB credit, top up traffic, regenerate pool credentials, and view tier pricing

@proxies-sx/mcp-server

npm version License: MIT

MCP (Model Context Protocol) server for AI agents to manage mobile proxy infrastructure on Proxies.sx.

This server enables AI assistants like Claude to manage your proxy ports, rotate IPs, purchase resources, and more through natural language commands. Learn more about MCP integration and x402 autonomous payments.

Two Authentication Modes

1. API Key Mode (Account Required)

Use your Proxies.sx account and API key to manage existing subscriptions.

2. x402 Payment Mode (No Account Needed)

AI agents can autonomously purchase proxies using USDC on Base or Solana networks - no account required! See our x402 documentation for details.

Related MCP server: Fluora MCP

Features

Account Management: Check balance, usage, and resource allocation
Port Management: Create, configure, delete proxy ports
IP Rotation: Manual and automatic rotation with customizable settings
Status Monitoring: Check port status, IP addresses, latency, speed
Billing: Purchase slots and traffic using account balance
Crypto Payments: Top up balance with BTC, ETH, USDT, and 50+ cryptocurrencies
x402 Autonomous Payments: AI agents pay with USDC - no account needed
Reference Data: List available countries, carriers, and cities

Installation

Option 1: npx (Recommended - No Install)

The easiest way to use this MCP server - no installation required:

npx @proxies-sx/mcp-server

Option 2: npm Install (Global)

Install globally to use the proxies-sx-mcp command anywhere:

npm install -g @proxies-sx/mcp-server

After installation, run with:

proxies-sx-mcp

Option 3: npm Install (Local Project)

Add to your project as a dependency:

npm install @proxies-sx/mcp-server

Then run with:

npx proxies-sx-mcp

Option 4: From Source

git clone https://github.com/proxies-sx/mcp-server.git
cd mcp-server
npm install
npm run build
npm start

What Gets Installed

When you run npm install @proxies-sx/mcp-server:

@proxies-sx/mcp-server (904 KB)
├── @modelcontextprotocol/sdk  (MCP protocol implementation)
├── viem                       (Ethereum/Base wallet operations)
└── zod                        (Input validation)

Total: ~88 MB with all dependencies

Package contents:

dist/ - Compiled JavaScript + TypeScript definitions
README.md - Documentation
LICENSE - MIT License
llm.txt - AI agent discovery document

Verify Installation

After installing, verify the package works:

# Check version
npm list @proxies-sx/mcp-server

# Test loading (should show "61 tools available" - the API-key set; 79 total with the 18 x402 wallet tools)
node -e "const t = require('@proxies-sx/mcp-server/dist/tools'); console.log(t.allToolDefinitions.length + ' tools available')"

Configuration

Environment Variables

Variable	Mode	Required	Description
`PROXIES_API_KEY`	API Key	Yes	Your Proxies.sx API key
`AGENT_WALLET_KEY`	x402	Yes	Private key for USDC payments (Base or Solana)
`PROXIES_API_URL`	Both	No	Custom API URL (default: `https://api.proxies.sx/v1`)

Mode 1: API Key Authentication

Log in to client.proxies.sx
Go to Account Settings
Create a new API key with scopes:
- ports:read, ports:write, ports:rotate - Port management
- billing:read, billing:write - Purchases
- account:read - Account info
- traffic:read - Usage data

Mode 2: x402 Autonomous Payments

No account needed! The agent uses a crypto wallet to pay directly:

Create a wallet on Base or Solana network
Fund it with USDC (minimum $0.40 for 0.1 GB, or $4.00 for 1 GB)
Add a small amount of ETH (Base) or SOL (Solana) for gas fees (~$0.01)
Set AGENT_WALLET_KEY to your private key

Usage with Claude Desktop

API Key Mode

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

x402 Payment Mode (Autonomous)

{
  "mcpServers": {
    "proxies-sx": {
      "command": "npx",
      "args": ["-y", "@proxies-sx/mcp-server"],
      "env": {
        "AGENT_WALLET_KEY": "0x_your_private_key_here"
      }
    }
  }
}

Then restart Claude Desktop.

x402 Protocol - Autonomous AI Payments

The x402 protocol enables machine-to-machine payments using HTTP 402 Payment Required.

How It Works

┌─────────────────────────────────────────────────────────────────────────────┐
│                          x402 PAYMENT FLOW                                  │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│   1. Agent requests proxy                                                   │
│   ┌─────────────────────┐       ┌──────────────────────────────────────┐   │
│   │ MCP Server          │──────▶│ api.proxies.sx/v1/x402/proxy        │   │
│   │ @proxies-sx/mcp     │       │                                      │   │
│   └─────────────────────┘       │  Returns 402 Payment Required        │   │
│                                 │  with payment requirements           │   │
│                                 └──────────────────────────────────────┘   │
│                                              │                              │
│   2. Agent signs USDC payment                ▼                              │
│   ┌─────────────────────┐       ┌──────────────────────────────────────┐   │
│   │ Agent Wallet (viem) │       │ Payment Requirements:                │   │
│   │ Signs ERC-20 permit │       │ - Amount: $4.00 USDC (1GB)    │   │
│   └──────────┬──────────┘       │ - Network: Base or Solana            │   │
│              │                  │ - Recipient: Proxies.sx wallet       │   │
│              ▼                  └──────────────────────────────────────┘   │
│   3. Payment settled via x402.org facilitator                              │
│   ┌─────────────────────┐       ┌──────────────────────────────────────┐   │
│   │ Retry request with  │──────▶│ Payment verified & settled on-chain │   │
│   │ payment signature   │       │ (Base L2 or Solana)                  │   │
│   └──────────┬──────────┘       └──────────────────────────────────────┘   │
│              │                                                              │
│              ▼                                                              │
│   4. Proxy credentials returned                                            │
│   ┌─────────────────────────────────────────────────────────────────────┐   │
│   │ PROXY CREDENTIALS                                                    │   │
│   │ - HTTP: http://user:pass@server:8500                                │   │
│   │ - SOCKS5: socks5://user:pass@server:5500                            │   │
│   │ - Session token for management                                      │   │
│   │ - Rotation URL for IP changes                                       │   │
│   └─────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

x402 Pricing

Duration is always FREE — you only pay for traffic.

Tier	Port Price	Traffic Price	Min Purchase
Shared	FREE	$4.00/GB	0.1 GB ($0.40)

Available countries: DE, PL, US, FR, ES, GB (dynamic based on device availability)

Supported Networks

Network	USDC Address	Recipient
Base	`0x833589fcd6edb6e08f4c7c32d4f71b54bda02913`	`0xF8cD900794245fc36CBE65be9afc23CDF5103042`
Solana	`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`	`6eUdVwsPArTxwVqEARYGCh4S2qwW2zCs7jSEDRpxydnv`

x402 Tools (Detailed)

Tool	What It Does
`x402_get_proxy`	Purchase a mobile proxy automatically. Sends USDC on-chain, waits for confirmation, returns proxy credentials (host, port, username, password, session token, rotation token). Specify country and traffic in GB.
`x402_get_pricing`	Get current pricing — $4/GB. Shows minimum purchase (0.1 GB), duration rules, and available countries with live device counts.
`x402_list_sessions`	List all active proxy sessions for your wallet. Shows session ID, traffic used/remaining, expiration, port count, and status.
`x402_check_session`	Get detailed session info by ID — includes all port credentials, traffic stats, and expiration. Use this to retrieve your proxy details.
`x402_wallet_balance`	Check your USDC balance on Base or Solana. Shows available funds and whether you have enough for a purchase.
`x402_rotate_ip`	Rotate to a new IP address using the rotation token from your proxy purchase. Free, no payment needed. Returns the new IP.
`x402_list_countries`	List countries where proxies are available with live device counts. Currently: DE, PL, US, FR, ES, GB.
`x402_list_cities`	List available cities within a specific country.
`x402_list_carriers`	List mobile carriers available in a country (e.g., AT&T, Verizon, T-Mobile for US).
`x402_extend_session`	Extend a session's duration for FREE (duration-only top-up, no USDC sent). Accepts a session ID or the x402s_ session token. All active ports in the session are extended. For more traffic (paid, $4/GB) use `topup_x402_session`.
`x402_service_status`	Health check — verifies the x402 service is running and accepting payments.

x402 Pool Gateway Tools (Detailed)

Wallet-only Pool Gateway access: pay USDC, get ONE credential that reaches every country in your tier via the username DSL (e.g. psx_xxx-mbl-us, -mbl-de, ...). HTTP proxy on port 7000. v1 tier is mbl ($4/GB, metered, production ProxySmart modems).

Tool	What It Does
`x402_get_pool_access`	Buy Pool Gateway access with USDC (Base or Solana). Returns one credential valid for every country in the tier, plus a session token (cached locally) for the manage tools below.
`x402_pool_credit`	Check remaining pool credit (allocated/used/remaining GB, enabled state, expiry). Uses the cached session token if none is provided.
`x402_pool_topup`	Add GB (paid, $4/GB) and/or duration (FREE) to a pool session. Pays USDC automatically when traffic is added.
`x402_pool_regenerate`	Rotate the pool credential secret (new password, same username). Use if the credential leaked.
`x402_pool_connection`	Re-emit the full pool proxy credentials (host, port, username, password) for recovery.
`x402_pool_pricing`	Get the Pool Gateway tier catalog: tiers, $/GB, min purchase, networks, and the username DSL. No auth or wallet needed.
`get_pool_stock`	Public Pool Gateway stock: online endpoint counts per country (no IPs). No auth needed.

API Key Mode Tools

Account Tools

Tool	Description
`get_account_summary`	Get account balance and resource usage
`get_account_usage`	Get detailed traffic breakdown

Port Tools

Tool	Description
`list_ports`	List all proxy ports with filters
`get_port`	Get detailed port information
`create_port`	Create a new proxy port
`delete_port`	Delete a proxy port
`update_port_credentials`	Update port login/password
`update_os_fingerprint`	Set OS fingerprint spoofing
`reconfigure_port`	Change port location

Status Tools

Tool	Description
`get_port_status`	Check if port is online
`get_port_ip`	Get current public IP
`ping_port`	Test connectivity and latency
`speed_test_port`	Measure download/upload speed

Rotation Tools

Tool	Description
`rotate_port`	Rotate to new IP
`check_rotation_availability`	Check if rotation is available
`configure_auto_rotation`	Set up automatic rotation
`get_rotation_history`	View rotation history
`get_rotation_token_url`	Get public rotation URL

Billing Tools

Tool	Description
`get_pricing`	Get current pricing with volume discounts and slot tiers
`calculate_price`	Calculate price for a specific GB amount with volume discounts
`purchase_shared_traffic`	Buy shared traffic in GB ($4/GB base). Auto-upgrades slot tier!

Crypto Payment Tools

Tool	Description
`create_crypto_payment`	Create crypto payment order ($10-$1000)
`check_crypto_payment_status`	Check payment status by order ID
`get_pending_crypto_payments`	List all pending payments
`cancel_crypto_payment`	Cancel a pending payment
`get_crypto_payment_info`	Supported currencies info

Supported: BTC, ETH, USDT, USDC, LTC, DOGE, TRX, XRP, ADA, SOL, MATIC, AVAX, DOT, LINK, UNI, SHIB, and 50+ more.

Reference Tools

Tool	Description
`list_available_countries`	List available countries with live device counts

Utility Tools

Tool	Description
`get_proxy_connection_string`	Generate connection string
`get_all_proxy_formats`	Get all proxy formats
`get_os_fingerprint_options`	List OS fingerprint options

Support Tools

Tool	Description
`create_support_ticket`	Submit a ticket to contact human support
`list_my_tickets`	List all your support tickets
`get_ticket`	Get ticket details with conversation history
`reply_to_ticket`	Reply to an existing ticket
`close_ticket`	Close a resolved ticket

Pool Gateway Tools

For resellers and gateway users: check stock, build proxy URLs with the username token DSL, and manage Pool Access Keys (pak_). Minting/listing/topping-up keys requires a reseller-role API key.

Tool	Description
`pool_get_stock`	Live Pool Gateway availability - online endpoint counts per country (no auth needed)
`pool_build_proxy_url`	Build a ready-to-use gateway proxy URL from a reseller proxyUsername + a customer `pak_` key via the username token DSL (pool/country/carrier/city/sid/rot). Pure local builder, no network call
`pool_list_sessions`	List live Pool Gateway sessions (traffic stats, exit IP, country). Pass `pakId` to scope to one customer
`pool_close_session`	Close one live gateway session by its sessionKey
`pool_mint_key`	Mint a new Pool Access Key (`pak_`) for a customer. `trafficCapGB` null = unlimited within your pool; `qualityTier: "safe"` routes only premium (mbl) stock
`pool_list_keys`	List your Pool Access Keys (masked)
`pool_topup_key`	Top up a `pak_` key: add traffic cap and/or extend expiry (atomic)

Ops Tools (Admin)

For internal ops agents. These require an admin API key with ops:* scopes - they do nothing with a regular customer key. All write actions are capped, rate-limited, audit-logged, and require a reason; large credits go to human approval.

Tool	Description
`ops_get_user`	Customer 360 view: balance, gateway usage, ports, farmer note
`ops_get_user_audit`	Recent ops-agent actions taken on a user
`ops_reconcile_payments`	Read-only Stripe-vs-DB payment view for a user
`ops_list_tickets`	List support tickets (admin view, optional status filter)
`ops_reply_ticket`	Post an admin reply to a ticket, optionally emailing the customer
`ops_set_slots`	Set a user's shared/private port slot limits (capped)
`ops_credit_balance`	Credit a user's balance in USD (capped per-action + daily budget)
`ops_email_user`	Send a personalized email to one user (hourly rate-capped)
`ops_list_farmers`	List farmer AI notes (shared operational memory)
`ops_get_farmer`	Farmer fleet funnel (total/online/verified/listed/routable) + AI note
`ops_write_farmer_note`	Write/append a farmer AI note shared with future AI sessions

X402 Session Management Tools

For agents who purchase via x402 protocol. Use X-Session-Token header for authentication.

Tool	What It Does
`get_x402_session`	Retrieve full session details — all port credentials (host, http_port, socks_port, username, password), traffic used/remaining, expiration, active status. Uses your X-Session-Token from the purchase response.
`list_x402_ports`	List every port in your session with online/offline status, current IP, and traffic consumed per port.
`get_x402_port_status`	Check a single port's detailed status — online/offline, current public IP, traffic used, device info, and expiration time.
`get_sessions_by_wallet`	List all sessions (active and expired) for your wallet address. Useful for recovering session tokens or reviewing history.
`get_session_status`	Quick status check — is the session active, how much traffic remains, when does it expire.
`replace_x402_port`	Replace an offline or broken port with a new one on a different device. Completely free, max 3 replacements per session. The failed device is excluded from selection. Use when your proxy stops working.
`calculate_x402_topup`	Preview the cost of extending your session. Specify `addTrafficGB` and/or `addDurationSeconds`. Duration-only extensions are free ($0). Traffic costs $4/GB.
`topup_x402_session`	Pay USDC to extend your session with more traffic or duration. Requires a new on-chain payment. All active ports in the session are automatically extended. Replay-protected (each tx hash can only be used once).

Peer Marketplace — Earn USDC

AI agents can earn USDC by sharing their internet bandwidth as peer proxy nodes.

Two prices, never confuse them. Everywhere above, $4/GB is the SELL price — what you PAY to use a proxy. The rates below are the PAYOUT — what you EARN for sharing bandwidth. They are not the same number and should never be conflated.

Earnings by IP Type (PAYOUT — what you earn for sharing, net, no platform fee):

Mobile IPs: $1.80/GB (AT&T, Verizon, T-Mobile, Vodafone)
Residential IPs: $1.20/GB (Comcast, Spectrum, Cox)
Datacenter IPs: $0.30/GB (AWS, GCP, Azure, VPNs)

Payout rates are configurable in admin settings (system_settings peer_rates) — these are current defaults, not a contractual guarantee. Check the live earningsPerGB field in the registration response for the rate at registration time.

How it works:

Register: POST https://api.proxies.sx/v1/peer/agents/register
Get JWT token + device ID
Connect to WebSocket relay: wss://relay.proxies.sx with Sec-WebSocket-Protocol: token.{JWT} header
Route proxy_request messages through your connection
Respond to heartbeat with heartbeat_ack
Earn automatically per GB routed

Minimum payout: $5.00 USDC on Solana Full docs: https://agents.proxies.sx/peer/skill.md

Example Conversations

x402: Get a Proxy (Autonomous)

User: I need a US mobile proxy for web scraping

Claude: [Uses x402_get_pricing to calculate cost]
Claude: [Uses x402_get_proxy with country=US, duration=3600, traffic=1]

I've purchased a US mobile proxy for 1 hour with 1GB traffic.
Cost: $4.00 USDC (paid from your agent wallet on Base)

Connection Details:
  HTTP: http://x402_abc123:xyz789@tmcal1.ddns.net:8500
  SOCKS5: socks5://x402_abc123:xyz789@tmcal1.ddns.net:5500

Session ID: 695abc123...
Expires: in 1 hour

Check Account Status

User: What's my account status?
Claude: [Uses get_account_summary]
Your account balance is $45.00. You have 5/10 shared slots used and 2.5/10 GB traffic remaining.

Create a Proxy Port

User: Create a new shared proxy in Germany
Claude: [Uses list_available_countries to find Germany ID]
Claude: [Uses create_port with countryId and type=shared]
Port created! Here are your connection details:
  HTTP: http://user123:pass456@proxy.example.com:8080
  SOCKS5: socks5://user123:pass456@proxy.example.com:1080

Rotate IP

User: Rotate the IP on my main proxy
Claude: [Uses list_ports to find the port]
Claude: [Uses rotate_port]
IP rotated successfully! New IP: 185.123.xxx.xxx

Top Up Balance with Crypto

User: I need to add $50 to my balance using crypto
Claude: [Uses create_crypto_payment with amount=50]
I've created a crypto payment order for $50. Here's your payment link:
https://pay.coingate.com/invoice/abc123

Supported: BTC, ETH, USDT, and 50+ more cryptocurrencies.
Balance will be credited automatically once confirmed.

x402: Check Session Status

User: How much traffic have I used on my session?
Claude: [Uses get_x402_session with sessionToken]

Your x402 session status:
  Status: Active
  Traffic: 0.35/1.0 GB used (35%)
  Expires: in 45 minutes

Ports:
  - Proxy US-1: http://x402_abc:xyz@tmcal1.ddns.net:8500
    Rotation URL: https://api.proxies.sx/rotate/tok_...

Contact Human Support

User: I'm having issues with my proxy not connecting, can you open a ticket?
Claude: [Uses create_support_ticket]

I've created a support ticket for you:
  Ticket ID: 695abc...
  Subject: Proxy Connection Issues
  Status: Open

The Proxies.sx support team will respond as soon as possible.
You can use `get_ticket` to check for updates.

API Endpoints

x402 Endpoints (No Auth Required)

Method	Endpoint	Description
GET/POST	`/v1/x402/health`	Service health check
GET/POST	`/v1/x402/pricing`	Get pricing info
GET/POST	`/v1/x402/calculate`	Calculate cost
GET/POST	`/v1/x402/proxy`	Purchase proxy (402 flow)
GET	`/v1/x402/session/:id`	Get session by ID
GET	`/v1/x402/session/tx/:txHash`	Get session by tx hash
GET	`/v1/x402/sessions/wallet/:wallet`	List sessions by wallet
GET	`/v1/x402/sessions/:id/status`	Get session status

x402 Session Management (Session Token Auth)

Use X-Session-Token header with the token from purchase response:

Method	Endpoint	Description
GET	`/v1/x402/manage/session`	Get session details + ports
GET	`/v1/x402/manage/session/credit`	Check remaining credit
GET	`/v1/x402/manage/ports`	List all ports in session
GET	`/v1/x402/manage/ports/:id/status`	Get detailed port status
POST	`/v1/x402/manage/ports/recreate`	Recreate deleted port
POST	`/v1/x402/manage/ports/replace`	Replace offline port (free, max 3)
GET	`/v1/x402/manage/session/topup/calculate`	Preview top-up cost
POST	`/v1/x402/manage/session/topup`	Pay to extend session

API Key Endpoints

Method	Endpoint	Description
GET	`/v1/ports`	List all ports
POST	`/v1/ports`	Create port
GET	`/v1/ports/:id`	Get port details
DELETE	`/v1/ports/:id`	Delete port
POST	`/v1/ports/:id/rotate`	Rotate port
GET	`/v1/account`	Get account info

Full API documentation: proxies.sx/docs

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run tests
npm test

# Lint code
npm run lint

Troubleshooting

"Authentication required" Error

This is expected behavior when no credentials are provided:

Failed to start MCP server: Authentication required. Set one of:
  Mode 1 (API Key):
    - PROXIES_API_KEY: Your API key from https://client.proxies.sx/account
  Mode 2 (x402 Wallet):
    - AGENT_WALLET_KEY: Your wallet private key for USDC payments

Solution: Provide authentication via environment variable:

# With API key
PROXIES_API_KEY=psx_your_key npx @proxies-sx/mcp-server

# With x402 wallet
AGENT_WALLET_KEY=0x_your_private_key npx @proxies-sx/mcp-server

Node.js ExperimentalWarning

If you see this warning on Node.js 23+:

ExperimentalWarning: CommonJS module ... is loading ES Module ... using require()

This is harmless - it's a Node.js warning about ESM/CommonJS interop, not an error. To suppress:

NODE_NO_WARNINGS=1 npx @proxies-sx/mcp-server

npm Install Fails

If npm install fails:

# Clear npm cache
npm cache clean --force

# Try installing again
npm install @proxies-sx/mcp-server

# Or use a specific registry
npm install @proxies-sx/mcp-server --registry https://registry.npmjs.org

Package Not Found

If you get "package not found" error:

# Check if package exists
npm view @proxies-sx/mcp-server

# Update npm
npm install -g npm@latest

# Try again
npm install @proxies-sx/mcp-server

Verify Package Integrity

# Check installed version
npm list @proxies-sx/mcp-server

# Verify package loads correctly
node -e "require('@proxies-sx/mcp-server/dist/tools')" && echo "OK"

# Check tool count (should be 61 - the API-key set; x402 wallet tools add 18 more for 79 total)
node -e "console.log(require('@proxies-sx/mcp-server/dist/tools').allToolDefinitions.length)"

Claude Desktop Not Detecting MCP Server

Ensure config file is in correct location:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Verify JSON syntax is valid
Restart Claude Desktop completely (quit and reopen)
Check Claude Desktop logs for errors

About Proxies.sx

Proxies.sx provides premium mobile 4G/5G proxy infrastructure for web scraping, ad verification, social media automation, and more. Our MCP server enables seamless integration with AI assistants, and our x402 protocol support allows AI agents to autonomously purchase and manage proxies without human intervention.

License

MIT License - see LICENSE file.

Built with love by Proxies.sx

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

8dResponse time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bolivian-peru/proxies-sx-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

@proxies-sx/mcp-server

Two Authentication Modes

1. API Key Mode (Account Required)

2. x402 Payment Mode (No Account Needed)

Features

Installation

Option 1: npx (Recommended - No Install)

Option 2: npm Install (Global)

Option 3: npm Install (Local Project)

Option 4: From Source

What Gets Installed

Verify Installation

Configuration

Environment Variables

Mode 1: API Key Authentication

Mode 2: x402 Autonomous Payments

Usage with Claude Desktop

API Key Mode

x402 Payment Mode (Autonomous)

x402 Protocol - Autonomous AI Payments

How It Works

x402 Pricing

Supported Networks

x402 Tools (Detailed)

x402 Pool Gateway Tools (Detailed)

API Key Mode Tools

Account Tools

Port Tools

Status Tools

Rotation Tools

Billing Tools

Crypto Payment Tools

Reference Tools

Utility Tools

Support Tools

Pool Gateway Tools

Ops Tools (Admin)

X402 Session Management Tools

Peer Marketplace — Earn USDC

Example Conversations

x402: Get a Proxy (Autonomous)

Check Account Status

Create a Proxy Port

Rotate IP

Top Up Balance with Crypto

x402: Check Session Status

Contact Human Support

API Endpoints

x402 Endpoints (No Auth Required)

x402 Session Management (Session Token Auth)

API Key Endpoints

Development

Links

Proxies.sx

Contact & Support

x402 Protocol

Troubleshooting

"Authentication required" Error

Node.js ExperimentalWarning

npm Install Fails

Package Not Found

Verify Package Integrity

Claude Desktop Not Detecting MCP Server

About Proxies.sx

License

Maintenance

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API