convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
bolivian-peru

Proxies.sx MCP Server

bolivian-peru/proxies-sx-mcp-server

Proxies móveis para agentes de IA com pagamento autônomo on-chain

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que permite agentes de IA comprar e gerenciar proxies móveis/residenciais autonomamente. Oferece 61 ferramentas para criar portas, rotacionar IPs, comprar tráfego e suporte via chave API ou pagamentos x402 em USDC (Base/Solana).

Instalação

$npx convez-ai bolivian-peru/proxies-sx-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 2 semanas
Versão
—
Issues abertas
0
Contribuidores
5

Casos de uso

  • Agentes de IA rotacionando IPs automaticamente em operações
  • Compra programática de acesso a proxies em múltiplos países
  • Automação de gerenciamento de pool de proxies DSL
  • Pagamentos autônomos em USDC sem conta prévia (x402)

Veredito

Ferramenta especializada para agentes que precisam de acesso a proxies móveis reais com pagamento autônomo. Bem documentada e testada em produção, mas nicho — ideal para operações que requerem rotação de IP genuína de carrier.

README

A tradução para o português deste README ainda está na fila.

🛰️ @proxies-sx/mcp-server

The Model Context Protocol server that lets AI agents buy and run mobile proxies — by themselves.

npm version License: MIT MCP tools x402

Quickstart · Two modes · Tool catalog · x402 · Docs · AI hub


Give Claude (or any MCP client) the keys to a real mobile-proxy network: create ports, rotate IPs, buy traffic, check status, open support tickets — all through natural language. Two ways to pay: a normal API key, or x402 so an agent pays USDC on-chain with no account at all.

You:  "Get me a US mobile proxy with 2 GB and rotate the IP."
Claude → x402_get_proxy(country=US, trafficGB=2)  →  pays $8 USDC on Base  →  returns live creds
Claude → x402_rotate_ip()                          →  fresh carrier IP

You:  "Buy me pool access so I can hit any country with one credential."
Claude → x402_get_pool_access(traffic_gb=5)        →  pays $20 USDC  →  one DSL credential

Mobile proxies, metered honestly. Real 4G/5G carrier IPs across 6+ countries. $4 / GB, metered, GB never expires. Duration is always free — you only pay for data. (The legacy private/dedicated tier was removed.)


👥 Two audiences — pick your door

You are…You want to…Use
An AI agent / developer / buyerBuy and operate proxies programmaticallyThis MCP server (or the REST API)
A device owner / farmerEarn by sharing bandwidth from phonesThe Peer SDK → agents.proxies.sx/peer

This server is the buyer / consumer side. Farming and peer registration is a separate flow with its own SDK — see the peer hub above. (No peer-registration tools live here by design.)


⚡ 30-second quickstart

# No install needed — just run it
npx @proxies-sx/mcp-server

Then drop it into your MCP client. For Claude Desktop, edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "proxies-sx": {
      "command": "npx",
      "args": ["-y", "@proxies-sx/mcp-server"],
      "env": {
        // Pick ONE mode (see below)
        "PROXIES_API_KEY": "psx_your_api_key_here"
        // — or — autonomous on-chain payments:
        // "AGENT_WALLET_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Restart Claude Desktop → you'll see 61 tools available. Works the same in Cursor, Cline, Continue, or any MCP-compatible client.


🔑 Two ways to authenticate

Mode 1 — API key (you have an account)

  1. Log in to client.proxies.sx → Account → API Keys.
  2. Create a key with the scopes you need: ports:read ports:write ports:rotate billing:read billing:write account:read traffic:read.
  3. Set PROXIES_API_KEY=psx_….

Best for: existing customers, dashboards, scripts, persistent automation.

Mode 2 — x402 (no account, the agent pays on-chain) 🤖

  1. Create a wallet on Base or Solana.
  2. Fund it with USDC (min $0.40 for 0.1 GB) + a few cents of ETH/SOL for gas.
  3. Set AGENT_WALLET_KEY=<private key>.

The agent now buys proxies autonomously — it signs a USDC payment, the server verifies it on-chain (~2 s on Base, ~400 ms on Solana), and returns live credentials. No signup, no card, no human.

VariableModeRequiredDefault
PROXIES_API_KEYAPI keyyes (this mode)—
AGENT_WALLET_KEYx402yes (this mode)—
PROXIES_API_URLbothnohttps://api.proxies.sx/v1

🧰 Tool catalog (61 tools)

ToolWhat it does
get_account_summaryBalance, email, slot & traffic usage
get_account_usageTraffic breakdown by category
get_pricingLive pricing — $4/GB, metered, volume discounts
calculate_pricePrice a GB amount with volume discount applied
purchase_shared_trafficBuy GB from balance (also raises your free slot tier)
purchase_private_trafficLegacy buy-GB tool (still accepted by the API; price is metered $4/GB)
ToolWhat it does
list_portsAll ports with filters (type, status, location)
get_portFull detail for one port
create_portNew port in a country (optional carrier/city)
reconfigure_portMove a port to a new country/carrier/city
update_port_credentialsChange a port's login/password
update_os_fingerprintp0f OS spoofing for a port
delete_portRemove a port
ToolWhat it does
get_port_status · get_port_ip · ping_port · speed_test_portOnline check, current IP, latency, speed
get_proxy_connection_string · get_all_proxy_formatsReady-to-paste HTTP/SOCKS5 strings, every common format
get_os_fingerprint_options · list_available_countriesSpoofing options, live country availability
ToolWhat it does
rotate_portSwap to a new modem/IP, keep credentials
check_rotation_availabilityCooldown / circuit-breaker check
configure_auto_rotationAuto-rotate every N minutes
get_rotation_history · get_rotation_token_urlAudit trail · public no-auth rotate URL
ToolWhat it does
create_crypto_payment · check_crypto_payment_statusOpen a hosted crypto order · poll it
get_pending_crypto_payments · cancel_crypto_payment · get_crypto_payment_infoManage pending orders, supported coins

create_support_ticket · list_my_tickets · get_ticket · reply_to_ticket · close_ticket

ToolWhat it does
get_x402_session · list_x402_ports · get_x402_port_statusSession detail, all ports, per-port status
get_sessions_by_wallet · get_session_statusRecover sessions by wallet · quick status
replace_x402_portSwap an offline port to a new device — free, max 3/session
calculate_x402_topup · topup_x402_sessionPreview top-up · pay USDC to add traffic/duration
ToolWhat it does
x402_get_proxyBuy a dedicated proxy with USDC on-chain — returns creds + session token
x402_get_pricingQuote a purchase ($4/GB metered, duration free)
x402_wallet_balanceUSDC balance + wallet address
x402_rotate_ipFree IP rotation via rotation token
x402_list_sessions · x402_check_sessionList / inspect your wallet's sessions
x402_list_countries · x402_list_cities · x402_list_carriersLive geo + carrier targeting
x402_service_statusHealth check

To extend a dedicated-port session, use the session-management calculate_x402_topup / topup_x402_session tools.

ToolWhat it does
x402_get_pool_accessBuy Pool Gateway access with USDC — one DSL credential reaches every country in your tier. v1 = mbl ($4/GB, production modems), HTTP :7000
x402_pool_creditRemaining GB on the pool session (cached token if omitted)
x402_pool_topupPay USDC for more GB (duration-only is free)
x402_pool_regenerateRotate the credential secret (same username, new password)
x402_pool_connectionRe-emit credentials (recovery)
x402_pool_pricingTier catalog + username DSL (no auth)
get_pool_stockPublic online endpoint counts per country (no IPs)

One credential, every country: psx_xxx-mbl-us, psx_xxx-mbl-de, … via the username DSL. Sticky pins the modem, not the IP — carrier NAT may still re-issue the egress IP.


💸 x402 — autonomous on-chain payments

x402 revives HTTP 402 Payment Required for the agent economy. Your agent requests a proxy, gets a price, signs a USDC transfer, and retries with the transaction — the server verifies on-chain and provisions instantly.

agent ──▶ x402_get_proxy(US, 2GB)
          │  402 Payment Required → pay $8 USDC
          ▼
   Base (eip155:8453)  or  Solana   ──▶  on-chain verify  ──▶  live proxy creds + session token
  • Pricing: $4 / GB, metered (the legacy private/dedicated tier was removed). Duration is free. Min $0.40.
  • Networks: Base (USDC, ~2 s) and Solana (USDC, ~400 ms).
  • No account, no card, no human. The wallet is the identity.
  • Pool Gateway access: buy one credential that reaches every country in your tier with x402_get_pool_access (v1 mbl tier, $4/GB).

Build agents directly on the protocol with the open-source SDK: @proxies-sx/x402-core, @proxies-sx/x402-hono, @proxies-sx/x402-solana.


📚 Recipes & deeper docs


🛠️ Install options

npx @proxies-sx/mcp-server          # zero-install (recommended)
npm i -g @proxies-sx/mcp-server     # global → `proxies-sx-mcp`
npm i @proxies-sx/mcp-server        # local dependency

From source:

git clone https://github.com/bolivian-peru/proxies-sx-mcp-server
cd proxies-sx-mcp-server && npm install && npm run build && npm start

Verify: npx @proxies-sx/mcp-server --version (it should report 61 tools available).


🤝 Contributing & support

Issues and PRs welcome. Need a human? Use the create_support_ticket tool, or reach the team at client.proxies.sx. Licensed MIT.

Ver o original no GitHub

Bom para

Relacionados