How to make your API agent-ready (a prioritized checklist)
The fixes that move your Discry Score the most, in order.
Start with discovery
Most APIs lose more points on Discovery than Comprehension — the signature finding across the Index. Ship an OpenAPI spec, a focused llms.txt, and an AGENTS.md first; add an MCP manifest at .well-known/mcp.json if you expose tools.
Then tighten comprehension
Rewrite endpoint descriptions to be task-oriented (“charge a customer,” not “POST /charges”), add realistic runnable examples, document multi-step workflows end to end, and write real error-recovery guidance.
Then defend it
Discoverability regresses silently on every deploy. Re-scan on a schedule so a refactor that drops your llms.txt doesn’t quietly cost you the agent channel. That’s what Monitor and the CI gate are for.
Want the prioritized list for your API specifically? Run a free scan.