Revel MCP (A2MCP)

Connect AI agents to Revel via Model Context Protocol — analyze websites, get Blueprints, and export roadmaps.

Overview

Revel exposes product intelligence as MCP tools so agents can audit websites, score the Reveal Index, and return a prioritized Blueprint without leaving the chat. Listed on OKX.AI as ASP #4750.

Endpoints

HTTP      https://tryrevel.xyz/api/mcp
Manifest  https://tryrevel.xyz/api/mcp/manifest
Auth      Authorization: Bearer MCP_API_KEY  (dev bypass)
          x402 payment on POST /api/mcp (production marketplace)

Tools

revel_health
revel_analyze_website
revel_get_analysis
revel_wait_for_analysis
revel_analyze_website_and_wait
revel_export_blueprint
revel_fetch_url

Cursor (stdio)

{
  "mcpServers": {
    "revel": {
      "command": "npx",
      "args": ["tsx", "scripts/revel-mcp.ts"],
      "cwd": "/path/to/revel"
    }
  }
}

Remote (OKX.AI / HTTP)

{
  "mcpServers": {
    "revel": {
      "url": "https://tryrevel.xyz/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

Billing (OKX Agent Payments Protocol / x402)

Marketplace billing uses the OKX Agent Payments Protocol (x402) — $0.35 USDT0 per started audit on X Layer. Free without payment: initialize, tools/list, revel_health, poll/export tools. Paid: revel_analyze_website / revel_analyze_website_and_wait return 402 + PAYMENT-REQUIRED when unpaid. Set price via OKX_AUDIT_PRICE_USD. Alternate paid HTTP route: POST /api/audit.

Full operator checklist: OKX ecosystem docs.

Typical agent flow

Call revel_analyze_website with a public URL
Poll with revel_get_analysis every 5s (prefer over revel_wait_for_analysis on HTTP — avoids 60s timeouts)
Export via revel_export_blueprint or read report from the JSON response

MCP vs Partner API

MCP — AI agents discover Revel on OKX.AI and pay per audit via x402. Best for agent marketplaces and Cursor workflows.

Partner API — your web app embeds Revel with rvl_pk_ keys. Best for Arcapush-style platform integrations. See Partner API and integration guide.