{"openapi":"3.1.0","info":{"title":"Agent Readiness Scanner API","version":"1.0.0","description":"API for scanning websites for AI agent readiness. Returns scores, letter grades, and detailed results across six categories.","contact":{"name":"QBurst Technologies","url":"https://qburst.com","email":"hello@qburst.com"},"license":{"name":"MIT"}},"servers":[{"url":"https://agent-ready-nine.vercel.app","description":"Production"}],"paths":{"/api/check":{"post":{"operationId":"scanSite","summary":"Scan a website for agent readiness","description":"Scans the given URL across up to 21 checks spanning discoverability, content accessibility, bot access control, API/auth/MCP, trust & security, and commerce. Returns a 0–100 score, letter grade (A+–F), and per-check results.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"The website URL to scan (e.g. https://example.com)","example":"https://example.com"},"enabledChecks":{"type":"array","items":{"type":"string"},"description":"Optional list of check IDs to run. Omit or pass [] to run all checks.","example":["robots_txt","sitemap","llms_txt"]}}}}}},"responses":{"200":{"description":"Scan result","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Normalised URL that was scanned"},"score":{"type":"integer","minimum":0,"maximum":100,"description":"Overall agent readiness score"},"maxScore":{"type":"integer","description":"Maximum possible score for the enabled checks"},"scannedAt":{"type":"string","format":"date-time"},"categories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"countsTowardScore":{"type":"boolean"},"checks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["pass","fail","warn","skip"]},"detail":{"type":"string"},"link":{"type":"string"},"rawContent":{"type":"string"}}}}}}}}}}}},"400":{"description":"Invalid or unreachable URL"},"500":{"description":"Internal server error"}}}},"/api/mcp":{"post":{"operationId":"mcpRequest","summary":"MCP server endpoint (Streamable HTTP)","description":"Model Context Protocol server. Accepts JSON-RPC 2.0 messages. Tools: scan_site, list_checks. See /.well-known/mcp/server-card.json for the full server card.","externalDocs":{"description":"MCP Server Card","url":"https://agent-ready-nine.vercel.app/.well-known/mcp/server-card.json"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string","example":"2.0"},"method":{"type":"string","example":"tools/call"},"params":{"type":"object"},"id":{"type":["string","integer"]}}}}}},"responses":{"200":{"description":"JSON-RPC response"}}}}},"x-checks":[{"id":"robots_txt","category":"Discoverability","name":"robots.txt"},{"id":"sitemap","category":"Discoverability","name":"Sitemap"},{"id":"link_headers","category":"Discoverability","name":"Link headers"},{"id":"llms_txt","category":"Discoverability","name":"llms.txt"},{"id":"markdown_negotiation","category":"Content Accessibility","name":"Markdown negotiation"},{"id":"schema_org","category":"Content Accessibility","name":"Structured Data"},{"id":"ai_bot_rules","category":"Bot Access Control","name":"AI bot rules"},{"id":"content_signals","category":"Bot Access Control","name":"Content Signals"},{"id":"web_bot_auth","category":"Bot Access Control","name":"Web Bot Auth"},{"id":"api_catalog","category":"API / Auth / MCP","name":"API Catalog"},{"id":"oauth_discovery","category":"API / Auth / MCP","name":"OAuth discovery"},{"id":"oauth_protected_resource","category":"API / Auth / MCP","name":"OAuth Protected Resource"},{"id":"mcp_server_card","category":"API / Auth / MCP","name":"MCP Server Card"},{"id":"a2a_agent_card","category":"API / Auth / MCP","name":"A2A Agent Card"},{"id":"agent_skills","category":"API / Auth / MCP","name":"Agent Skills"},{"id":"webmcp","category":"API / Auth / MCP","name":"WebMCP"},{"id":"security_headers","category":"Trust & Security","name":"Security Headers"},{"id":"x402","category":"Commerce","name":"x402"},{"id":"mpp","category":"Commerce","name":"MPP"},{"id":"ucp","category":"Commerce","name":"UCP"},{"id":"acp","category":"Commerce","name":"ACP"}]}