{"id":"ia.ai-catalog","name":"AI Catalog","verify":{"command":"curl -sS -D - https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.ai-catalog","expect":"The homepage head and HTTP Link header advertise the same catalog. Fetch that URL and check specVersion and valid entries; a link from llms.txt alone does not satisfy both advertisements."},"fix":{"steps":[{"action":"Create /.well-known/ai-catalog.json with specVersion and entries. Give each entry an identifier, a media type and exactly one same-origin URL or inline data value.","order":1,"language":"json","code_example":"{\n  \"specVersion\": \"1.0\",\n  \"entries\": [\n    {\n      \"identifier\": \"urn:air:example:mcp\",\n      \"type\": \"application/mcp-server-card+json\",\n      \"url\": \"https://example.com/mcp/server-card\"\n    },\n    {\n      \"identifier\": \"urn:air:example:openapi\",\n      \"type\": \"application/openapi+json\",\n      \"url\": \"https://example.com/openapi.json\"\n    }\n  ]\n}"},{"action":"Serve the file as application/json with HTTP 200.","order":2,"language":null,"code_example":null},{"action":"Add a link rel=\"ai-catalog\" in the homepage head and an equivalent HTTP Link header that points to the same catalog.","order":3,"language":"html","code_example":"<link rel=\"ai-catalog\" href=\"/.well-known/ai-catalog.json\">\n\nLink: </.well-known/ai-catalog.json>; rel=\"ai-catalog\""}],"summary":"Publish a valid AI Catalog and advertise it from the homepage head and HTTP Link header.","skill":{"name":"agent-protocols","anchor":"ia.ai-catalog"}},"category":"agent_protocols","aggregate":null,"references":[],"expected":"A valid same-origin AI Catalog advertised by both a homepage-head link rel=ai-catalog and an equivalent HTTP Link header.","stage":"find","lifecycle":{"introduced":"2026-08-24","revised":["2026-10-30"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-FIND-04","url":"https://www.agentready.org/#reachable"},"why":"An AI Catalog gives agents one machine-readable list of the AI resources of a site: MCP servers, APIs, skills and docs. Agents find it through links, so link it from the home page.","profiles":["api_tool_readiness"],"score_role":"bonus","ar_strengths":{"AR-FIND-04":"MAY"},"ar_practice_ids":["AR-FIND-04"],"legacy_id":"4.21","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.ai-catalog","strength_source":"agentready","i18n":{"nl":{"name":"AI Catalog","steps":["Maak /.well-known/ai-catalog.json met specVersion en entries. Geef elke entry een identifier, een mediatype en precies één same-origin URL of inline datawaarde.","Lever het bestand als application/json met HTTP 200.","Voeg een link rel=\"ai-catalog\" toe aan de head van de homepage en een overeenkomstige HTTP Link-header die naar dezelfde catalogus verwijst."],"why":"Een AI Catalog geeft agents een machineleesbare lijst van de AI-resources van een site: MCP-servers, API's, skills en docs. Agents vinden het via links, dus link het vanaf de homepage.","verify_expect":"De head van de homepage en de HTTP Link-header verwijzen naar dezelfde catalogus. Haal die URL op en controleer specVersion en geldige entries; alleen een link vanuit llms.txt voldoet niet aan beide verwijzingen.","fix_summary":"Publiceer een geldige AI Catalog en vermeld deze in de homepage-head en HTTP Link-header."}},"maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MAY","ar_mapping":"full","evidence_type":"recommendation"}