MCP Server

agent-readiness

com.webmcp-tool/agent-readiness
Developer Tools Public & reachable MCP 2025-11-25

What this MCP does

Evaluates public websites for AI-agent readiness, explains findings, provides badge embeds, and supports score monitoring.

explain_check
Explain one check
Use this when the user asks what a specific Agent Readiness finding means, why it matters to AI agents or how to fix it, usually after score_site. Explains one check: what it asks, why an agent cares, how it is weighted and how to fix it, with a code snippet where one exists. Answers from the rule set only and fetches nothing.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['checkId'], 'properties': {'checkId': {'type': 'string', 'description': 'Check identifier, for example content-without-javascript'}}}
Output schema
{'type': 'object', 'required': ['id', 'title', 'points', 'question', 'why', 'fix', 'conditional'], 'properties': {'id': {'type': 'string'}, 'fix': {'type': 'string'}, 'why': {'type': 'string'}, 'docs': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'label': {'type': 'string'}}}}, 'title': {'type': 'string'}, 'pillar': {'type': 'string'}, 'points': {'type': 'number'}, 'snippet': {'type': 'string'}, 'question': {'type': 'string'}, 'conditional': {'type': 'boolean'}}}
get_badge_embed
Get the badge embed
Use this when the user wants to show a site's Agent Readiness badge on that site. Scores the site if needed, then returns the HTML snippet for sites at grade C or better (bronze, silver or gold), or the reason and the first fixes when the site is not eligible. Returns HTML to paste; it installs nothing and runs no script.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'Public http(s) address, for example example.com'}}}
Output schema
{'if': {'properties': {'eligible': {'const': True}}}, 'else': {'required': ['reason', 'fixFirst', 'reportUrl']}, 'then': {'required': ['tier', 'html', 'note', 'badgePage']}, 'type': 'object', 'required': ['eligible', 'host', 'score', 'grade'], 'properties': {'host': {'type': 'string'}, 'html': {'type': 'string'}, 'note': {'type': 'string'}, 'tier': {'type': 'string'}, 'grade': {'type': 'string'}, 'score': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'reason': {'type': 'string'}, 'watchIt': {'type': 'string'}, 'eligible': {'type': 'boolean'}, 'fixFirst': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'fix'], 'properties': {'fix': {'type': 'string'}, 'title': {'type': 'string'}}}}, 'badgePage': {'type': 'string', 'format': 'uri'}, 'reportUrl': {'type': 'string', 'format': 'uri'}}}
list_checks
List the rule set
Use this when the user asks what the Agent Readiness Score measures or how it is calculated, rather than how one site performs. Lists every check in the rule set with its pillar, weight and question. Fetches nothing.
Read only Idempotent
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'type': 'object', 'required': ['pillars'], 'properties': {'pillars': {'type': 'array', 'items': {'type': 'object', 'required': ['pillar', 'axis', 'points', 'checks'], 'properties': {'axis': {'type': 'string'}, 'checks': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'points', 'question'], 'properties': {'id': {'type': 'string'}, 'title': {'type': 'string'}, 'points': {'type': 'number'}, 'question': {'type': 'string'}}}}, 'pillar': {'type': 'string'}, 'points': {'type': 'number'}}}}}}
score_site
Score a site for agent readiness
Use this when the user asks whether a website is ready for AI agents, agent-ready, AI-agent friendly or WebMCP-ready, or what to fix so agents can use it. Scores one public website out of 100 for agent readiness and returns a grade, the fitness and adoption sub-scores, the five highest-value fixes, the scan time and whether the result came from cache. Reads one public page plus standard discovery files (robots.txt, /.well-known endpoints, sitemaps, llms.txt) and up to ten same-origin script bundles; it never logs in, submits forms or changes the site. Results are cached for about an hour.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'Public http(s) address, for example example.com'}}}
Output schema
{'type': 'object', 'required': ['host', 'url', 'score', 'grade', 'fetchedAt', 'cached', 'axes', 'pillars', 'fixFirst', 'excluded', 'reportUrl', 'methodology'], 'properties': {'url': {'type': 'string'}, 'axes': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'earned', 'available', 'question'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'earned': {'type': 'number'}, 'question': {'type': 'string'}, 'available': {'type': 'number'}}}}, 'host': {'type': 'string'}, 'grade': {'enum': ['A', 'B', 'C', 'D', 'F'], 'type': 'string'}, 'score': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'cached': {'type': 'boolean', 'description': 'True when this request reused a report already in the server cache.'}, 'pillars': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'axis', 'earned', 'available'], 'properties': {'id': {'type': 'string'}, 'axis': {'type': 'string'}, 'name': {'type': 'string'}, 'earned': {'type': 'number'}, 'available': {'type': 'number'}}}}, 'excluded': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'reason'], 'properties': {'id': {'type': 'string'}, 'title': {'type': 'string'}, 'reason': {'type': 'string'}}}}, 'fixFirst': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'finding', 'fix', 'points'], 'properties': {'id': {'type': 'string'}, 'fix': {'type': 'string'}, 'title': {'type': 'string'}, 'points': {'type': 'number'}, 'finding': {'type': 'string'}}}, 'maxItems': 5}, 'fetchedAt': {'type': 'string', 'description': 'ISO 8601'}, 'reportUrl': {'type': 'string', 'format': 'uri'}, 'methodology': {'type': 'string', 'format': 'uri'}}}
watch_site
Watch a site's score
Use this only when the user explicitly asks to be emailed when a site's Agent Readiness Score changes. Sends a confirmation email for monitoring that site. Use only when the user explicitly asks to receive a confirmation email for monitoring at the supplied address. Set sendConfirmationEmail to true only then. Monitoring starts only after the recipient opens the link and confirms on the page; this call itself sends one email.
Open world
Input schema
{'type': 'object', 'required': ['url', 'email', 'sendConfirmationEmail'], 'properties': {'url': {'type': 'string', 'description': 'Public http(s) address or bare host, for example example.com'}, 'email': {'type': 'string', 'description': 'Address that will receive the confirmation and the alerts'}, 'sendConfirmationEmail': {'type': 'boolean', 'const': True, 'description': 'True only after the user explicitly requests a monitoring confirmation email.'}}}
Output schema
{'type': 'object', 'required': ['status', 'email', 'host', 'message'], 'properties': {'host': {'type': 'string'}, 'email': {'type': 'string'}, 'status': {'enum': ['confirmation-sent'], 'type': 'string'}, 'message': {'type': 'string'}}}
Changed
watch_site
Oct. 3, 2026, 3:02 a.m.
Changed
get_badge_embed
Oct. 3, 2026, 3:02 a.m.
Changed
list_checks
Oct. 3, 2026, 3:02 a.m.
Changed
explain_check
Oct. 3, 2026, 3:02 a.m.
Changed
score_site
Oct. 3, 2026, 3:02 a.m.
Changed
watch_site
Sept. 27, 2026, 2:54 a.m.
Changed
score_site
Sept. 27, 2026, 2:54 a.m.
Added
watch_site
Sept. 17, 2026, 12:38 p.m.
Added
get_badge_embed
Sept. 17, 2026, 12:38 p.m.
Added
list_checks
Sept. 17, 2026, 12:38 p.m.
Added
explain_check
Sept. 17, 2026, 12:38 p.m.
Added
score_site
Sept. 17, 2026, 12:38 p.m.