{"id":"ia.agents-json","name":"agents.json","verify":{"command":"curl -sf https://{domain}/.well-known/agents.json | jq -e 'type == \"object\"'","rescan":"isagentready results {domain} --checkpoint ia.agents-json","expect":"exit code 0"},"fix":{"steps":[{"action":"Create /.well-known/agents.json with one entry per agent endpoint.","order":1,"language":"json","code_example":"{\n  \"agents\": [{\"name\": \"Example agent\", \"url\": \"https://example.com/a2a\", \"protocol\": \"a2a\"}]\n}"}],"summary":"Publish /.well-known/agents.json with your agent endpoints.","skill":{"name":"agent-protocols","anchor":"ia.agents-json"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"A2A 1.0 specification","kind":"spec","url":"https://a2a-protocol.org/latest/specification/"},{"title":"Model Context Protocol","kind":"guide","url":"https://modelcontextprotocol.io"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-22","evidence_tier":"experimental","evidence_source":{"title":"A2A 1.0 specification","url":"https://a2a-protocol.org/latest/specification/"},"why":"agents.json provides a directory of AI agent endpoints on your site. It helps agent orchestration systems discover and connect to your available AI services.","profiles":["api_tool_readiness"],"score_role":"informational","legacy_id":"4.6","i18n":{"nl":{"name":"agents.json","steps":["Maak /.well-known/agents.json met een entry per agentendpoint."],"why":"agents.json geeft een overzicht van de AI-agentendpoints op je site. Het helpt orchestratiesystemen om je AI-services te vinden en te verbinden.","fix_summary":"Publiceer /.well-known/agents.json met je agentendpoints.","verify_expect":"exitcode 0"}},"ar_practice_ids":[],"strength":"MAY","ar_mapping":"none","evidence_type":"recommendation","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.agents-json","maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api"]}}