{"id":"ia.agents-md","name":"AGENTS.md agent guide","verify":{"command":"curl -sf https://{domain}/AGENTS.md","rescan":"isagentready results {domain} --checkpoint ia.agents-md","expect":"HTTP 200 with a Markdown guide"},"fix":{"steps":[{"action":"Create /AGENTS.md with sections for the offer, the endpoints, the auth and the rules for agents.","order":1,"language":"markdown","code_example":"# Example for agents\n\n## Connect\n- MCP: https://example.com/mcp\n- API: https://example.com/openapi.json\n\n## Auth\nOAuth 2.0 with PKCE. See /auth.md."},{"action":"Serve the file with Content-Type text/markdown and HTTP 200.","order":2,"language":null,"code_example":null}],"summary":"Publish /AGENTS.md that tells agents what the site offers and how to connect.","skill":{"name":"ai-content-discovery","anchor":"ia.agents-md"}},"category":"discovery","aggregate":null,"references":[{"title":"AGENTS.md convention","kind":"guide","url":"https://agents.md/"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-22","evidence_tier":"emerging","evidence_source":{"title":"AGENTS.md convention","url":"https://agents.md/"},"why":"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.","profiles":["ai_search_visibility"],"score_role":"bonus","legacy_id":"1.11","i18n":{"nl":{"name":"AGENTS.md-agentgids","steps":["Maak /AGENTS.md met secties voor het aanbod, de endpoints, de auth en de regels voor agents.","Lever het bestand met Content-Type text/markdown en HTTP 200."],"why":"AGENTS.md is een opkomende gids in de root die AI-agents vertelt wat je site biedt en hoe ze ermee werken: endpoints, tools, auth en regels. Agents zoeken steeds vaker naar /AGENTS.md naast llms.txt en de /.well-known-bestanden.","fix_summary":"Publiceer /AGENTS.md dat agents vertelt wat de site biedt en hoe ze verbinden.","verify_expect":"HTTP 200 met een Markdown-handleiding"}},"ar_practice_ids":[],"strength":"MAY","ar_mapping":"none","evidence_type":"recommendation","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.agents-md","maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]}}