npm package: @ordinaryfuture/agent-readiness-mcp
Description: MCP server that scans any website for AI agent readiness — checks 21 signals across 5 categories, generates fix files
Author: Ordinary Future
Latest version: 0.1.0

# 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:

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

### Local Installation

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

### From Source

```bash
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](https://ordinaryfuture.ai) — building infrastructure for the agent economy.