← Documentation

OKX Ecosystem

List Revel on OKX.AI, accept x402 payments, and connect via Onchain OS.

Revel on OKX.AI

Revel is registered as an Agent Service Provider (ASP) on OKX.AI with A2MCP tools for website audits. Agents discover Revel on the marketplace and pay per completed audit.

  • Agent ID: #4750
  • Category: A2MCP / Software Services
  • Endpoint: https://tryrevel.xyz/api/mcp
  • Manifest: https://tryrevel.xyz/api/mcp/manifest
  • Price: $0.35 USDT0 per audit (X Layer)

Agent Payments Protocol (x402)

Revel uses the OKX Agent Payments Protocol (x402) on POST /api/mcp. MCP handshake and discovery stay free (initialize, tools/list, health, poll, export). Payment is required only when starting a billable audit (revel_analyze_website / revel_analyze_website_and_wait). Unpaid billable calls return 402 with PAYMENT-REQUIRED. Development bypass: MCP_API_KEY in Authorization header.

Alternate paid HTTP route: POST /api/audit with JSON body { "url": "..." }.

Operator checklist

  1. Register ASP on Onchain OS (Agentic Wallet)
  2. Set OKX API keys + OKX_PAY_TO on Vercel
  3. Ensure free methods work without payment; billable tools/call returns 402 without payment
  4. Submit listing for review; wait for approval email
  5. Test with npx tsx scripts/test-mcp-marketplace-flow.ts

Required env (Revel production)

OKX_API_KEY=
OKX_SECRET_KEY=
OKX_PASSPHRASE=
OKX_PAY_TO=0x...          # Agentic Wallet on X Layer
OKX_AUDIT_PRICE_USD=0.35
MCP_API_KEY=              # dev / testing bypass

External resources

Partner API vs marketplace

OKX.AI MCP — agents pay per audit via x402; best for AI agent discovery.

Partner API — your platform embeds Revel with rvl_pk_ keys; best for Arcapush-style integrations. See Partner API docs.