Agent Ready is an MCP server published by io.github.mlava, hosted at agent-ready.dev. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 3 tools, including scan_site, get_scan, ask.
Scan any URL for AI agent readability — Vercel Spec, llmstxt.org, and agent-protocol manifests.
665 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Runs the agent-ready.dev scanner against a URL and returns structured results: Vercel score, llmstxt.org score, and per-check findings with remediation hints. Scans may take up to ~60s; for larger scans the tool returns a scan id and asks you to poll with get_scan.
| Parameter | Type | Description |
|---|---|---|
| url * | string | Full URL of the site to scan, e.g. https://example.com. Must be a public http(s) address. |
| pageLimit | integer | Maximum number of pages to crawl. Defaults to your tier's per-scan page limit when omitted. |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
{
"name": "scan_site",
"title": "Scan a site for AI agent readability",
"description": "Runs the agent-ready.dev scanner against a URL and returns structured results: Vercel score, llmstxt.org score, and per-check findings with remediation hints. Scans may take up to ~60s; for larger scans the tool returns a scan id and asks you to poll with get_scan.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2000,
"description": "Full URL of the site to scan, e.g. https://example.com. Must be a public http(s) address."
},
"pageLimit": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Maximum number of pages to crawl. Defaults to your tier's per-scan page limit when omitted."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"status"
],
"properties": {
"id": {
"type": "string",
"description": "The scan id."
},
"status": {
"enum": [
"running",
"completed",
"failed"
],
"type": "string",
"description": "Scan status: running, completed, or failed."
},
"pollUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Poll URL while the scan is still running."
},
"rootUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The scanned site URL."
},
"shareUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Path to the shareable report (/scan/<id>)."
},
"vercelScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Score against the Vercel Agent Readability Spec (0–100); null while running."
},
"llmstxtScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "llms.txt score (0–100)."
},
"pagesScanned": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Number of pages scanned."
},
"vercelRating": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Rating band for the Vercel score."
},
"pagesDiscovered": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Number of pages discovered."
},
"protocolResults": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"checkId",
"name",
"status",
"message",
"howToFix"
],
"properties": {
"name": {
"type": "string"
},
"status": {
"enum": [
"pass",
"fail",
"warn",
"error"
],
"type": "string"
},
"checkId": {
"type": "string"
},
"message": {
"type": "string"
},
"howToFix": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "Agent-protocol checks (C-series) that ran — only for endpoints the site actually exposes."
},
"accessibilityScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Accessibility / layout-stability sub-score (0–100) over the homepage WCAG checks; null when none ran. Separate from the Vercel score."
},
"accessibilityChecks": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"checkId",
"name",
"status",
"message",
"howToFix"
],
"properties": {
"name": {
"type": "string"
},
"status": {
"enum": [
"pass",
"fail",
"warn",
"error"
],
"type": "string"
},
"checkId": {
"type": "string"
},
"message": {
"type": "string"
},
"howToFix": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "Accessibility / layout-stability checks (A-series) run over the homepage."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Fetches a completed or in-progress scan by its id. Only scans owned by the authenticated API key's user are returned.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The scan id returned by scan_site (also the share token in a /scan/<id> URL). |
{
"name": "get_scan",
"title": "Get a previous scan by id",
"description": "Fetches a completed or in-progress scan by its id. Only scans owned by the authenticated API key's user are returned.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "The scan id returned by scan_site (also the share token in a /scan/<id> URL)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"status"
],
"properties": {
"id": {
"type": "string",
"description": "The scan id."
},
"status": {
"enum": [
"running",
"completed",
"failed"
],
"type": "string",
"description": "Scan status: running, completed, or failed."
},
"pollUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Poll URL while the scan is still running."
},
"rootUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The scanned site URL."
},
"shareUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Path to the shareable report (/scan/<id>)."
},
"vercelScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Score against the Vercel Agent Readability Spec (0–100); null while running."
},
"llmstxtScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "llms.txt score (0–100)."
},
"pagesScanned": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Number of pages scanned."
},
"vercelRating": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Rating band for the Vercel score."
},
"pagesDiscovered": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Number of pages discovered."
},
"protocolResults": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"checkId",
"name",
"status",
"message",
"howToFix"
],
"properties": {
"name": {
"type": "string"
},
"status": {
"enum": [
"pass",
"fail",
"warn",
"error"
],
"type": "string"
},
"checkId": {
"type": "string"
},
"message": {
"type": "string"
},
"howToFix": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "Agent-protocol checks (C-series) that ran — only for endpoints the site actually exposes."
},
"accessibilityScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Accessibility / layout-stability sub-score (0–100) over the homepage WCAG checks; null when none ran. Separate from the Vercel score."
},
"accessibilityChecks": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"checkId",
"name",
"status",
"message",
"howToFix"
],
"properties": {
"name": {
"type": "string"
},
"status": {
"enum": [
"pass",
"fail",
"warn",
"error"
],
"type": "string"
},
"checkId": {
"type": "string"
},
"message": {
"type": "string"
},
"howToFix": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "Accessibility / layout-stability checks (A-series) run over the homepage."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Natural-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). Returns Schema.org-typed result objects. Optional itemType narrows to a corpus type; mode 'summarize' adds an extractive summary.
| Parameter | Type | Description |
|---|---|---|
| q * | string | Natural-language question to search Agent Ready's docs, scoring methodology, check registry, and content library (explainers, comparisons, how-to guides, glossary). |
| mode | string | "list" (default) returns matching items; "summarize" returns a synthesized answer. |
| itemType | string | Restrict results to a content type: methodology, checks, specs, llms-txt, check, page (explainers/guides/glossary), or any (default: all types). |
{
"name": "ask",
"title": "Ask Agent Ready in natural language",
"description": "Natural-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). Returns Schema.org-typed result objects. Optional itemType narrows to a corpus type; mode 'summarize' adds an extractive summary.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "Natural-language question to search Agent Ready's docs, scoring methodology, check registry, and content library (explainers, comparisons, how-to guides, glossary)."
},
"mode": {
"enum": [
"list",
"summarize"
],
"type": "string",
"description": "\"list\" (default) returns matching items; \"summarize\" returns a synthesized answer."
},
"itemType": {
"enum": [
"methodology",
"checks",
"specs",
"llms-txt",
"check",
"page",
"any"
],
"type": "string",
"description": "Restrict results to a content type: methodology, checks, specs, llms-txt, check, page (explainers/guides/glossary), or any (default: all types)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"results"
],
"properties": {
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Extractive summary when mode is 'summarize'."
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": {}
},
"description": "Matching result items (Schema.org-typed)."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Agent Ready scans any public website for AI agent readability and returns scores plus per-check remediation. Tools: scan_site (run a scan on a URL; long scans return an id to poll), get_scan (fetch a scan by id), ask (natural-language search over Agent Ready's scoring methodology, check registry, and the specs it validates). Resources expose the methodology, the full check registry, Agent Ready's own llms.txt, and the validated specifications. Discovery (initialize, tools/list, resources/list, resources/read, prompts) is public so clients can introspect the server without a credential; executing scan_site / get_scan via tools/call requires a Bearer API key (issue one at https://agent-ready.dev/dashboard/api-keys). Read-only; only public URLs are scanned (private, local, and reserved addresses are refused).
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.