PROXIES.SX

Mobile proxy infrastructure for AI agents. Pay with USDC on-chain. No API keys needed.
69 endpoints
55 MCP tools
4 npm packages
6 live domains

Master Skill File: agents.proxies.sx/skill.md — everything in one read for AI agents

x402 PAYMENT PROTOCOL

HTTP 402 Payment Required for machine-to-machine USDC payments. No accounts, no API keys.

How It Works

1. Request without payment    GET /v1/x402/proxy?country=US&traffic=1
2. Receive 402 response       price, recipient wallet, supported networks
3. Send USDC on-chain         Base (~2s) or Solana (~400ms)
4. Retry with payment proof   Payment-Signature: <tx_hash>
5. Receive proxy credentials  host, port, username, password, session token

Payment Networks

NetworkSettlementGasUSDC ContractRecipient
Base (EVM)~2 sec~$0.010x833589fCD6eDb6E08f4c7C32D4f71b54bdA029130xF8cD900794245fc36CBE65be9afc23CDF5103042
Solana~400ms~$0.0001EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v6eUdVwsPArTxwVqEARYGCh4S2qwW2zCs7jSEDRpxydnv

Pricing

TypePrice/GBMin PurchaseDuration
Shared$4.000.1 GB ($0.40)Free (unlimited)
Private$8.000.1 GB ($0.80)Free (unlimited)

Quick Start

# 1. Request proxy (receive 402 with payment info)
curl -s https://api.proxies.sx/v1/x402/proxy?country=US&traffic=1

# 2. After sending USDC, retry with tx hash
curl -s https://api.proxies.sx/v1/x402/proxy?country=US&traffic=1 \
  -H "Payment-Signature: YOUR_TX_HASH"

# 3. Check session
curl -s https://api.proxies.sx/v1/x402/manage/session \
  -H "X-Session-Token: x402s_YOUR_TOKEN"

# 4. Replace offline port (free, max 3)
curl -s -X POST https://api.proxies.sx/v1/x402/manage/ports/replace \
  -H "X-Session-Token: x402s_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"country":"US"}'

# 5. Top up session (pay for more traffic)
curl -s -X POST https://api.proxies.sx/v1/x402/manage/session/topup \
  -H "X-Session-Token: x402s_YOUR_TOKEN" \
  -H "Payment-Signature: NEW_TX_HASH" \
  -H "Content-Type: application/json" \
  -d '{"addTrafficGB":2,"addDurationSeconds":86400}'

All x402 Endpoints

MethodPathAuthDescription
GET/v1/x402/pricing-Pricing tiers and structure
GET/v1/x402/countries-Available countries with device counts
GET/v1/x402/calculate-Calculate cost
GET/v1/x402/health-Service health
GET/v1/x402/info-Master info (pricing, countries, MCP)
GET/v1/x402/.well-known-Protocol discovery
GET/v1/x402/proxyx402Purchase mobile proxy
POST/v1/x402/proxyx402Purchase mobile proxy (POST)
GET/v1/x402/manage/sessionTokenSession details via token
GET/v1/x402/manage/session/creditTokenCheck remaining credit
GET/v1/x402/manage/portsTokenList all ports in session
GET/v1/x402/manage/ports/:portId/statusTokenPort status
POST/v1/x402/manage/ports/replaceTokenReplace offline port (free, max 3)
POST/v1/x402/manage/ports/recreateTokenRecreate deleted port with remaining credit
GET/v1/x402/manage/session/topup/calculateTokenPreview top-up cost
POST/v1/x402/manage/session/topupToken+x402Pay to extend session
GET/v1/x402/session/:id-Session by ID
GET/v1/x402/session/tx/:txHash-Session by transaction hash
GET/v1/x402/sessions/wallet/:wallet-Sessions by wallet address
POST/v1/x402/agents-Register agent
GET/v1/x402/agents/:wallet-Get agent by wallet
GET/rotate/:token-Rotate IP via public token

Token = X-Session-Token: x402s_<hex> header. x402 = Payment-Signature: <tx_hash> header.

Post-Purchase Management

Port Replacement — If proxy goes offline, POST /manage/ports/replace for free replacement. Max 3 per session.
Session Top-Up  — Add traffic ($4/GB shared, $8/GB private) or duration (free). POST /manage/session/topup with Payment-Signature.
Port Recreation — If port deleted but session has credit, POST /manage/ports/recreate.
IP Rotation     — GET /rotate/:token to rotate IP without auth.

AGENT APIs

x402-gated endpoints at api.proxies.sx. Pay per request with USDC.

AgentEndpointPricePaymentStatus
Mobile Proxy GET /v1/x402/proxy $4.00/GB shared, $8.00/GB private USDC on Base or Solana LIVE
Google Maps Lead Gen GET /v1/x402/maps/run $0.005/record USDC on Base or Solana LIVE
Mobile SERP Tracker GET /v1/x402/serp $0.003/query USDC on Base or Solana LIVE
Reddit Intelligence GET /v1/x402/reddit/* $0.005-$0.01/query USDC on Base or Solana LIVE
Instagram Intelligence GET /v1/x402/instagram/* $0.01-$0.15/query USDC on Base or Solana LIVE
Airbnb Market Intel GET /v1/x402/airbnb/* $0.01-$0.05/query USDC on Base or Solana LIVE
LinkedIn Enrichment GET /v1/x402/linkedin/* $0.03-$0.10/query USDC on Base or Solana LIVE
+ 5 more See full marketplace — Jobs, Predictions, Reviews, Business Data LIVE

Mobile Proxy

Real 4G/5G proxy access from 6+ countries. HTTP and SOCKS5, city/carrier targeting, auto IP rotation.


MCP SERVER

@proxies-sx/mcp-server v2.0.0 — 55 tools for AI agents to manage proxy infrastructure via Model Context Protocol.

Install

npx -y @proxies-sx/mcp-server

Claude Desktop Config

// API Key mode (account required)
{
  "mcpServers": {
    "proxies-sx": {
      "command": "npx",
      "args": ["-y", "@proxies-sx/mcp-server"],
      "env": { "PROXIES_API_KEY": "psx_your_key" }
    }
  }
}

// x402 mode (no account needed)
{
  "mcpServers": {
    "proxies-sx": {
      "command": "npx",
      "args": ["-y", "@proxies-sx/mcp-server"],
      "env": { "AGENT_WALLET_KEY": "your_private_key", "PREFERRED_NETWORK": "base" }
    }
  }
}

Tool Categories (55 total)

CategoryCountKey Tools
Account2get_account_summary, get_account_usage
Port Mgmt7list_ports, create_port, delete_port, update_port_credentials, reconfigure_port
Port Status4get_port_status, get_port_ip, ping_port, speed_test_port
Rotation5rotate_port, configure_auto_rotation, get_rotation_history
Billing4get_pricing, calculate_price, purchase_shared_traffic, purchase_private_traffic
Crypto Pay5create_crypto_payment, check_crypto_payment_status
Support5create_support_ticket, list_my_tickets, reply_to_ticket
x402 Session8get_x402_session, replace_x402_port, calculate_x402_topup, topup_x402_session
x402 Auto11x402_get_proxy, x402_wallet_balance, x402_rotate_ip, x402_extend_session
Utilities4get_proxy_connection_string, list_available_countries

PEER MARKETPLACE — EARN USDC

Share your internet bandwidth, get paid in USDC on Solana. AI agents and humans connect via WebSocket, route traffic, earn automatically.

Earnings by IP Type

IP TypeRate TierExamples
MobileHighestAT&T, Verizon, T-Mobile, Vodafone
ResidentialMidComcast, Spectrum, Cox, BT
DatacenterBaseAWS, GCP, Azure, Hetzner, VPNs

Per-GB earnings accumulate automatically. IP type determined server-side via ASN lookup. Min payout: $5 USDC.

How It Works

1. Register     POST /v1/peer/agents/register — get JWT + device ID
2. Connect      wss://relay.proxies.sx with Sec-WebSocket-Protocol: token.{JWT}
3. Route        Handle proxy_request messages, send proxy_response back
4. Earn         Earnings credited per GB. Request payout min $5 USDC to Solana wallet.

Register

curl -s -X POST https://api.proxies.sx/v1/peer/agents/register \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","type":"claude","walletAddress":"YOUR_SOLANA_ADDRESS"}'

# Response:
# { "deviceId": "agent_abc123", "jwt": "eyJ...", "refreshToken": "a1b2...",
#   "relay": "wss://relay.proxies.sx",
#   "earningsPerGB": { "mobile": 0.25, "residential": 0.15, "datacenter": 0.02 } }

Connect to Relay

const ws = new WebSocket('wss://relay.proxies.sx', [`token.${JWT}`]);

ws.onopen = () => {
  ws.send(JSON.stringify({ type: 'device_info', payload: { country: 'US' } }));
};

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  if (msg.type === 'proxy_request') {
    const { requestId, method, url, headers, body } = msg.payload;
    fetch(url, { method, headers, body: body ? atob(body) : undefined })
      .then(async (res) => {
        const buf = await res.arrayBuffer();
        ws.send(JSON.stringify({
          type: 'proxy_response',
          payload: { requestId, statusCode: res.status,
                     headers: Object.fromEntries(res.headers),
                     body: btoa(String.fromCharCode(...new Uint8Array(buf))) }
        }));
      });
  }
  if (msg.type === 'heartbeat') ws.send(JSON.stringify({ type: 'heartbeat_ack' }));
};

Peer API Endpoints

MethodEndpointAuthDescription
POST/v1/peer/agents/register-Register as peer (3/min rate limit)
POST/v1/peer/agents/:id/refreshRefreshRefresh JWT (expires 1h)
GET/v1/peer/agents/:id/statusJWTPeer status
GET/v1/peer/agents/:id/earningsJWTEarnings and traffic stats
PUT/v1/peer/agents/:id/walletJWTUpdate wallet (7-day cooling period)
POST/v1/peer/agents/:id/withdrawJWTRequest payout (min $5 USDC)
GET/v1/peer/board-Live peer board data

Security

FeatureValue
JWT expiry1 hour
Refresh token expiry7 days
Max WebSocket connections2 per device
Message rate limit100/min per device
Registration rate limit3/min per IP
Wallet change cooling7 days
IP classificationServer-side ASN lookup (cannot spoof)

Monthly Earnings Estimates

ConnectionAlways-OnPart-Time (8h/day)
Mobile 5G (US)$50-150$15-50
Residential (US)$30-80$10-30
Datacenter VPS$5-15$2-5

Android SDK

// build.gradle
implementation("com.github.bolivian-peru:android-peer-sdk:1.0.2")

// Usage
ProxiesPeerSDK.init(context, "api-key", config)
ProxiesPeerSDK.getInstance().start()  // Start sharing
ProxiesPeerSDK.getInstance().stop()   // Stop sharing

LIVE PEER BOARD

Real-time view of all peers in the network. Auto-refreshes every 30 seconds.

Loading peers...

SDK & PACKAGES

npm Packages

PackageDescription
@proxies-sx/mcp-serverMCP server — 55 tools for proxy management
@proxies-sx/x402-corex402 types, utilities, payment requirement builder
@proxies-sx/x402-honox402 Hono middleware for building paywall APIs
@proxies-sx/x402-solanaSolana transaction verification for x402

GitHub

RepositoryDescription
proxies-sx-mcp-serverMCP server source
x402-sdkx402 payment protocol SDK
android-peer-sdkAndroid SDK for peer bandwidth sharing

Framework Integrations

FrameworkIntegrationDetails
Conway Automatoninstall_skill "proxies-sx"Native x402 support via x402_fetch. Skill PR #78 | Genesis prompt
MCPnpx @proxies-sx/mcp-server55 tools for Claude, Cursor, Windsurf

x402 SDK Example

import { createPaymentRequirement } from '@proxies-sx/x402-core';
import { x402Middleware } from '@proxies-sx/x402-hono';
import { verifySolanaPayment } from '@proxies-sx/x402-solana';

const app = new Hono();
app.use('/api/*', x402Middleware({
  price: 10000,  // $0.01 in micro-units
  recipient: 'YOUR_SOLANA_WALLET',
  verify: verifySolanaPayment,
}));
app.get('/api/data', (c) => c.json({ data: 'premium content' }));


Proxies.sx — Mobile proxy infrastructure for AI agents