{"uid":"cap_oPg1Xk6A_Utw_xsBKod3B","slug":"ai-website-intelligence-agent-readiness-api-d4becd34","name":"AI Website Intelligence & Agent Readiness API","description":"Audit any website for AI Agent Readiness, MCP, llms.txt, OpenAPI, SEO, accessibility and security. Structured JSON with evidence and prioritized fixes.","url":"https://santosautomation.com/api/agent-readiness","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"Public HTTP or HTTPS target URL."},"depth":{"enum":["quick"],"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"grade":"C","score":79,"target":{"final_url":"https://example.com/","requested_url":"https://example.com","canonical_origin":"https://example.com"},"profile":"api_provider","findings":[{"id":"agent.openapi.discovery","title":"OpenAPI document discovered and parsed","status":"pass","category":"api_readiness","severity":"moderate","confidence":"high","recommendation":"No action needed."}],"subscores":{"api_readiness":75,"discovery_and_documentation":80},"confidence":0.91,"interfaces":{"openapi":{"url":"https://example.com/openapi.json","discovered":true}},"limitations":["Passive checks only; no authenticated or transactional testing performed."],"applicability":{"mcp_readiness":"tested","agent_commerce":"not_applicable"},"schema_version":"1.0.0","readiness_level":{"name":"Tool-invokable","level":3},"recommended_actions":[{"id":"agent.capabilities.manifest","effort":"medium","impact":"high"}],"website_intelligence":{"score":82,"dimensions":{"callable":73,"trustworthy":86,"discoverable":91,"understandable":78},"schema_version":"1.0.0"},"tested_coverage_percent":90,"website_intelligence_score":82}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.075","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.075/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.075","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.075","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uWU5c7omJTBFkl9qpqTBD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.075","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Audits any public website for AI agent readiness, MCP support, llms.txt, OpenAPI discoverability, SEO, accessibility, and security, returning a structured JSON report with scores and prioritized fixes.","exampleAgentPrompt":"Can you audit https://mycompany.com for AI agent readiness — I want to know if it exposes OpenAPI, llms.txt, or MCP endpoints, and what grade it gets overall with prioritized fixes?","exampleUseCases":[{"title":"Pre-launch AI readiness check","prompt":"Before we launch our new API portal at https://api.acmecorp.com, can you run an AI agent readiness audit on it and tell me what grade it gets, whether it has OpenAPI and llms.txt set up, and what the top things to fix are?"},{"title":"Competitor benchmarking for agent discoverability","prompt":"I want to see how well https://stripe.com is set up for AI agent discovery — can you audit it for MCP support, OpenAPI exposure, and agent readiness and give me the full breakdown of scores?"},{"title":"Developer blog accessibility and SEO audit","prompt":"Can you check https://dev.blog.example.com for AI readiness, SEO, and accessibility issues, and give me a prioritized list of what to fix so AI agents can find and use the content there?"}],"resultDescription":"Returns a structured JSON object containing: an overall letter grade (e.g. 'C') and numeric score (0-100), subscores for api_readiness and discovery_and_documentation, a findings array with individual check results (id, title, status, severity, confidence, recommendation), a website_intelligence object with dimensional scores (callable, trustworthy, discoverable, understandable), a readiness_level (name and numeric level), discovered interfaces (e.g. OpenAPI URL), recommended_actions with effort/impact ratings, applicability flags for MCP and agent commerce, tested_coverage_percent, confidence score, and a limitations list.","failureModes":["Invalid or unreachable URL returns an error — the target must be a publicly accessible HTTP/HTTPS URL","Non-existent domains or URLs returning 4xx/5xx may result in partial results or audit failure","Only passive checks are performed — authenticated endpoints or private APIs will not be fully audited","The 'depth' parameter currently only supports 'quick' — deeper audits are not available","Payment failure (x402) will block the request before any audit is performed"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, structured AI-agent-readiness audit of a public website, especially when you want to check for MCP, llms.txt, OpenAPI discoverability, and agent commerce support in a single call. It is preferable over generic SEO or uptime tools when the primary concern is whether an AI agent can discover and interact with the target site. Best suited for developers, AI product teams, and automation pipelines evaluating third-party or their own sites for agent-compatibility.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:47:12.941Z","isFirstParty":false}