Proxies Sx MCP server

@proxies-sx/mcp-server

MCP (Model Context Protocol) server for Proxies.sx: residential and mobile proxies for AI agents, metered per GB. Claude, Cursor and any MCP client can get rotating or sticky HTTP/SOCKS5 proxy URLs, check live stock per country, rotate IPs and manage usage by themselves, for web scraping, data collection and browser automation.

The main product is the Pool Gateway: one endpoint, gw.proxies.sx (HTTP 7000, SOCKS5 7001), where the proxy username says which pool, country and session you want. With this server an agent reads live stock, gets its credentials, builds the proxy URL, watches usage and opens a support ticket when something is wrong. It can also manage dedicated ports on carrier modems, Private Pools and Reserved IPs.

Every tool carries MCP annotations (readOnlyHint, destructiveHint), so a client can ask before a delete, rotate or cancel.

Quick start

1. Create an API key at client.proxies.sx/account and add traffic (GB) at client.proxies.sx/purchase.
2. Add the server to your client. Claude Code:

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

1. Ask for a proxy:

Check Pool Gateway stock for Germany, then give me a sticky residential proxy URL there.

The agent calls poolgetstock, poolgetmycredentials and poolbuildproxyurl and answers with a URL such as http://psx_abc123-peer-de-iptype-residential-sid-job1-rot-sticky:PASSWORD@gw.proxies.sx:7000.

API key scopes

A customer key can hold: ports:read, ports:write, ports:rotate, billing:read, account:read, account:write, traffic:read, tickets:read, tickets:write. Select all of them for the full customer tool set.

• billing:write is not available to customer keys. The tools that need it (purchasesharedtraffic, createcryptopayment, cancelcryptopayment) work with reseller and admin keys only; a customer buys traffic in the dashboard.
• The pak key tools (poolmintkey and the other poolkey tools) need a reseller account, whose keys hold customers:read and customers:write.
• The ops tools answer only to admin keys with ops: scopes.

Pool Gateway rules

The username grammar is psx--[-token-value ...]. poolbuildproxyurl writes it for you; these are the rules behind it.

Shortened. The full README is on GitHub.