PROXIES.SX MCP SERVER

96 tools (20 listed by default) that let Claude, Cursor, Windsurf, Claude Code - any MCP client - buy, configure and use mobile and residential proxies and rent Private modems without leaving the chat. One npx command or the hosted server https://api.proxies.sx/mcp, two auth modes, nearly every tool backed by a documented api.proxies.sx/v1 endpoint.
96 tools (20 by default)
v3.2.0 on npm and hosted
2 auth modes
LIVE

npm: @proxies-sx/mcp-server GitHub Get an API key

Explicitly choose pool; do not rely on the SDK’s mobile-pool default. @proxies-sx/pool-sdk uses mbl if pool is omitted. Set pool: 'peer' for the peer network, pool: 'mbl' for shared carrier modems, or pool: 'any' only for deliberately mixed supply. Residential-only peer connections also need ipType: 'residential' (username -iptype-residential). Check the chosen pool/country’s live stock and keep the customer’s targeting unchanged. Pool selection contract.

INSTALL

Nothing to clone. Every client below runs the published package through npx:

npx -y @proxies-sx/mcp-server

Requires Node 18+. The package is @proxies-sx/mcp-server on npm; the official MCP registry name is io.github.bolivian-peru/proxies-sx-mcp-server.

Or nothing to install: the same server is hosted at https://api.proxies.sx/mcp (Streamable HTTP). Send your key as Authorization: Bearer psx_...; without a key it lists only the 5 public tools (stock, facets, URL builder, error explainer, service status). Add ?toolset=full to the URL for every API-key tool. The x402 wallet mode runs only locally (npx), because the hosted server never holds a wallet key.

claude mcp add --transport http proxies-sx https://api.proxies.sx/mcp --header "Authorization: Bearer psx_your_api_key_here"

Or as a Claude Code plugin (connects to the hosted server, adds the Proxies.sx skill and asks for your key once, stored masked):

/plugin marketplace add bolivian-peru/proxies-sx-mcp-server
/plugin install proxies-sx@proxies-sx

TWO AUTH MODES

ModeEnv varWho it is forHow it pays
API key (standard)PROXIES_API_KEY=psx_...Anyone with an account - mint the key at client.proxies.sx/accountDeposited GB on the account: balance $4/GB to $2.40/GB at 250 GB+, used by pool traffic at 1.00 / 0.375 / 0.1875 GB per GB by exit country
x402 wallet (optional)AGENT_WALLET_KEY=0x...Account-less agents holding USDC on BasePer purchase, on-chain, HTTP 402 flow - no signup

Set one or both. With an API key the server lists a default toolset of 20 tools (buy, use, manage; led by the Private modem and card top-up tools); --toolset=full or PROXIES_TOOLSET=full lists all 96 API-key tools. A wallet-only agent gets the 16 x402 tools and the 5 tools that need no account (stock, facets, URL builder, error explainer, service status); with both variables and the full toolset the server lists all 112. PROXIES_API_URL is optional (default https://api.proxies.sx); leave it unset.

CONFIG BLOCKS

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop:

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

Cursor

~/.cursor/mcp.json (global) or .cursor/mcp.json in the project:

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

Windsurf

~/.codeium/windsurf/mcp_config.json:

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

Claude Code

claude mcp add proxies-sx -e PROXIES_API_KEY=psx_your_api_key_here -- npx -y @proxies-sx/mcp-server

Wallet mode (any client)

Same block, different env - the agent pays USDC per purchase and needs no account:

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

TOOL CATEGORIES (96)

GroupToolsWhat it doesExamples
Private modems6Rent one whole 4G/5G modem by the day, week or month from the balance: plans and prices, quote, buy, renew, rotate the IP, list yours with credentials (buy and renew need modems:purchase and the user's yes to the amount)proxies_modem_catalog, proxies_modem_quote, proxies_modem_buy, proxies_modem_mine
Pool Gateway19Your gateway credential, live stock and facets per country, build a proxy URL from the username DSL, explain a gateway error, sessions, reseller pool-access keyspool_get_my_credentials, pool_get_stock, pool_build_proxy_url, pool_explain_error, pool_mint_key
Private Pool and Reserved IPs10Separate credentials per project, devices reserved for you aloneprivate_pool_build, reserved_ip_reserve
Dedicated ports9Dedicated modem ports: countries with a free modem, create, inspect, extend, reconfigure, deletelist_available_countries, create_port, extend_port
Rotation5Rotate a port's IP, schedule auto-rotation, read historyrotate_port, configure_auto_rotation
Status4Port health, server address, ping, speed testget_port_status, ping_port
Billing6Pricing, quotes, coupons, payment history; buying GB from balance needs a reseller or admin keyget_pricing, coupon_redeem, get_payment_history
Payments7Card top-up through a Stripe Checkout link a person pays (needs billing:topup), crypto deposits and their status; creating or cancelling a crypto order needs a reseller or admin keyproxies_topup_checkout, proxies_topup_status, check_crypto_payment_status
Support5Open, read, reply to and close ticketscreate_support_ticket
x402 sessions8Inspect and top up wallet-bought sessionsget_x402_session, topup_x402_session
Account2Balance, GB left, usageget_account_summary
Utilities4Connection strings in every client format, service statusget_all_proxy_formats, get_service_status
Ops11Staff-scoped keys only: customer 360, tickets, credits, farmer notesops_get_user

The gateway username the tools build is the same DSL you can hand-write: psx_<accountId>-<pool>-<country>[-rot-<mode>][-sid-<id>]. Sticky and auto rotation need a -sid-; unknown tokens are skipped and listed in the X-Psx-Corrections response header (-parse-strict refuses instead), a missing or unknown country word becomes any, aliases are mapped (uk to gb), so verify the exit country on first use. Full contract: /pool/skill.md.

FIRST PROMPT TO TRY

pool_build_proxy_url in MCP 3.2 defaults to any when pool is omitted. The reseller SDK defaults to mbl. Always pass the selected pool explicitly in either interface.

"Get my Pool Gateway credentials, check which countries have stock, and build me a sticky US proxy URL with session id run42."

The assistant calls pool_get_my_credentials → pool_get_stock and assembles http://psx_...-peer-us-rot-sticky-sid-run42:PASSWORD@gw.proxies.sx:7000, ready to paste into curl, Playwright or any HTTP client.

"Rent a US Private modem for a week. Show me the price first."

The assistant calls proxies_modem_catalog → proxies_modem_quote, asks you to confirm the amount, then proxies_modem_buy with that expectedPriceUsd and confirm: true, and reads the HTTP and SOCKS5 credentials with proxies_modem_mine. The key needs the modems:purchase scope.

LINKS

ResourceURL
npm packagenpmjs.com/package/@proxies-sx/mcp-server
Source (MIT)github.com/bolivian-peru/proxies-sx-mcp-server
Glama listingglama.ai/mcp/servers/bolivian-peru/proxies-sx-mcp-server
Official MCP registry nameio.github.bolivian-peru/proxies-sx-mcp-server
Framework integrations (no MCP)/integrations/
Pool Gateway contract/pool/skill.md
Private modems contract/modems/skill.md
Hosted endpoint (Streamable HTTP)https://api.proxies.sx/mcp

FAQ

Do I need an account to use the Proxies.sx MCP server?

No. Set PROXIES_API_KEY for the standard account path (API key + deposited GB), or set AGENT_WALLET_KEY and the server pays per purchase with USDC on Base via x402 - no account, no API key. The hosted server at https://api.proxies.sx/mcp lists the 5 public tools without a key.

Which MCP clients does it work with?

Any client that speaks the Model Context Protocol over stdio (npx) or Streamable HTTP (the hosted https://api.proxies.sx/mcp): Claude Desktop, Claude Code, Cursor, Windsurf and others. The config block is the same shape everywhere.

How many tools are there and what do they cover?

96 tools with an API key in v3.2.0, 20 of them listed by default and all with --toolset=full: Private modems, Pool Gateway stock, credentials, proxy URLs and pool access keys, Private Pools and Reserved IPs, dedicated ports, IP rotation, status checks, billing, card top-up and crypto payments, support tickets, x402 sessions and an ops group for staff keys. Wallet mode has 16 x402 tools of its own. Nearly every tool maps to a documented https://api.proxies.sx/v1 endpoint.

Can the MCP server rent a Private modem?

Yes, with an API key that has the modems:purchase scope: proxies_modem_catalog lists the plans, proxies_modem_quote checks the price, and proxies_modem_buy rents one whole 4G/5G modem by the day, week or month with unlimited traffic, paid from the balance. It needs expectedPriceUsd and confirm: true, set only after the user agreed to the amount; proxies_modem_mine returns the credentials.