MCP SERVERScore a site for AI-agent readability against the Vercel spec, llms.txt and agent-protocol manifests — with a fix per check.
LABSCO SUMMARY
validate_structured_data will check JSON-LD handed to it directly, so an agent can validate markup it has just written before the page exists anywhere. Everything else is a scan of a live site — and the free tier is enough to find out whether yours has a problem worth paying to fix.
A scanner for how well a website works for AI agents. It grades against the Vercel Agent Readability Spec, the llmstxt.org standard and agent-protocol manifests — 71 checks across four spec families — and returns per-check fix guidance plus a separate accessibility sub-score.
No key is needed to start: scan_site, ask and validate_structured_data all work anonymously, with scan_site on a free tier of 3 scans per 30 days per IP at 25-page depth, returned synchronously. Either point a client at https://agent-ready.dev/api/v1/mcp over Streamable HTTP, or run the npm package agent-ready-mcp over stdio; AGENT_READY_API_KEY is optional. A Pro key raises the limit to 50 scans a month at 250-page depth, unlocks get_scan and adds weekly monitoring. AGENT_READY_API_URL overrides the host; AGENT_READY_SCAN_TIMEOUT_MS defaults to 60000 and AGENT_READY_GET_TIMEOUT_MS to 5000.
One command — npx -y agent-ready-mcp@latest
USE CASES
A Vercel score, an llms.txt sub-score and per-check findings, keyless on the free tier.
Paste the markup and get schema lint plus coherence checks with no page and no network needed.
Each finding carries its own fix guidance, and the methodology behind a check is searchable.
Run the scan in the pipeline and read the score before publishing.
Natural-language search across the check registry, the specs and the explainer library.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
askNatural-language search (NLWeb /ask) over Agent Ready's own content — scoring methodology, the check registry, the specs it validates, and the content library (explainers, comparisons, how-to guides, glossary). Public, no API key required. Returns Schema.org-typed result objects; optional itemType narrows to a corpus type and mode 'summarize' adds an extractive summary.
get_scanFetches a completed or in-progress scan by its id. Requires a Pro API key — scan history is account-scoped. (Anonymous scan_site calls return their result inline, so keyless use never needs this tool.)
scan_siteRuns the agent-ready.dev scanner against a URL and returns structured results: Vercel score, llmstxt.org score, and per-check findings with remediation hints. Works without an API key on the anonymous free tier (3 scans/30 days per IP, 25-page depth, synchronous). With a Pro AGENT_READY_API_KEY it scans deeper (up to 250 pages) and may take up to ~60s; if the local poll deadline elapses, the tool returns the scan id and asks you to poll with get_scan.
validate_structured_dataValidates a page's (or a pasted) JSON-LD against Agent Ready's structured-data checks (schema lint + agent-coherence: freshness honesty, canonical/.md coherence, entity-name consistency, extraction signal) and returns a verdict with per-check fix guidance. Provide exactly one of url (fetch + validate) or jsonld (validate a string the agent just authored — no network needed). Public, no API key required. The one structured-data check the first-party validators (validator.schema.org, Rich Results Test) don't do.
BEFORE YOU INSTALL
4 tools when we connected. Scan, interpret_scan and remediation_plan are prompts, not tools. Without a key, get_scan is unavailable and scan_site is limited to 3 scans per 30 days per IP at 25 pages instead of 250.
npx on PATH
All 5 documented clients run the server on your machine.
CONTEXT COST
Rated by the size of the 4 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
npx -y agent-ready-mcp@latesthttps://agent-ready.dev/api/v1/mcpAdd this hosted endpoint to your MCP client.
{
"mcpServers": {
"agent-ready": {
"command": "npx",
"args": [
"-y",
"agent-ready-mcp@latest"
]
}
}
}{
"servers": {
"agent-ready": {
"command": "npx",
"args": [
"-y",
"agent-ready-mcp@latest"
]
}
}
}claude mcp add agent-ready -- npx -y agent-ready-mcp@latestMCP servers
Convrgent
rampify-dev
andrew7carlin
1fancy