Agent Ready
@mlava
AI agent readability scanner — score any public URL against the Vercel Agent Readability Spec, llmstxt.org, and 6 agent-protocol manifests (MCP, A2A, agents.json, agent-permissions, UCP, x402). 59 checks with per-check fix guidance. Same engine as agent-ready.dev.
Overview
What is Agent Ready?
Agent Ready is an AI agent readability scanner that takes any public URL and returns a 0–100 score with per-check remediation hints. It wraps the same engine powering agent-ready.dev and lets Claude Desktop, Claude Code, Cursor, Cline, VS Code, and Windsurf run scans inline and explain results.
How to use Agent Ready?
Configure the MCP server in your client’s mcpServers setting using npx -y agent-ready-mcp@latest and set the AGENT_READY_API_KEY environment variable (Pro or Team tier required). Once connected, use the scan_site tool to run a fresh scan or get_scan to fetch a previous scan by id. Prompts like scan, interpret_scan, and remediation_plan provide plain‑English summaries and prioritized fix documentation.
Key features of Agent Ready
- 59 checks across 4 spec families (Vercel, llmstxt, agent‑protocol manifests).
- Every failing check includes a concrete
howToFixstring. - Two tools:
scan_site(fresh scan) andget_scan(retrieve by id). - Three prompts:
scan,interpret_scan, andremediation_plan. - Ships a Claude Skill descriptor for activation routing.
- Runs via npm, hosted HTTP, or on Smithery.
Use cases of Agent Ready
- Evaluate your own site’s agent readability before deploying.
- Review a competitor’s public URL for missing llms.txt or agent manifests.
- Integrate inline scans into Claude Desktop or Cursor to get remediation hints.
- Generate a prioritized fix plan focused on SEO or agent‑specific issues.
- Validate that a URL satisfies the Vercel Agent Readability Spec.
FAQ from Agent Ready
What API key do I need?
Issue a Pro API key from the dashboard at agent-ready.dev/dashboard/api-keys. The MCP server requires a Pro or Team tier subscription; free‑tier scans are available through the web UI only.
What transports does Agent Ready support?
The MCP server can be run locally via npx (stdio transport) or as a hosted Streamable HTTP endpoint at https://agent-ready.dev/api/v1/mcp (Bearer authentication).
How is Agent Ready different from the web UI?
The MCP server provides programmatic access from AI clients (Claude Desktop, Cursor, etc.) and includes prompts for interpretation and remediation. The web UI offers free‑tier scans.
Does Agent Ready require an internet connection?
Yes, the server must reach agent-ready.dev to run scans. Scans are performed against public URLs you provide.
What are the 59 checks divided into?
38 checks against the Vercel Agent Readability Spec, 10 against the llmstxt.org specification, and 11 against agent‑protocol manifests (MCP Server Cards, A2A Agent Cards, agents.json, agent-permissions.json, UCP, x402 Payment Required).