PROXIES.SX MCP SERVER

70 tools that let Claude, Cursor, Windsurf, Claude Code - any MCP client - buy, configure and use mobile and residential proxies without leaving the chat. One npx command, two auth modes, nearly every tool backed by a documented api.proxies.sx/v1 endpoint.

70 tools

v2.4.1 on npm

2 auth modes

LIVE

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

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.

TWO AUTH MODES

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/api-keys	Deposited GB on the account, $4/GB to $2.40/GB at 250 GB+
x402 wallet (optional)	`AGENT_WALLET_KEY=0x...`	Account-less agents holding USDC on Base or Solana	Per purchase, on-chain, HTTP 402 flow - no signup

Set one or both: with both, hybrid mode exposes the 70 API-key tools plus the 19 wallet-only x402 tools. With an API key you get the full 70-tool set; a wallet-only agent gets the x402 purchase and session tools instead. PROXIES_API_URL is optional (default https://api.proxies.sx/v1).

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 (70)

Group	Tools	What it does	Examples
Pool Gateway	16	Your gateway credential, live stock per country, build a proxy URL from the username DSL, sessions, reseller pool-access keys	`pool_get_my_credentials`, `pool_get_stock`, `pool_build_proxy_url`, `pool_mint_key`
Ports	7	Dedicated modem ports: create, inspect, reconfigure, delete	`list_ports`, `create_port`
Rotation	5	Rotate a port's IP, schedule auto-rotation, read history	`rotate_port`, `configure_auto_rotation`
Status	4	Port health, current exit, ping, speed test	`get_port_status`, `ping_port`
Billing	3	Pricing, quotes, buy GB from balance	`get_pricing`, `purchase_shared_traffic`
Payments	5	Crypto deposits and their status	`create_crypto_payment`
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	3	Connection strings in every client format	`get_all_proxy_formats`
Reference	1	Countries with live stock	`list_available_countries`
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 dropped silently. Full contract: /pool/skill.md.

FIRST PROMPT TO TRY

"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.

LINKS

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

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 or Solana via x402 - no account, no API key.

Which MCP clients does it work with?

Any client that speaks the Model Context Protocol over stdio: Claude Desktop, Claude Code, Cursor, Windsurf and others. The server is a plain npx command, so the config block is the same shape everywhere.

How many tools are there and what do they cover?

70 tools in v2.4.1: Pool Gateway credentials and pool access keys, dedicated ports, IP rotation, status checks, billing and crypto payments, support tickets, x402 sessions and an ops group for staff keys. Nearly every tool maps to a documented https://api.proxies.sx/v1 endpoint.