API

Plain REST, authenticated with a Bearer key. We also expose our own WebMCP tools at /mcp.

Authentication

Authorization: Bearer ar_live_…

Create keys in the dashboard. Requires the Pro plan or higher.

Start a scan

curl -X POST https://www.agentreadyfunnel.com/v1/scans \
  -H "authorization: Bearer $AGENTREADY_KEY" \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com","locale":"en","depth":1}'

→ 202 {"scan_id":"scan_…","status":"queued"}

Read the report

curl https://www.agentreadyfunnel.com/v1/scans/scan_… \
  -H "authorization: Bearer $AGENTREADY_KEY"

Poll until scan.status is done. A single-page scan typically takes 5–40 seconds.

Other endpoints

Method	Path	What it does
GET	/v1/me	Account, plan and period usage
GET	/v1/sites/:domain	Latest public scan for a domain
GET	/v1/leaderboard	Public ranking
GET	/v1/plans	Plan catalogue and limits
POST	/mcp	MCP server (JSON-RPC)

Errors

{"error":{"code":"scan_quota_exceeded","message":"…","limit":25,"plan":"free"}}

Plan limits return 402, authentication 401, permissions 403, rate limiting 429.

MCP

curl -X POST https://www.agentreadyfunnel.com/mcp \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tools: scan_site, get_report, get_leaderboard, request_audit.