Skip to content
Methodology

AGENTS.md agent guide

ia.agents-md · 1.11

Act MAY Recommendation

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.

  1. 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.
  2. 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

Checkpoint data (JSON)