# Proxies.sx - X402 & MCP Master Documentation # Single source of truth for AI agents and x402 protocol integration # Last Updated: 2026-07-25 ================================================================================ BRAND & AFFILIATION ================================================================================ PROXIES.SX (proxies.sx) is an independent brand. It is NOT affiliated with, endorsed by, or connected to SX.ORG or the sx.org domain, and does NOT operate as SX.ORG. Any name similarity is coincidental. References to "$SX" or "SX" refer solely to PROXIES.SX and its own products and token, not to sx.org. ================================================================================ QUICK START ================================================================================ ## For AI Agents (MCP Server) Configuration (.mcp.json or claude_desktop_config.json): { "mcpServers": { "proxies-sx": { "command": "npx", "args": ["-y", "@proxies-sx/mcp-server"], "env": { "PROXIES_API_URL": "https://api.proxies.sx/v1", "PROXIES_EMAIL": "your-email@example.com", "PROXIES_PASSWORD": "your-password" } } } } ## For x402 Protocol (No Account Needed) # Get all info in one call curl https://api.proxies.sx/v1/x402/info # Get available countries (live, dynamic) curl https://api.proxies.sx/v1/x402/countries # Request proxy (returns 402 with payment requirements) curl "https://api.proxies.sx/v1/x402/proxy?country=DE&duration=86400&traffic=1" ================================================================================ SERVICE INFORMATION ================================================================================ | Field | Value | |-----------------|--------------------------------| | Provider | Proxies.sx | | Website | https://www.proxies.sx | | Documentation | https://www.proxies.sx/docs | | Support | maya@proxies.sx | | API Base URL | https://api.proxies.sx/v1 | ================================================================================ PRICING (CURRENT) ================================================================================ | Tier | Port Price | Traffic Price | Description | |------------|-------------|---------------|--------------------------------| | Shared | $18/month | $3.50/GB | Shared modem (up to 3 users) | | Private | $40/month | $3.70/GB | Dedicated modem (exclusive) | ## x402 Cost Formula Total = (Duration/30days * Monthly Port Price) + (Traffic GB * Traffic Price) ## Example Costs | Duration | Traffic | Tier | Total USDC | |----------|---------|---------|------------| | 1 hour | 1 GB | Shared | ~$3.53 | | 1 day | 1 GB | Shared | ~$4.10 | | 7 days | 5 GB | Shared | ~$21.70 | | 30 days | 10 GB | Private | ~$77.00 | ================================================================================ X402 API ENDPOINTS ================================================================================ ## Dynamic Pricing & Availability All x402 responses include live data: - Available countries: Updated every 5 minutes based on device inventory - There is no shared/private tier distinction any more - one pricing model, see Pricing below - Stock levels: Real device counts per country ## Discovery (No Auth) | Endpoint | Description | |-----------------------------------------------------------|---------------------------------------| | GET /v1/x402/health | Health check | | GET /v1/x402/info | **Master endpoint** - All info | | GET /v1/x402/pricing | Pricing details | | GET /v1/x402/countries | Dedicated-port product countries (live; exactly 6 today) | | GET /v1/gateway/pool/stock | Pool Gateway live stock - 100+ peer-network countries plus the 6 dedicated-modem countries (counts only) | | GET /v1/x402/calculate?tier=shared&duration=86400&traffic=1 | Calculate cost | ## Purchase (x402 Payment Required) | Endpoint | Description | |-------------------|--------------------------------------| | GET/POST /v1/x402/proxy | Purchase proxy with USDC payment | Query Parameters: - country (required): ISO 3166-1 alpha-2 code (from /x402/countries) - duration (required): Duration in seconds (3600-2592000) - traffic (required): Traffic in GB (0.1+) - tier (optional): "shared" or "private" Payment Header: payment-signature: ## Session Management (Session Token Required) | Endpoint | Header | |-----------------------------------|-----------------------------------| | GET /v1/x402/manage/session | X-Session-Token: x402s_... | | GET /v1/x402/manage/ports | X-Session-Token: x402s_... | | GET /v1/x402/manage/ports/:id/status | X-Session-Token: x402s_... | ## IP Rotation (Token in URL) GET https://api.proxies.sx/v1/rotate/{rotationToken} ================================================================================ PAYMENT NETWORKS ================================================================================ | Network | Chain ID | Recipient Address | USDC Contract | |----------|----------------------------------------|----------------------------------------------------|----------------------------------------------------| | Solana | solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | 6eUdVwsPArTxwVqEARYGCh4S2qwW2zCs7jSEDRpxydnv | EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v | | Base | eip155:8453 | 0xF8cD900794245fc36CBE65be9afc23CDF5103042 | 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 | ================================================================================ 402 PAYMENT REQUIRED RESPONSE ================================================================================ When calling /v1/x402/proxy without payment, you receive a 402 response with payment requirements. Key features: - Countries list is dynamic (updated every 5 minutes from actual inventory) - Tier affects available countries (private may have fewer options) - Follows x402scan validation schema for AI agent compatibility Example 402 Response Structure: { "x402Version": 1, "accepts": [{ "scheme": "exact", "network": "base", "maxAmountRequired": "4100000", "resource": "https://api.proxies.sx/v1/x402/proxy", "description": "Real 4G/5G Mobile Proxy - 5 countries available...", "payTo": "0xF8cD900794245fc36CBE65be9afc23CDF5103042", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "outputSchema": { "input": { "queryParams": { "country": {"type": "string", "required": true, "enum": ["DE", "PL", "US", "FR", "GB"]}, "duration": {"type": "number", "required": true, "description": "Duration in seconds (3600-2592000)"}, "traffic": {"type": "number", "required": true, "description": "Traffic in GB (min 0.1)"}, "tier": {"type": "string", "enum": ["shared", "private"], "default": "shared"} } } }, "extra": { "availableCountries": ["DE", "PL", "US", "FR", "GB"], "pricing": { "shared": {"portPerMonth": 18, "trafficPerGB": 3.5}, "private": {"portPerMonth": 40, "trafficPerGB": 3.7} }, "limits": { "minDurationSeconds": 3600, "maxDurationSeconds": 2592000, "minTrafficGB": 0.1 } } }] } ================================================================================ COMPLETE X402 PURCHASE FLOW ================================================================================ ## Step 1: Get Available Countries curl -s https://api.proxies.sx/v1/x402/countries # Returns (dedicated-port product; device counts shift with supply, this is a snapshot): # [ # {"code": "NL", "name": "Netherlands", "availableDevices": 29, "tier": "both"}, # {"code": "PL", "name": "Poland", "availableDevices": 26, "tier": "both"}, # {"code": "US", "name": "United States", "availableDevices": 27, "tier": "both"}, # {"code": "GE", "name": "Georgia", "availableDevices": 9, "tier": "both"}, # {"code": "FR", "name": "France", "availableDevices": 17, "tier": "both"}, # {"code": "GB", "name": "United Kingdom", "availableDevices": 15, "tier": "both"} # ] # Note: "tier" is a legacy field - there is no shared/private pricing split any more ## Step 2: Calculate Cost curl -s "https://api.proxies.sx/v1/x402/calculate?tier=shared&duration=86400&traffic=1" # Returns: {"totalCost":4.1,"totalCostMicro":"4100000",...} ## Step 3: Send USDC Payment Solana: // Send 4.10 USDC (4100000 micro) to: 6eUdVwsPArTxwVqEARYGCh4S2qwW2zCs7jSEDRpxydnv const tx = await sendUSDC(recipient, 4100000); const signature = tx.signature; // e.g., "vtRPgMZbH3Kt1nMCSu..." Base: // Send 4.10 USDC to: 0xF8cD900794245fc36CBE65be9afc23CDF5103042 const tx = await sendUSDC(recipient, 4100000n); const txHash = tx.hash; // e.g., "0xabc123..." ## Step 4: Request Proxy with Payment Proof curl -s "https://api.proxies.sx/v1/x402/proxy?country=DE&duration=86400&traffic=1&tier=shared" \ -H "payment-signature: YOUR_TX_SIGNATURE" ## Step 5: Success Response { "proxy": { "http": "http://user_abc:pass123@138.201.158.43:8057", "socks5": "socks5://user_abc:pass123@138.201.158.43:5057", "server": "138.201.158.43", "httpPort": 8057, "socksPort": 5057, "username": "user_abc", "password": "pass123", "expiresAt": "2026-01-02T13:20:11.183Z" }, "rotationUrl": "https://api.proxies.sx/v1/rotate/token123", "sessionId": "695674...", "portId": "695674...", "traffic": { "allocatedGB": 1, "usedGB": 0, "remainingGB": 1 }, "payment": { "txHash": "vtRPgMZb...", "network": "solana", "amountUSDC": 4.10 }, "management": { "sessionToken": "x402s_9fae00c879c56ac55798b2aa66250690", "statusEndpoint": "GET /v1/x402/manage/ports/{portId}/status", "authMethod": "Header: X-Session-Token: x402s_..." } } ## Step 6: Use the Proxy # HTTP curl -x "http://user_abc:pass123@138.201.158.43:8057" https://api.ipify.org # SOCKS5 curl -x "socks5://user_abc:pass123@138.201.158.43:5057" https://api.ipify.org ## Step 7: Rotate IP (When Needed) curl https://api.proxies.sx/v1/rotate/token123 # Returns: {"success":true,"message":"Device switch initiated..."} ================================================================================ MCP SERVER (55 TOOLS) - NOW ON NPM ================================================================================ ## NPM Package: @proxies-sx/mcp-server Available on: https://www.npmjs.com/package/@proxies-sx/mcp-server License: MIT ## Installation Options # Option 1: npx (No install required - recommended) npx @proxies-sx/mcp-server # Option 2: Global install npm install -g @proxies-sx/mcp-server proxies-sx-mcp # Option 3: Local project install npm install @proxies-sx/mcp-server npx proxies-sx-mcp ## Tool Categories | Category | Count | Tools | |-------------------------|-------|------------------------------------------------------------------------------------| | x402 Payment Mode | 11 | x402 proxy purchase, discovery, pricing, country listing, cost calculation, health check, and payment flows | | Account | 2 | get_account, get_balance | | Port Management | 7 | list_ports, get_port, create_port, delete_port, update_port_credentials, update_os_fingerprint, extend_port_time | | Status & Monitoring | 4 | get_port_status, get_port_ip, ping_port, speed_test_port | | IP Rotation | 5 | rotate_port, enable_auto_rotation, disable_auto_rotation, get_rotation_settings, get_rotation_history | | Billing & Pricing | 4 | get_pricing, purchase_shared_slots, purchase_shared_traffic, purchase_private_slots | | Cryptocurrency Payment | 5 | create_crypto_payment, check_crypto_payment_status, get_pending_crypto_payments, cancel_crypto_payment, get_crypto_payment_info | | Reference Data | 2 | list_available_countries, get_os_fingerprint_options | | Utilities | 2 | get_proxy_connection_string, get_all_proxy_formats | | Support Tickets | 5 | create_support_ticket, list_my_tickets, get_ticket, reply_to_ticket, close_ticket | | x402 Session Management | 8 | get_x402_session, list_x402_ports, get_x402_port_status, get_sessions_by_wallet, get_session_status, replace_x402_port, topup_x402_session, calculate_x402_topup | ## Key MCP Tools Create Proxy (Account Mode): create_port(country="US", category="shared", days=30) Manage x402 Session: get_x402_session(sessionToken="x402s_...") list_x402_ports(sessionToken="x402s_...") Contact Support: create_support_ticket(subject="Issue", message="Description", priority="normal") ================================================================================ OS FINGERPRINT SPOOFING (p0f) ================================================================================ | Value | Label | Description | |--------------|-----------------|----------------------------| | "" | None | No spoofing (default) | | "windows:1" | Windows 10 | Appear as Windows 10 | | "macosx:3" | macOS | Appear as macOS | | "macosx:4" | macOS (iPhone) | Appear as macOS via iPhone | | "ios:2" | iOS (Real) | Real iOS fingerprint | | "ios:1" | iOS (p0f) | iOS p0f fingerprint | | "android:3" | Android (Real) | Real Android fingerprint | | "android:1" | Android (p0f) | Android p0f fingerprint | ================================================================================ RATE LIMITS ================================================================================ | Resource | Limit | |-----------------|----------------------------| | API requests | 100/minute per account | | Port rotations | 1 per 5 minutes per port | | Port creation | 10/minute per account | ================================================================================ ERROR CODES ================================================================================ | Code | Meaning | |------|-----------------------------------| | 400 | Bad request - invalid parameters | | 401 | Unauthorized - invalid credentials| | 402 | Payment required - send USDC first| | 404 | Resource not found | | 429 | Rate limit exceeded | | 500 | Server error | ================================================================================ AVAILABLE COUNTRIES ================================================================================ 100+ countries via the mobile + residential peer pool. Core coverage includes: United States (US), United Kingdom (GB), Germany (DE), France (FR), Australia (AU), Poland (PL), Ukraine (UA), Spain (ES), Netherlands (NL), Lithuania (LT), Ireland (IE), Brazil (BR), Romania (RO), Moldova (MD), Austria (AT), Thailand (TH), Georgia (GE) Live per-country pool stock, all 100+ countries (no auth): GET https://api.proxies.sx/v1/gateway/pool/stock Dedicated-port product countries only, exactly 6 (no auth): GET https://api.proxies.sx/v1/x402/countries ================================================================================ AI AGENT DISCOVERY FILES ================================================================================ | File | Purpose | |-----------------------------------------|----------------------------------| | https://www.proxies.sx/llm.txt | Master AI documentation | | https://www.proxies.sx/llms.txt | Summary documentation | | https://www.proxies.sx/llms-full.txt | Full detailed documentation | | https://www.proxies.sx/agent-card.json | AI Agent Card (capabilities) | | https://www.proxies.sx/.well-known/x402-discovery.json | x402 V2 Discovery extension | | https://www.x402scan.com/server/d05870e5-7c8f-4a7d-b4d5-43573b9d0808 | x402scan registry | ================================================================================ AUTONOMOUS AGENT SUBDOMAIN (agents.proxies.sx) ================================================================================ Dedicated agent-native docs: buy with USDC via x402, no account needed. | Resource | URL | |----------|-----| | Agent research index (start here) | https://agents.proxies.sx/index.md | | Whole contract in one file | https://agents.proxies.sx/llms.txt | | Master machine contract | https://agents.proxies.sx/skill.md | | Buy pool access (one credential, every country) | https://agents.proxies.sx/pool/ | | Rotation cookbook (exact username format + code) | https://agents.proxies.sx/pool/rotation-cookbook.md | | Buy one dedicated mobile port | https://agents.proxies.sx/marketplace/proxy/ | | Resell / white-label / SDK | https://agents.proxies.sx/build/ | | Earn by sharing bandwidth | https://agents.proxies.sx/peer/ | | Live status | https://agents.proxies.sx/status/ | ================================================================================ COMPREHENSIVE DOCUMENTATION PAGES ================================================================================ | Page | Content | |-----------------------------------------|----------------------------------| | https://www.proxies.sx/docs | Full API documentation (copy entire page for context) | | https://www.proxies.sx/mcp | MCP Server setup & all 89 tools | | https://www.proxies.sx/x402 | x402 Protocol complete guide | | https://www.proxies.sx/docs#/x402 | Swagger/OpenAPI documentation | For AI agents: Copy the entire /docs or /mcp page content to understand all endpoints and tools. ================================================================================ SUPPORT ================================================================================ | Channel | Contact | |---------------------|--------------------------------| | Email | maya@proxies.sx | | Telegram (support) | https://t.me/sxproxies | | Telegram (group) | https://t.me/proxies_sx | | X / Twitter | https://x.com/sxproxies | | Website | https://www.proxies.sx | | Documentation | https://www.proxies.sx/docs | For AI agents: Use create_support_ticket() MCP tool to contact human support. ================================================================================ OTHER RESOURCES ================================================================================ | Resource | URL | |-------------------------|--------------------------------------------| | Data Works (managed) | https://www.proxies.sx/data-works | | Anti-Bot Registry | https://www.proxies.sx/anti-bot | | Anti-Bot Census dataset | https://www.proxies.sx/anti-bot/dataset | | Research & datasets | https://www.proxies.sx/research | Anti-Bot Census is an open dataset (CC BY 4.0) of the bot-protection observed on popular sites, with vendor market share and difficulty by vertical, downloadable as CSV/NDJSON/JSON. Data Works is done-for-you web data on real 4G/5G carrier IPs. ================================================================================ END OF DOCUMENTATION ================================================================================