Reference

Overview

What ai-readiness is and every way to run it.

ai-readiness

ai-readiness answers one question: can AI search engines (ChatGPT, Perplexity, Claude, Google AI Overviews) crawl and understand your website? It fetches the page plus robots.txt, sitemap.xml, and llms.txt, runs six weighted checks, and returns a 0-100 score with a letter grade and a specific fix for each gap.

It is dependency-free Node (no npm installs at runtime), MIT licensed, and ships four ways to run the same engine (lib.js):

  1. CLI: npx -y github:epistemedeus/ai-readiness yoursite.com (details)
  2. MCP server (stdio): npx -y github:epistemedeus/ai-readiness mcp for Claude Desktop, Cursor, Cline, and other local MCP clients
  3. MCP server (streamable HTTP): a stateless CORS-enabled HTTP transport for remote MCP clients (details)
  4. Library: import { run, generateFix, AI_CRAWLERS } (details)

There is also a hosted UI at samedaydesk.com/tools/ai-readiness, which is this project's declared homepage (manifest.json).

The two MCP tools, check_ai_readiness and generate_ai_readiness_fixes, are documented with their full input schemas in the MCP Reference tab of this site.

Built withSourcey