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.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.
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
| Mode | Env var | Who it is for | How it pays |
|---|---|---|---|
| API key (standard) | PROXIES_API_KEY=psx_... | Anyone with an account - mint the key at client.proxies.sx/account | Deposited 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 Base | Per 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.
~/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/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" }
}
}
}
~/.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 mcp add proxies-sx -e PROXIES_API_KEY=psx_your_api_key_here -- npx -y @proxies-sx/mcp-server
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" }
}
}
}
| Group | Tools | What it does | Examples |
|---|---|---|---|
| Private modems | 6 | Rent 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 Gateway | 19 | Your gateway credential, live stock and facets per country, build a proxy URL from the username DSL, explain a gateway error, sessions, reseller pool-access keys | pool_get_my_credentials, pool_get_stock, pool_build_proxy_url, pool_explain_error, pool_mint_key |
| Private Pool and Reserved IPs | 10 | Separate credentials per project, devices reserved for you alone | private_pool_build, reserved_ip_reserve |
| Dedicated ports | 9 | Dedicated modem ports: countries with a free modem, create, inspect, extend, reconfigure, delete | list_available_countries, create_port, extend_port |
| Rotation | 5 | Rotate a port's IP, schedule auto-rotation, read history | rotate_port, configure_auto_rotation |
| Status | 4 | Port health, server address, ping, speed test | get_port_status, ping_port |
| Billing | 6 | Pricing, quotes, coupons, payment history; buying GB from balance needs a reseller or admin key | get_pricing, coupon_redeem, get_payment_history |
| Payments | 7 | Card 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 key | proxies_topup_checkout, proxies_topup_status, check_crypto_payment_status |
| Support | 5 | Open, read, reply to and close tickets | create_support_ticket |
| x402 sessions | 8 | Inspect and top up wallet-bought sessions | get_x402_session, topup_x402_session |
| Account | 2 | Balance, GB left, usage | get_account_summary |
| Utilities | 4 | Connection strings in every client format, service status | get_all_proxy_formats, get_service_status |
| Ops | 11 | Staff-scoped keys only: customer 360, tickets, credits, farmer notes | ops_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.
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.
| Resource | URL |
|---|---|
| npm package | npmjs.com/package/@proxies-sx/mcp-server |
| Source (MIT) | github.com/bolivian-peru/proxies-sx-mcp-server |
| Glama listing | glama.ai/mcp/servers/bolivian-peru/proxies-sx-mcp-server |
| Official MCP registry name | io.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 |
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.
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.
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.
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.