Agent-Readiness Grade

Agent-Readiness Grade / Fix guides

Fix guides: how to pass every Agent-Readiness Grade check

One hand-written guide per check the grade runs: what it looks for, why it matters to AI crawlers and agents (with the vendor's own documentation), copy-paste fixes for static sites, WordPress, Next.js and Cloudflare, and how to verify.

Checked 2026-09-30 against grader version 1.3.0 and the vendor documentation each guide cites.

Crawler access (robots.txt) 0-2 points

robots.txt parsed by user-agent group for eight AI crawler tokens: 2 when none is blocked, 1 when one to three are, 0 when four or more are.

robots.txt for AI crawlers

robots.txt groups for eight AI crawler tokens; a blanket Disallow: / counts as blocked.

Machine-readable surfaces 0-2 points

Seven files fetched: one point for a sitemap (the file or a Sitemap: line in robots.txt), one for /llms.txt or /ai.txt, one for any agent surface (agent-card.json, openapi.json, mcp-registry-auth or /.well-known/x402), capped at 2. A catch-all HTML page never counts.

sitemap.xml

An XML sitemap at /sitemap.xml, or a Sitemap: line in robots.txt pointing anywhere.

llms.txt

A Markdown guide to your key pages at /llms.txt, served as text, not as your HTML 404.

ai.txt

An alternative to llms.txt for the same point; no crawler vendor documents reading it.

agent-card.json

The A2A agent card at /.well-known/agent-card.json; one of four files for the agent-surface point.

openapi.json

Your API described at /openapi.json; one of four files for the agent-surface point.

x402 manifest

A JSON list of your x402 paid routes at /.well-known/x402; only if you sell per request.

mcp-registry-auth

The public-key proof at /.well-known/mcp-registry-auth; only if you publish MCP servers.

Readable without JavaScript 0-2 points

The home page as a plain fetch sees it: visible text, external scripts, empty root containers and bot challenges.

Readable without JavaScript

The home page as a plain fetch sees it: enough visible text, no empty #root, no challenge.

Structured data 0-2 points

One point for a JSON-LD block that parses, one for og:title plus og:description on the home page.

Structured data

One JSON-LD block that parses plus og:title and og:description on the home page.

MCP census entry 0-2 points

One point for an endpoint at /mcp, one for being listed in the agent-economy index of hosts that sell to agents.

MCP endpoint and census

An MCP endpoint at /mcp, and a listing among hosts that sell to agents through x402.

Free generators

llms.txt generator

Drafts an llms.txt from a site's home page and sitemap.

robots.txt for AI crawlers

Allow or block 14 AI crawler tokens, with each vendor's documentation linked.

agent-card.json generator

Builds an A2A 1.0 agent card with required fields checked.

security.txt generator

Writes an RFC 9116 security.txt with the required fields checked.

$49 AI Visibility Full Report

The fixes on this site are free. The paid next step is the $49 AI Visibility Full Report (what ChatGPT, Claude and Perplexity say about your brand, with a prioritized fix list) from aivisibility.agentexchange.work. It includes:

Get the Full Report — $49 Stripe checkout; you enter your brand and site right after paying.