Agent Readiness Scanner — MCP Server

Scan any website and get an instant AI agent readiness score. Checks 21 signals across 5 categories, returns a 0-100 grade, and generates ready-to-deploy fix files (llms.txt, agent-card.json, robots.txt).

Why it matters: AI agents are becoming a major traffic source. Sites that aren't agent-discoverable are invisible to ChatGPT, Claude, Perplexity, and the growing ecosystem of autonomous agents. This scanner tells you exactly what's missing and generates the files to fix it.

Tools

scan_url

Full 21-check audit. Returns score, grade, detailed results per check, and auto-generated fix files.

Example prompt: "Scan stripe.com for agent readiness"

quick_check

Fast check of the 5 most critical signals: llms.txt, agent-card.json, robots.txt AI directives, JSON-LD, and HTTPS. Use when you need a quick yes/no on agent visibility.

Example prompt: "Quick check if shopify.com is agent-ready"

generate_fixes

Scan and return copy-paste fix files. Generates llms.txt, agent-card.json, and robots.txt additions customized to the target site.

Example prompt: "Generate agent readiness fix files for my-saas.com"

What It Checks (21 Signals)

| Category | Points | Signals | |----------|--------|---------| | Discoverability | 35 | llms.txt, llms-full.txt, agent-card.json (A2A), robots.txt AI directives, sitemap.xml, AGENTS.md | | Structured Data | 25 | JSON-LD, OpenGraph tags, meta description, title tag | | Content Quality | 20 | Product description, features section, pricing info, FAQ | | Technical | 10 | HTTPS, response time, viewport, H1 heading | | API/Agent | 10 | API documentation, developer docs, auth documentation |

Grading Scale

| Grade | Score | Meaning | |-------|-------|---------| | A | 81-100 | Fully agent-optimized | | B | 61-80 | Good foundation, minor gaps | | C | 41-60 | Partially visible to agents | | D | 21-40 | Major gaps in agent readiness | | F | 0-20 | Invisible to AI agents |

Usage

Claude Desktop / Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "agent-readiness": {
      "command": "npx",
      "args": ["-y", "@ordinaryfuture/agent-readiness-mcp"]
    }
  }
}

Local Installation

npm install -g @ordinaryfuture/agent-readiness-mcp
agent-readiness-mcp

From Source

git clone https://github.com/ordinary-future/agent-readiness-mcp
cd agent-readiness-mcp
npm install && npm run build
node dist/index.js

Use Cases

• SEO/GEO Agencies: Audit client sites for AI agent visibility before proposing optimization work
• SaaS Founders: Check if your product is discoverable by AI assistants and autonomous agents
• Developers: Validate llms.txt, agent-card.json, and A2A protocol compliance
• Content Teams: Understand how AI crawlers see your site vs human visitors

Built By

Ordinary Future — building infrastructure for the agent economy.