# Proxies.sx - X402 & MCP Master Documentation # Single source of truth for AI agents and x402 protocol integration # Last Updated: 2026-01-01 ================================================================================ 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://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 - Country list differs by tier: Private tier may have fewer countries - Pricing included in response: Both shared and private tier rates - 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 | All available countries (live) | | GET /v1/x402/countries?tier=shared | Shared tier countries only | | GET /v1/x402/countries?tier=private | Private tier countries 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 | 6qJVQ61ygwjuB7DK94ccrAcxgiQkc2tbbWeNCr3FT2HY | EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v | | Base | eip155:8453 | 0xC6C3a87363D5b37d9510202015369086e25558f1 | 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": "0xC6C3a87363D5b37d9510202015369086e25558f1", "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: # [ # {"code": "US", "name": "United States", "availableDevices": 88, "tier": "both"}, # {"code": "DE", "name": "Germany", "availableDevices": 27, "tier": "both"}, # {"code": "GB", "name": "United Kingdom", "availableDevices": 22, "tier": "shared"}, # {"code": "PL", "name": "Poland", "availableDevices": 22, "tier": "both"}, # {"code": "FR", "name": "France", "availableDevices": 18, "tier": "both"} # ] # Note: "tier" indicates availability - "both", "shared", or "private" ## 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: 6qJVQ61ygwjuB7DK94ccrAcxgiQkc2tbbWeNCr3FT2HY const tx = await sendUSDC(recipient, 4100000); const signature = tx.signature; // e.g., "vtRPgMZbH3Kt1nMCSu..." Base: // Send 4.10 USDC to: 0xC6C3a87363D5b37d9510202015369086e25558f1 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 (42 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 | |-----------------|-------|------------------------------------------------------------------------------------| | Account | 2 | get_account, get_balance | | Ports | 7 | list_ports, get_port, create_port, delete_port, update_port_credentials, update_os_fingerprint, extend_port_time | | Status | 4 | get_port_status, get_port_ip, ping_port, speed_test_port | | Rotation | 5 | rotate_port, enable_auto_rotation, disable_auto_rotation, get_rotation_settings, get_rotation_history | | Billing | 5 | get_pricing, purchase_shared_slots, purchase_shared_traffic, purchase_private_slots, purchase_private_traffic | | Reference | 1 | list_available_countries | | Utilities | 3 | get_proxy_connection_string, get_all_proxy_formats, get_os_fingerprint_options | | Payments | 5 | create_crypto_payment, check_crypto_payment_status, get_pending_crypto_payments, cancel_crypto_payment, get_crypto_payment_info | | Support | 5 | create_support_ticket, list_my_tickets, get_ticket, reply_to_ticket, close_ticket | | X402 Sessions | 5 | get_x402_session, list_x402_ports, get_x402_port_status, get_sessions_by_wallet, get_session_status | ## 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 ================================================================================ 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) ================================================================================ AI AGENT DISCOVERY FILES ================================================================================ | File | Purpose | |-----------------------------------------|----------------------------------| | https://proxies.sx/llm.txt | Master AI documentation | | https://proxies.sx/llms.txt | Summary documentation | | https://proxies.sx/llms-full.txt | Full detailed documentation | | https://proxies.sx/agent-card.json | AI Agent Card (capabilities) | | https://proxies.sx/.well-known/x402-discovery.json | x402 V2 Discovery extension | | https://www.x402scan.com/server/d05870e5-7c8f-4a7d-b4d5-43573b9d0808 | x402scan registry | ================================================================================ COMPREHENSIVE DOCUMENTATION PAGES ================================================================================ | Page | Content | |-----------------------------------------|----------------------------------| | https://proxies.sx/docs | Full API documentation (copy entire page for context) | | https://proxies.sx/mcp | MCP Server setup & all 42 tools | | https://proxies.sx/x402 | x402 Protocol complete guide | | https://api.proxies.sx/api#/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 | https://t.me/sxproxies | | Website | https://proxies.sx | | Documentation | https://proxies.sx/docs | For AI agents: Use create_support_ticket() MCP tool to contact human support. ================================================================================ END OF DOCUMENTATION ================================================================================