Skip to main content
Glama
bolivian-peru

@proxies-sx/mcp-server

πŸ›°οΈ @proxies-sx/mcp-server

The Model Context Protocol server that lets AI agents buy and run mobile proxies β€” by themselves.

npm version License: MIT MCP tools x402

Quickstart Β· Two modes Β· Tool catalog Β· x402 Β· Docs Β· AI hub


Give Claude (or any MCP client) the keys to a real mobile-proxy network: create ports, rotate IPs, buy traffic, check status, open support tickets β€” all through natural language. Two ways to pay: a normal API key, or x402 so an agent pays USDC on-chain with no account at all.

You:  "Get me a US mobile proxy with 2 GB and rotate the IP."
Claude β†’ x402_get_proxy(country=US, trafficGB=2)  β†’  pays $8 USDC on Base  β†’  returns live creds
Claude β†’ x402_rotate_ip()                          β†’  fresh carrier IP

Mobile proxies, metered honestly. Real 4G/5G carrier IPs across 6+ countries. $4 / GB, GB never expires. Duration is always free β€” you only pay for data.


πŸ‘₯ Two audiences β€” pick your door

You are…

You want to…

Use

An AI agent / developer / buyer

Buy and operate proxies programmatically

This MCP server (or the REST API)

A device owner / farmer

Earn by sharing bandwidth from phones

The Peer SDK β†’ agents.proxies.sx/peer

This server is the buyer / consumer side. Farming and peer registration is a separate flow with its own SDK β€” see the peer hub above. (No peer-registration tools live here by design.)


Related MCP server: Fluora MCP

⚑ 30-second quickstart

# No install needed β€” just run it
npx @proxies-sx/mcp-server

Then drop it into your MCP client. For Claude Desktop, edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "proxies-sx": {
      "command": "npx",
      "args": ["-y", "@proxies-sx/mcp-server"],
      "env": {
        // Pick ONE mode (see below)
        "PROXIES_API_KEY": "psx_your_api_key_here"
        // β€” or β€” autonomous on-chain payments:
        // "AGENT_WALLET_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Restart Claude Desktop β†’ you'll see 55 tools available. Works the same in Cursor, Cline, Continue, or any MCP-compatible client.


πŸ”‘ Two ways to authenticate

Mode 1 β€” API key (you have an account)

  1. Log in to client.proxies.sx β†’ Account β†’ API Keys.

  2. Create a key with the scopes you need: ports:read ports:write ports:rotate billing:read billing:write account:read traffic:read.

  3. Set PROXIES_API_KEY=psx_….

Best for: existing customers, dashboards, scripts, persistent automation.

Mode 2 β€” x402 (no account, the agent pays on-chain) πŸ€–

  1. Create a wallet on Base or Solana.

  2. Fund it with USDC (min $0.40 for 0.1 GB) + a few cents of ETH/SOL for gas.

  3. Set AGENT_WALLET_KEY=<private key>.

The agent now buys proxies autonomously β€” it signs a USDC payment, the server verifies it on-chain (~2 s on Base, ~400 ms on Solana), and returns live credentials. No signup, no card, no human.

Variable

Mode

Required

Default

PROXIES_API_KEY

API key

yes (this mode)

β€”

AGENT_WALLET_KEY

x402

yes (this mode)

β€”

PROXIES_API_URL

both

no

https://api.proxies.sx/v1


🧰 Tool catalog (55 tools)

Tool

What it does

get_account_summary

Balance, email, slot & traffic usage

get_account_usage

Traffic breakdown (shared vs private)

get_pricing

Live pricing β€” $4/GB shared, $8/GB private, volume discounts

calculate_price

Price a GB amount with volume discount applied

purchase_shared_traffic

Buy shared GB from balance (also raises your free slot tier)

purchase_private_traffic

Buy private (dedicated-modem) GB from balance

Tool

What it does

list_ports

All ports with filters (type, status, location)

get_port

Full detail for one port

create_port

New port in a country (optional carrier/city)

reconfigure_port

Move a port to a new country/carrier/city

update_port_credentials

Change a port's login/password

update_os_fingerprint

p0f OS spoofing for a port

delete_port

Remove a port

Tool

What it does

get_port_status Β· get_port_ip Β· ping_port Β· speed_test_port

Online check, current IP, latency, speed

get_proxy_connection_string Β· get_all_proxy_formats

Ready-to-paste HTTP/SOCKS5 strings, every common format

get_os_fingerprint_options Β· list_available_countries

Spoofing options, live country availability

Tool

What it does

rotate_port

Swap to a new modem/IP, keep credentials

check_rotation_availability

Cooldown / circuit-breaker check

configure_auto_rotation

Auto-rotate every N minutes

get_rotation_history Β· get_rotation_token_url

Audit trail Β· public no-auth rotate URL

Tool

What it does

create_crypto_payment Β· check_crypto_payment_status

Open a hosted crypto order Β· poll it

get_pending_crypto_payments Β· cancel_crypto_payment Β· get_crypto_payment_info

Manage pending orders, supported coins

create_support_ticket Β· list_my_tickets Β· get_ticket Β· reply_to_ticket Β· close_ticket

Tool

What it does

get_x402_session Β· list_x402_ports Β· get_x402_port_status

Session detail, all ports, per-port status

get_sessions_by_wallet Β· get_session_status

Recover sessions by wallet Β· quick status

replace_x402_port

Swap an offline port to a new device β€” free, max 3/session

calculate_x402_topup Β· topup_x402_session

Preview top-up Β· pay USDC to add traffic/duration

Tool

What it does

x402_get_proxy

Buy a proxy with USDC on-chain β€” returns creds + session token

x402_get_pricing

Quote a purchase ($4/GB, duration free)

x402_wallet_balance

USDC balance + wallet address

x402_rotate_ip

Free IP rotation via rotation token

x402_extend_session

Pay USDC to add traffic/duration

x402_list_sessions Β· x402_check_session

List / inspect your wallet's sessions

x402_list_countries Β· x402_list_cities Β· x402_list_carriers

Live geo + carrier targeting

x402_service_status

Health check


πŸ’Έ x402 β€” autonomous on-chain payments

x402 revives HTTP 402 Payment Required for the agent economy. Your agent requests a proxy, gets a price, signs a USDC transfer, and retries with the transaction β€” the server verifies on-chain and provisions instantly.

agent ──▢ x402_get_proxy(US, 2GB)
          β”‚  402 Payment Required β†’ pay $8 USDC
          β–Ό
   Base (eip155:8453)  or  Solana   ──▢  on-chain verify  ──▢  live proxy creds + session token
  • Pricing: $4 / GB (shared) Β· $8 / GB (private). Duration is free. Min $0.40.

  • Networks: Base (USDC, ~2 s) and Solana (USDC, ~400 ms).

  • No account, no card, no human. The wallet is the identity.

Build agents directly on the protocol with the open-source SDK: @proxies-sx/x402-core, @proxies-sx/x402-hono, @proxies-sx/x402-solana.


πŸ“š Recipes & deeper docs


πŸ› οΈ Install options

npx @proxies-sx/mcp-server          # zero-install (recommended)
npm i -g @proxies-sx/mcp-server     # global β†’ `proxies-sx-mcp`
npm i @proxies-sx/mcp-server        # local dependency

From source:

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

Verify: npx @proxies-sx/mcp-server --version (it should report 55 tools available).


🀝 Contributing & support

Issues and PRs welcome. Need a human? Use the create_support_ticket tool, or reach the team at client.proxies.sx. Licensed MIT.

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

–Maintainers
8dResponse time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Latest Blog Posts

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