AGENTS.md agent guide
ia.agents-md · 1.11
Why it matters
AGENTS.md is an emerging root-level guide that tells AI agents what your site offers and how to interact with it: endpoints, tools, auth, and etiquette. Agents increasingly probe /AGENTS.md as part of their discovery sequence, alongside llms.txt and the /.well-known manifests.
How to fix it
Publish /AGENTS.md that tells agents what the site offers and how to connect.
-
Create /AGENTS.md with sections for the offer, the endpoints, the auth and the rules for agents.
# Example for agents ## Connect - MCP: https://example.com/mcp - API: https://example.com/openapi.json ## Auth OAuth 2.0 with PKCE. See /auth.md. -
Serve the file with Content-Type text/markdown and HTTP 200.
Verify
curl -sf https://{domain}/AGENTS.md
Expected: HTTP 200 with a Markdown guide
Run a new scan for this checkpoint:
isagentready results {domain} --checkpoint ia.agents-md
Details Mapping, lifecycle and references
- AR mapping
- No AR practice
- Evidence source
- AGENTS.md convention
- Score role
- Bonus
- Introduced
- 2026-08-24
- Methodology version
- 2026-10-22