RESOURCES
Make your API agent-ready.
Field guides to the signals that decide whether AI agents can discover and understand your API — with live adoption data on the signal pages and definitions in the glossary.
01
What Is API Agent-Readiness? The Complete Guide
Agent-readiness: whether an AI agent can find, understand, and correctly call your API from its public docs — how it's measured and where to start.
10 min02Why a Docs Vendor Can't Run the Docs Benchmark
7 min03Why AI Agents Pick One API Over Another
8 minField guides
- AEO Gets You Into the Answer. ADO Gets You Into the Action.AEO earns the citation when an AI answers a question. Agent discovery optimization earns the workload when an agent acts. What each covers, with data.7 min
- AGENTS.md: What It Is and How to Write One for Your APIAGENTS.md is a README for coding agents. What the open format specifies, why only 30% of scanned APIs ship one, and how to write one for your API.7 min
- Documenting Multi-Step Workflows So Agents Can Sequence Your APIReference docs describe endpoints in isolation. Agents need the ordered sequence. What an API workflow doc contains, where it lives, and a worked example.8 min
- Error Docs an AI Agent Can Actually Recover FromWhat AI agents do when API error documentation fails them, and how to write error responses, catalogs, and retry guidance an agent can recover from.8 min
- How to Write an llms.txt for Your API (with Examples)The llms.txt format explained against the spec, a worked example for an API, the size discipline that matters, and real failure modes from live scans.8 min
- Make Your OpenAPI Spec Agent-ReadableAI agents construct API calls from your OpenAPI spec. How to publish it, name operations, document errors, and add examples agents can build from.7 min
- MCP Servers Explained (for API Teams)What an MCP server is, what it exposes, and how the manifest and registry make it discoverable — for API teams deciding whether to ship one.7 min
- robots.txt for AI Crawlers: GPTBot, ClaudeBot, Google-ExtendedCopy-paste robots.txt recipes for GPTBot, ClaudeBot, and Google-Extended — protect your content without making your API's docs invisible to AI agents.7 min
- Token-Efficient API Docs: Why Verbosity Costs You Agent TrafficAgents read your API docs inside a finite context window. Verbose docs get truncated, skimmed, or skipped — here's how to cut token weight, not facts.7 min
- quick referenceWhat is llms.txt — and why your API needs oneThe single highest-leverage file for making your API discoverable to AI agents.6 min
- quick referenceAGENTS.md for APIs: the file coding agents look forHow to tell an AI coding agent how to build on your API — in the file it already checks.5 min
- quick referenceHow to make your API agent-ready (a prioritized checklist)The fixes that move your Discry Score the most, in order.8 min