PROXIES.SX

Mobile proxy infrastructure for AI agents. Pay with USDC on-chain. No API keys needed.
51 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 TypeEarnings/GBExamples
Mobile$0.25AT&T, Verizon, T-Mobile, Vodafone
Residential$0.15Comcast, Spectrum, Cox, BT
Datacenter$0.02AWS, GCP, Azure, Hetzner, VPNs

IP type determined server-side via ASN lookup. Device-reported type ignored. Min payout: $5 USDC. Payout: 24-48h.

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.proxies-sx:android-sdk:1.0.0")

// 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