プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Proxies Sx MCP Server

作者:bolivian-peruバージョン 3.2.0i★ 0iパソコンでもクラウドでも公式サイト ↗
レジストリ名io.github.bolivian-peru/proxies-sx-mcp-server

インストール方法

What it does

Residential and mobile proxies and Private modems for AI agents: proxy URLs, stock, rotation, top-up

  • Connects パソコンでもクラウドでも
  • Account or key Cloud: Works without a key · add Authorization if you have one (often raises limits) · Local: Needs PROXIES_PASSWORD
  • Category その他

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア20/100

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Proxies Sx MCP Server をインストールして。https://mcp.popnx.com/i/bolivian-peru-proxies-sx-mcp-server.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(api.proxies.sx)を通ります · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前Proxies Sx MCP Server
    Remote MCP server URL · アドレスhttps://api.proxies.sx/mcp

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsProxies Sx MCP Server

  4. 試してみる

    Proxies Sx MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Proxies Sx MCP Server を使っていると言うか、回答に Proxies Sx MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前Proxies Sx MCP Server
    Connection · アドレスhttps://api.proxies.sx/mcp
  3. チャットで Proxies Sx MCP Server を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から Proxies Sx MCP Server を選びます

  4. 試してみる

    Proxies Sx MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が Proxies Sx MCP Server を使っていると言うか、回答に Proxies Sx MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user proxies-sx https://api.proxies.sx/mcp
  3. Claude Code で /mcp と入力

    Proxies Sx MCP Server が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    Proxies Sx MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Proxies Sx MCP Server を使っていると言うか、回答に Proxies Sx MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    Proxies Sx MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Proxies Sx MCP Server を使っていると言うか、回答に Proxies Sx MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    Proxies Sx MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Proxies Sx MCP Server を使っていると言うか、回答に Proxies Sx MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://api.proxies.sx/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?Proxies Sx MCP Server を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user proxies-sx https://api.proxies.sx/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "proxies-sx": {
      "url": "https://api.proxies.sx/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "proxies-sx": {
      "type": "http",
      "url": "https://api.proxies.sx/mcp"
    }
  }
}

パソコンにインストール

Claude Code

claude mcp add --scope user proxies-sx --env PROXIES_PASSWORD=your-value -- npx -y @proxies-sx/mcp-server --toolset default

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "proxies-sx": {
      "command": "npx",
      "args": [
        "-y",
        "@proxies-sx/mcp-server",
        "--toolset",
        "default"
      ],
      "env": {
        "PROXIES_PASSWORD": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "proxies-sx": {
      "command": "npx",
      "args": [
        "-y",
        "@proxies-sx/mcp-server",
        "--toolset",
        "default"
      ],
      "env": {
        "PROXIES_PASSWORD": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "proxies-sx": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@proxies-sx/mcp-server",
        "--toolset",
        "default"
      ],
      "env": {
        "PROXIES_PASSWORD": "your-value"
      }
    }
  }
}

自分で入力する値

  • PROXIES_API_KEY 秘密 env
    client.proxies.sx/account で作成する psx_ API キー(標準モード)。モデムおよびチャージのツールには modems:purchase と billing:topup のスコープを有効にする。x402 ウォレットモードでは任意
    英語の原文を見るpsx_ API key created at client.proxies.sx/account (standard mode). Tick the modems:purchase and billing:topup scopes for the modem and top-up tools. Optional when using x402 wallet mode.
  • PROXIES_EMAIL env
    アカウントのメールアドレス。PROXIES_API_KEY の代わりに、PROXIES_PASSWORD と併用します。
    英語の原文を見るAccount email, an alternative to PROXIES_API_KEY together with PROXIES_PASSWORD.
  • PROXIES_PASSWORD 秘密 必須 env
    アカウントのパスワード。API キーの代わりに PROXIES_EMAIL と併用します。
    英語の原文を見るAccount password, used with PROXIES_EMAIL instead of an API key.
  • PROXIES_TOOLSET env
    default は buy / use / manage に分類された約 20 個のツールを一覧表示します。full は API キーを必要とするすべてのツールを一覧表示します。--toolset=full 引数と同じです。
    英語の原文を見るdefault lists about 20 tools grouped by buy / use / manage; full lists every API-key tool. Same as the --toolset=full argument.
  • AGENT_WALLET_KEY 秘密 env
    Base ネットワーク上の USDC ウォレットの秘密鍵 (0x...)。任意の x402 ウォレットモード用です(アカウントは不要)。
    英語の原文を見るPrivate key (0x...) of a USDC wallet on the Base network, for the optional x402 wallet mode (no account needed).
  • BASE_RPC_URL env
    x402 ウォレットモード用のカスタム Base RPC エンドポイント。
    英語の原文を見るCustom Base RPC endpoint for the x402 wallet mode.
  • PROXIES_API_URL env
    API のベース URL。末尾の /v1 は使用可能。プライベート API を使用する場合を除き、未設定のままにしてください。
    英語の原文を見るAPI base URL. A trailing /v1 is accepted. Leave unset unless you run a private API.
  • Authorization 秘密 HTTP header
    Bearer psx_ API キー。https://client.proxies.sx/account から取得します。キーがない場合は公開ツールのみ表示されます。
    英語の原文を見るBearer psx_ API key from https://client.proxies.sx/account. Without it only the public tools are listed.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
182/週
接続方法
パソコンでもクラウドでも
最新バージョンi
3.2.0
カテゴリi
その他
レジストリ公開日i
2026年10月30日
コードの最終更新i
2026年11月19日
最終確認
2026年11月17日
作者
bolivian-peru
パッケージ
npm: @proxies-sx/mcp-server
ウェブサイト
agents.proxies.sx
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月17日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • pool_get_stock

    Get live Pool Gateway stock, no account needed. With a country: the mbl and peer endpoint counts there and the peer counts per class (mobile, residential, isp). Without: totals plus the count per country for both pools. Use it to pick a pool and country before pool_build_proxy_ur

  • pool_get_facets

    List the cities, states, carriers (with ASN and class) and IP classes that have stock in one country, with counts, no account needed. The values are the ones pool_build_proxy_url accepts for city, state, carrier and asn. Pass city, state or carrier to see what remains once that f

  • pool_build_proxy_url

    Build a ready-to-use Pool Gateway proxy URL (gw.proxies.sx, HTTP 7000 or SOCKS5 7001). Local, no network. Take proxyUsername and password from pool_get_my_credentials (a reseller passes a customer pak_ key as password). pool: "peer" is the main network (residential and mobile, mo

  • pool_explain_error

    Explain a Pool Gateway error and say what to do about it. Pass the error text your HTTP client got from gw.proxies.sx (it looks like "E_NO_STOCK_COUNTRY: ... (req: ...)") or just the code. Covers E_AUTH_INVALID, E_BALANCE_EXHAUSTED, E_NO_STOCK_COUNTRY, the rate and session limits

  • get_service_status

    Check whether Proxies.sx is healthy right now: open Pool Gateway incidents, the state of the API, gateway and relay, and recent uptime. No account needed. Call it when requests fail with 5xx or E_INTERNAL before retrying in a loop.

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント bolivian-peru で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • ✓ 合格

    エンドポイントが応答する

    917ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    5件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

公開済みの脆弱性(OSV.dev)

OSV.dev に @proxies-sx/mcp-server@3.2.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/bolivian-peru-proxies-sx-mcp-server.svg)](https://mcp.popnx.com/en/servers/bolivian-peru-proxies-sx-mcp-server)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

その他のほかのサーバーとの比較i

  • このカテゴリのほかの20815件のうち0%よりスターが多い
  • このカテゴリのほかの20815件のうち68%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの20815件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Proxies Sx MCP Serverは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:PROXIES_PASSWORD

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(3.2.0)がレジストリに届いたのは21 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

作者:koala73広く使われている★ 9.1万4 日前更新

クラウドで動く✓ 提供元 · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

作者:openstatusHQ広く使われている★ 92762 か月前更新

クラウドで動く✓ 提供元 · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

作者:JanDeDobbeleer広く使われている★ 2.4万 リポジトリ全体のスター31 日前更新

クラウドで動く✓ 提供元 · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

作者:Klavis-AI成長中★ 582414 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

作者:jitsucom広く使われている★ 51364 か月前更新

クラウドで動く✓ 提供元 · jitsu.com
似たものと比べる
これ
Proxies Sx MCP Server
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
動く場所クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック5/54/44/44/41/44/4
ライセンスMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

@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. For a dedicated, unlimited-traffic device it rents a Private modem (one 4G/5G modem, by the day, week or month) and tops up the balance by card through a link a person pays. 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, cancel or purchase. Private modem purchases and renewals require the quoted price and confirm: true. Wallet-mode x402 tools can authorize payments from the configured local wallet.

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

Or install it as a Claude Code plugin, which connects to the hosted server below, adds the Proxies.sx skill and asks for your API key once (stored masked in secure storage):

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

/plugin install proxies-sx@proxies-sx

Or connect to the hosted server, with nothing to install: https://api.proxies.sx/mcp (Streamable HTTP). Send the key as Authorization: Bearer psx_...; without a key only the public tools are listed (stock, proxy URL format, error help, service status).

claude mcp add --transport http proxies-sx https://api.proxies.sx/mcp --header "Authorization: Bearer psx_your_api_key_here"
{ "mcpServers": { "proxies-sx": { "url": "https://api.proxies.sx/mcp", "headers": { "Authorization": "Bearer psx_your_api_key_here" } } } }

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.

  1. Ask for a proxy:

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

The agent calls pool_get_stock, pool_get_my_credentials and pool_build_proxy_url 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. Two opt-in scopes are never in the default set and must be ticked on purpose: modems:purchase (proxies_modem_buy, proxies_modem_renew) and billing:topup (proxies_topup_checkout, proxies_topup_status; each key has a daily top-up cap, spendCapUsdPerDay, default 100 USD, set in the dashboard).

  • billing:write is not available to customer keys. The tools that need it (purchase_shared_traffic, create_crypto_payment, cancel_crypto_payment) work with reseller and admin keys only; a customer buys traffic in the dashboard.
  • The pak_ key tools (pool_mint_key and the other pool_*_key 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 ...]. pool_build_proxy_url writes it for you; these are the rules behind it.

  • Two pools. peer is the main network: residential and mobile devices in most countries. mbl is carrier modems in exactly six countries: US, GB, FR, NL, PL and GE. GE is Georgia, not Germany, so mbl-de never works: use peer-de. any and best let the gateway choose. pool_get_stock shows what is online now.
  • IP class. -iptype-mobile, -iptype-residential or -iptype-isp. The ISP (static) class is addresses on ISP-registered networks hosted on servers; it is served only when you name it.
  • Rotation. sticky and hard both hold one device. auto5, auto10, auto20 and auto60 move to another device on that interval (auto10 is the default). ondemand picks again on each new connection.
  • Sessions need `-sid-`. sticky, hard and auto* only persist across connections when the username carries -sid- (lowercase letters, digits and _). -session- is not a token: the gateway ignores it without an error.
  • Sticky holds the device, not the IP. A mobile carrier can change the exit IP of a held modem. For an address that stays, use a residential peer or a Reserved IP.
  • Limits per account: 500 concurrent connections and 250 sessions.
  • Price: Account balance is bought in GB. The serving exit country determines how much balance a GB of Pool Gateway traffic consumes. Read the current tiers and volume discounts in the pricing API. Capped keys and wallet purchases meter one GB per GB of traffic.
  • Proxy password. The gateway password is the account's proxy password (pool_get_my_credentials), or a pak_ key. It is not the account login password.
Gateway errors

The gateway answers a failed request with CODE: message (req: id). pool_explain_error turns any of them into what to do next.

CodeStatusMeaning
E_AUTH_REQUIRED407no proxy credentials sent
E_AUTH_INVALID407username or proxy password rejected
E_BALANCE_EXHAUSTED407credentials are right, the account has no traffic left
E_CAP_EXCEEDED407a pak_ key reached its GB cap
E_RATE_LIMITED_AUTH429too many failed logins
E_RATE_LIMITED_CONN429over the connection limit
E_SESSION_LIMIT429over the session limit
E_NO_STOCK_COUNTRY502nothing online for that pool, country and filters
E_STOCK_DEGRADED502the device went away during the request
E_SSRF_BLOCKED403target is a private or metadata address
E_WRONG_PORT400HTTP sent to the SOCKS5 port, or the reverse
E_INTERNAL503unexpected gateway error

A tool that fails returns an MCP error result (isError: true) whose text ends with a What to do: line for the common cases: a missing or revoked API key, a missing scope, a rate limit, a server error. Keys and passwords are masked in error text.

Modes and configuration

ModeSetTools
PublicNo credentials5 tools on either transport
API keyPROXIES_API_KEY locally, or a bearer key on the hosted server20 by default, 96 with the full toolset
x402 wallet (optional)AGENT_WALLET_KEY21 locally, including 5 public tools and 16 wallet tools
Bothboth variables36 by default, 112 with the full toolset (local only)
Toolsets

With an API key the default toolset lists 20 tools, grouped by what an agent does: buy (proxies_modem_catalog, proxies_modem_quote, proxies_modem_buy, proxies_modem_renew, proxies_topup_checkout, proxies_topup_status, get_pricing), use (pool_get_stock, pool_get_my_credentials, pool_build_proxy_url, pool_explain_error, proxies_modem_mine, proxies_modem_rotate) and manage (get_account_summary, get_account_usage, pool_set_proxy_password, get_service_status, create_support_ticket, list_my_tickets, get_ticket). The key’s scopes determine which account tools it can use.

Everything else (dedicated ports, Private Pools and Reserved IPs, crypto orders, coupons, pak_ keys, x402 session management, ops) is listed with the full toolset:

npx -y @proxies-sx/mcp-server --toolset=full      # or PROXIES_TOOLSET=full in the environment

The wallet tools are not affected by the toolset: they are always listed when AGENT_WALLET_KEY is set. The tool tables below mark the default tools.

VariableDescription
PROXIES_API_KEYpsx_ API key from client.proxies.sx/account
PROXIES_EMAIL, PROXIES_PASSWORDAlternative to the API key: log in with the account credentials
AGENT_WALLET_KEYPrivate key (0x...) of a USDC wallet on the Base network, for x402 payments without an account
BASE_RPC_URLCustom Base RPC endpoint, for x402 (default https://mainnet.base.org)
PROXIES_API_URLAPI base URL. Default https://api.proxies.sx; a trailing /v1 is accepted and ignored. Leave it unset unless you run a private API.
PROXIES_TOOLSETWith an API key, default lists 20 tools and full lists 96. The --toolset=full argument does the same.

Usage with MCP clients

The examples below start the local stdio server with npx -y @proxies-sx/mcp-server. Clients that support Streamable HTTP can instead connect to https://api.proxies.sx/mcp.

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

Add -s user to make it available in every project. A project can instead carry a .mcp.json in its root with the JSON below.

Claude Desktop

Add to ~/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

The same JSON in ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project).

Windsurf

The same JSON in ~/.codeium/windsurf/mcp_config.json.

Docker
docker build -t proxies-sx-mcp https://github.com/bolivian-peru/proxies-sx-mcp-server.git

docker run -i --rm -e PROXIES_API_KEY=psx_your_api_key_here proxies-sx-mcp

The container speaks MCP over stdio (-i is required).

More recipes

recipes/ has working examples for LangChain, CrewAI and a raw MCP client.

Tools

Generated from the code of version 3.2.0 by npm run build:manifest. Do not edit by hand.

With an API key, the 20 tools marked "Default" are listed without a flag. Other account tools need --toolset=full (or PROXIES_TOOLSET=full). 5 tools are listed without credentials. A local wallet adds 16 wallet tools.

Pool Gateway

ToolWhat it does
pool_get_stockGet live Pool Gateway stock, no account needed. Default. Also listed in wallet mode.
pool_get_facetsList the cities, states, carriers (with ASN and class) and IP classes that have stock in one country, with counts, no account needed. Also listed in wallet mode.
pool_build_proxy_urlBuild a ready-to-use Pool Gateway proxy URL (gw.proxies.sx, HTTP 7000 or SOCKS5 7001). Default. Also listed in wallet mode.

| `

冒頭だけを表示しています。続きはリポジトリで読めます