Master Skill File: agents.proxies.sx/skill.md — everything in one read for AI agents
HTTP 402 Payment Required for machine-to-machine USDC payments. No accounts, no API keys.
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
| Network | Settlement | Gas | USDC Contract | Recipient |
|---|---|---|---|---|
| Base (EVM) | ~2 sec | ~$0.01 | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 | 0xF8cD900794245fc36CBE65be9afc23CDF5103042 |
| Solana | ~400ms | ~$0.0001 | EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v | 6eUdVwsPArTxwVqEARYGCh4S2qwW2zCs7jSEDRpxydnv |
| Type | Price/GB | Min Purchase | Duration |
|---|---|---|---|
| Shared | $4.00 | 0.1 GB ($0.40) | Free (unlimited) |
| Private | $8.00 | 0.1 GB ($0.80) | Free (unlimited) |
# 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}'
| Method | Path | Auth | Description |
|---|---|---|---|
| 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/proxy | x402 | Purchase mobile proxy |
| POST | /v1/x402/proxy | x402 | Purchase mobile proxy (POST) |
| GET | /v1/x402/manage/session | Token | Session details via token |
| GET | /v1/x402/manage/session/credit | Token | Check remaining credit |
| GET | /v1/x402/manage/ports | Token | List all ports in session |
| GET | /v1/x402/manage/ports/:portId/status | Token | Port status |
| POST | /v1/x402/manage/ports/replace | Token | Replace offline port (free, max 3) |
| POST | /v1/x402/manage/ports/recreate | Token | Recreate deleted port with remaining credit |
| GET | /v1/x402/manage/session/topup/calculate | Token | Preview top-up cost |
| POST | /v1/x402/manage/session/topup | Token+x402 | Pay 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.
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.
x402-gated endpoints at api.proxies.sx. Pay per request with USDC.
| Agent | Endpoint | Price | Payment | Status |
|---|---|---|---|---|
| Mobile Proxy | GET /v1/x402/proxy |
$4.00/GB shared, $8.00/GB private | USDC on Base or Solana | LIVE |
| Antidetect Browser | POST https://browser.proxies.sx/v1/sessions |
~$0.005/min | 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 | ||
Real 4G/5G proxy access from 6+ countries. HTTP and SOCKS5, city/carrier targeting, auto IP rotation.
Cloud browser (Chrome stealth via nodriver) with unique fingerprint + real mobile proxy. Each session automatically includes a mobile proxy from ProxySmart infrastructure — no need to provide your own.
Auto-Proxy: A real 4G/5G mobile proxy is allocated on session creation and cleaned up on session end. Available countries: DE, GB, FR, ES, PL, US. You can still provide your own proxy if preferred.
Identity Bundles (v1.1.0): Save and restore complete browser identity across sessions — cookies, localStorage, fingerprint, proxy device binding. Pass profile_id on session creation to auto-restore. Same fingerprint, same proxy device (IMEI pinning). Profiles persist until deleted.
Browser MCP tools (11): browser_create, browser_go, browser_click, browser_type, browser_see, browser_wait, browser_extract, browser_save, browser_profile_list, browser_profile_delete, browser_end
@proxies-sx/mcp-server v2.0.0 — 55 tools for AI agents to manage proxy infrastructure via Model Context Protocol.
npx -y @proxies-sx/mcp-server
// 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" }
}
}
}
| Category | Count | Key Tools |
|---|---|---|
| Account | 2 | get_account_summary, get_account_usage |
| Port Mgmt | 7 | list_ports, create_port, delete_port, update_port_credentials, reconfigure_port |
| Port Status | 4 | get_port_status, get_port_ip, ping_port, speed_test_port |
| Rotation | 5 | rotate_port, configure_auto_rotation, get_rotation_history |
| Billing | 4 | get_pricing, calculate_price, purchase_shared_traffic, purchase_private_traffic |
| Crypto Pay | 5 | create_crypto_payment, check_crypto_payment_status |
| Support | 5 | create_support_ticket, list_my_tickets, reply_to_ticket |
| x402 Session | 8 | get_x402_session, replace_x402_port, calculate_x402_topup, topup_x402_session |
| x402 Auto | 11 | x402_get_proxy, x402_wallet_balance, x402_rotate_ip, x402_extend_session |
| Utilities | 4 | get_proxy_connection_string, list_available_countries |
| Browser MCP | 11 | browser_create, browser_go, browser_click, browser_type, browser_see, browser_save, browser_profile_list, browser_end |
@proxies-sx/browser-mcp v1.1.0Separate MCP server for antidetect browser with Identity Bundles. 11 tools for cloud browser automation with auto-allocated mobile proxy.
// Claude Desktop / Cursor / Windsurf
{
"mcpServers": {
"browser": {
"command": "npx",
"args": ["-y", "@proxies-sx/browser-mcp"]
}
}
}
Pricing: $0.005/min ($0.30/hr). Single price. Mobile proxy included. Pay with USDC on Base or Solana.
| Tool | Description |
|---|---|
| browser_create | Create session with mobile proxy. Accepts profile_id to restore Identity Bundle. |
| browser_go | Navigate to URL, returns screenshot |
| browser_click | Click element by CSS selector |
| browser_type | Type text with human-like delays |
| browser_see | Screenshot + extract visible text |
| browser_wait | Wait for element, navigation, or duration |
| browser_extract | Extract text, links, or run custom JS |
| browser_save | Save Identity Bundle (cookies + localStorage + fingerprint + proxy binding) |
| browser_profile_list | List all saved Identity Bundle profiles |
| browser_profile_delete | Delete a saved profile permanently |
| browser_end | End session, optionally save profile first |
GitHub: browser-proxies-sx (API) | browser-mcp (MCP) | browser-mcp-server (Full MCP, fork of stealth-browser-mcp)
Share your internet bandwidth, get paid in USDC on Solana. AI agents and humans connect via WebSocket, route traffic, earn automatically.
| IP Type | Earnings/GB | Examples |
|---|---|---|
| Mobile | $0.25 | AT&T, Verizon, T-Mobile, Vodafone |
| Residential | $0.15 | Comcast, Spectrum, Cox, BT |
| Datacenter | $0.02 | AWS, GCP, Azure, Hetzner, VPNs |
IP type determined server-side via ASN lookup. Device-reported type ignored. Min payout: $5 USDC. Payout: 24-48h.
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.
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 } }
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' }));
};
| Method | Endpoint | Auth | Description |
|---|---|---|---|
| POST | /v1/peer/agents/register | - | Register as peer (3/min rate limit) |
| POST | /v1/peer/agents/:id/refresh | Refresh | Refresh JWT (expires 1h) |
| GET | /v1/peer/agents/:id/status | JWT | Peer status |
| GET | /v1/peer/agents/:id/earnings | JWT | Earnings and traffic stats |
| PUT | /v1/peer/agents/:id/wallet | JWT | Update wallet (7-day cooling period) |
| POST | /v1/peer/agents/:id/withdraw | JWT | Request payout (min $5 USDC) |
| GET | /v1/peer/board | - | Live peer board data |
| Feature | Value |
|---|---|
| JWT expiry | 1 hour |
| Refresh token expiry | 7 days |
| Max WebSocket connections | 2 per device |
| Message rate limit | 100/min per device |
| Registration rate limit | 3/min per IP |
| Wallet change cooling | 7 days |
| IP classification | Server-side ASN lookup (cannot spoof) |
| Connection | Always-On | Part-Time (8h/day) |
|---|---|---|
| Mobile 5G (US) | $50-150 | $15-50 |
| Residential (US) | $30-80 | $10-30 |
| Datacenter VPS | $5-15 | $2-5 |
// 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
Real-time view of all peers in the network. Auto-refreshes every 30 seconds.
| Package | Description |
|---|---|
| @proxies-sx/mcp-server | MCP server — 55 tools for proxy management |
| @proxies-sx/browser-mcp | Browser MCP — 11 tools for antidetect browser |
| @proxies-sx/x402-core | x402 types, utilities, payment requirement builder |
| @proxies-sx/x402-hono | x402 Hono middleware for building paywall APIs |
| @proxies-sx/x402-solana | Solana transaction verification for x402 |
| Repository | Description |
|---|---|
| proxies-sx-mcp-server | MCP server source |
| x402-sdk | x402 payment protocol SDK |
| android-peer-sdk | Android SDK for peer bandwidth sharing |
| Framework | Integration | Details |
|---|---|---|
| Conway Automaton | install_skill "proxies-sx" | Native x402 support via x402_fetch. Skill PR #78 | Genesis prompt |
| MCP | npx @proxies-sx/mcp-server | 55 tools for Claude, Cursor, Windsurf |
| Browser MCP | npx @proxies-sx/browser-mcp | 11 tools for antidetect browser control |
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' }));
| File | URL | Purpose |
|---|---|---|
| skill.md | /skill.md | Master skill file — everything for AI agents in one read |
| llms.txt | /llms.txt | LLM integration reference |
| x402.json | /.well-known/x402.json | x402 protocol discovery |
| peer skill.md | /peer/skill.md | Peer marketplace detailed skill |
| Domain | Purpose |
|---|---|
| api.proxies.sx | REST API + x402 endpoints + agent APIs |
| client.proxies.sx | Customer portal |
| admin.proxies.sx | Admin dashboard |
| agents.proxies.sx | This page |
| browser.proxies.sx | Antidetect browser API |
| relay.proxies.sx | WebSocket relay for peer devices |
| gw.proxies.sx | HTTP proxy gateway |