AGENTS.md for APIs: the file coding agents look for
How to tell an AI coding agent how to build on your API — in the file it already checks.
Why AGENTS.md
Coding agents increasingly look for an AGENTS.md at a project or docs root: a concise brief on how to work with your system — conventions, auth setup, the golden-path example, gotchas.
For an API producer, it’s where you hand an agent the “start here” it would otherwise reconstruct by trial and error.
What to put in it
The minimal viable integration (get a key → make one authenticated call → read the response), your naming conventions, rate-limit and pagination rules, and the two or three mistakes agents most commonly make against your API.
How Discry scores it
A usable AGENTS.md is one of the discovery signals Discry credits. It’s low-effort, high-signal — one of the most common quick wins in our recommendations.