{"count":82,"methodology_version":"2026-10-30","checkpoints":[{"id":"ia.robots-txt","name":"robots.txt present","verify":{"command":"curl -sf https://{domain}/robots.txt","rescan":"isagentready results {domain} --checkpoint ia.robots-txt","expect":"HTTP 200 with a text body that contains a User-agent line"},"fix":{"steps":[{"action":"Create a file at the site root with the name robots.txt.","order":1,"language":null,"code_example":null},{"action":"Add a User-agent group with Allow or Disallow rules that follow RFC 9309.","order":2,"language":"text","code_example":"User-agent: *\nAllow: /\n\nSitemap: https://example.com/sitemap.xml"},{"action":"Serve the file with HTTP 200 and the Content-Type text/plain.","order":3,"language":null,"code_example":null}],"summary":"Serve a plain-text /robots.txt with at least one valid User-agent group.","skill":{"name":"ai-content-discovery","anchor":"ia.robots-txt"}},"category":"discovery","aggregate":null,"references":[{"title":"Google robots.txt specification","kind":"guide","url":"https://developers.google.com/search/docs/crawling-indexing/robots/intro"},{"title":"RFC 9309 - Robots Exclusion Protocol","kind":"spec","url":"https://www.rfc-editor.org/rfc/rfc9309"}],"expected":"HTTP 200 text/plain document with at least one User-agent group","stage":"find","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02","2026-10-30"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-FIND-01","url":"https://www.agentready.org/#reachable"},"why":"robots.txt is the universal standard for telling crawlers what they can access. AI crawlers like GPTBot, ClaudeBot and Googlebot-Extended check this file first before crawling your site.","profiles":["ai_search_visibility"],"score_role":"core","ar_strengths":{"AR-FIND-01":"MUST"},"ar_practice_ids":["AR-FIND-01"],"legacy_id":"1.1","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.robots-txt","strength_source":"agentready","i18n":{"nl":{"name":"robots.txt aanwezig","steps":["Maak in de root van de site een bestand met de naam robots.txt.","Voeg een User-agent-groep toe met Allow- of Disallow-regels volgens RFC 9309.","Lever het bestand met HTTP 200 en het Content-Type text/plain."],"why":"robots.txt is de standaard die crawlers vertelt wat ze mogen ophalen. AI-crawlers zoals GPTBot en ClaudeBot lezen dit bestand eerst.","verify_expect":"HTTP 200 met een tekstbody die een User-agent-regel bevat","fix_summary":"Lever een /robots.txt als platte tekst met minimaal een geldige User-agent-groep."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"full","evidence_type":"scanner_data"},{"id":"ia.ai-crawler-directives","name":"AI crawler directives","verify":{"command":"curl -sf https://{domain}/robots.txt","rescan":"isagentready results {domain} --checkpoint ia.ai-crawler-directives","expect":"No Disallow: / rule applies to GPTBot, ClaudeBot or the * group"},"fix":{"steps":[{"action":"Find the rules in robots.txt that block AI user agents such as GPTBot, ClaudeBot and PerplexityBot.","order":1,"language":null,"code_example":null},{"action":"Add an explicit Allow group for each AI user agent that may fetch your public pages.","order":2,"language":"text","code_example":"User-agent: GPTBot\nAllow: /\n\nUser-agent: ClaudeBot\nAllow: /\n\nUser-agent: PerplexityBot\nAllow: /"},{"action":"Keep Disallow rules only for private paths, for example /account.","order":3,"language":null,"code_example":null}],"summary":"Let the common AI user agents fetch your public pages in robots.txt.","skill":{"name":"ai-content-discovery","anchor":"ia.ai-crawler-directives"}},"category":"discovery","aggregate":null,"references":[{"title":"Google robots.txt specification","kind":"guide","url":"https://developers.google.com/search/docs/crawling-indexing/robots/intro"},{"title":"RFC 9309 - Robots Exclusion Protocol","kind":"spec","url":"https://www.rfc-editor.org/rfc/rfc9309"},{"title":"OpenAI GPTBot documentation","kind":"guide","url":"https://platform.openai.com/docs/bots/gptbot"}],"stage":"find","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02","2026-10-30"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-FIND-01","url":"https://www.agentready.org/#reachable"},"why":"robots.txt determines which paths crawlers may fetch. This checkpoint measures effective crawl access for common AI user agents; it does not infer training consent.","profiles":["ai_search_visibility"],"score_role":"core","ar_strengths":{"AR-FIND-01":"MUST"},"ar_practice_ids":["AR-FIND-01"],"legacy_id":"1.2","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.ai-crawler-directives","strength_source":"agentready","i18n":{"nl":{"name":"AI-crawlerrichtlijnen","steps":["Zoek de regels in robots.txt die AI-user-agents zoals GPTBot, ClaudeBot en PerplexityBot blokkeren.","Voeg een expliciete Allow-groep toe voor elke AI-user-agent die je publieke pagina's mag ophalen.","Houd Disallow-regels alleen voor privepaden, bijvoorbeeld /account."],"why":"robots.txt bepaalt welke paden crawlers mogen ophalen. Dit checkpoint meet de toegang voor bekende AI-user-agents. Het zegt niets over toestemming voor training.","verify_expect":"Geen regel Disallow: / geldt voor GPTBot, ClaudeBot of de groep *","fix_summary":"Geef de bekende AI-user-agents in robots.txt toegang tot je publieke pagina's."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"full","evidence_type":"scanner_data"},{"id":"ia.xml-sitemap","name":"XML sitemap","verify":{"command":"curl -sf https://{domain}/sitemap.xml","rescan":"isagentready results {domain} --checkpoint ia.xml-sitemap","expect":"HTTP 200 with an XML body that contains urlset or sitemapindex"},"fix":{"steps":[{"action":"Generate a sitemap.xml with a urlset or a sitemapindex root element.","order":1,"language":"xml","code_example":"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n  <url><loc>https://example.com/</loc><lastmod>2026-10-01</lastmod></url>\n</urlset>"},{"action":"Add a Sitemap directive to robots.txt.","order":2,"language":"text","code_example":"Sitemap: https://example.com/sitemap.xml"}],"summary":"Publish an XML sitemap and reference it in robots.txt.","skill":{"name":"ai-content-discovery","anchor":"ia.xml-sitemap"}},"category":"discovery","aggregate":null,"references":[{"title":"Sitemaps XML protocol specification","kind":"guide","url":"https://www.sitemaps.org/protocol.html"},{"title":"Google - Build and submit a sitemap","kind":"guide","url":"https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap"}],"expected":"Valid XML sitemap that robots.txt references","stage":"find","lifecycle":{"introduced":"2026-08-24","revised":["2026-10-30"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-FIND-03","url":"https://www.agentready.org/#reachable"},"why":"Sitemaps help AI crawlers discover all your pages efficiently. Without one, crawlers may miss important content or waste time discovering your site structure.","profiles":["ai_search_visibility"],"score_role":"core","ar_strengths":{"AR-FIND-03":"SHOULD"},"ar_practice_ids":["AR-FIND-03"],"legacy_id":"1.3","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.xml-sitemap","strength_source":"agentready","i18n":{"nl":{"name":"XML-sitemap","steps":["Genereer een sitemap.xml met een urlset- of sitemapindex-rootelement.","Voeg een Sitemap-regel toe aan robots.txt."],"why":"Een sitemap helpt AI-crawlers om alle pagina's snel te vinden. Zonder sitemap missen crawlers belangrijke content.","verify_expect":"HTTP 200 met een XML-body die urlset of sitemapindex bevat","fix_summary":"Publiceer een XML-sitemap en verwijs ernaar in robots.txt."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"measured_study"},{"id":"ia.llms-txt","name":"llms.txt","verify":{"command":"curl -sf https://{domain}/llms.txt","rescan":"isagentready results {domain} --checkpoint ia.llms-txt","expect":"HTTP 200 with a Markdown body that starts with an H1 and contains links"},"fix":{"steps":[{"action":"Create /llms.txt with an H1 title and a one-line blockquote summary.","order":1,"language":"markdown","code_example":"# Example\n\n> Example sells project software for small teams.\n\n## Docs\n\n- [Quick start](https://example.com/docs/start): set up an account\n- [API reference](https://example.com/docs/api): REST endpoints"},{"action":"Link only to pages on the canonical host that return HTTP 200.","order":2,"language":null,"code_example":null},{"action":"Link /llms.txt from the home page or from a Link header so that agents find it.","order":3,"language":null,"code_example":null}],"summary":"Publish /llms.txt with an H1, a summary and Markdown links to your key pages on the canonical host.","skill":{"name":"ai-content-discovery","anchor":"ia.llms-txt"}},"category":"discovery","aggregate":null,"references":[{"title":"llms.txt specification","kind":"guide","url":"https://llmstxt.org/"},{"title":"llms.txt proposal by Jeremy Howard","kind":"guide","url":"https://www.answer.ai/posts/2024-09-03-llmstxt.html"}],"expected":"Markdown file with an H1 and links to pages on the same host","stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-READ-07","url":"https://www.agentready.org/#read"},"why":"llms.txt gives AI agents a curated entry point to your most important pages. Agents that fetch pages to complete a task get a short, structured overview instead of the full site.","profiles":["ai_search_visibility"],"score_role":"bonus","ar_strengths":{"AR-READ-07":"SHOULD"},"ar_practice_ids":["AR-READ-07"],"legacy_id":"1.4","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.llms-txt","strength_source":"agentready","i18n":{"nl":{"name":"llms.txt","steps":["Maak /llms.txt met een H1-titel en een samenvatting van een regel als blockquote.","Link alleen naar pagina's op de canonieke host die HTTP 200 geven.","Link /llms.txt vanaf de homepage of via een Link-header, zodat agents het vinden."],"why":"llms.txt geeft AI-agents een samengesteld startpunt naar je belangrijkste pagina's. Agents die pagina's ophalen voor een taak krijgen een kort, gestructureerd overzicht in plaats van de hele site.","verify_expect":"HTTP 200 met een Markdown-body die begint met een H1 en links bevat","fix_summary":"Publiceer /llms.txt met een H1, een samenvatting en Markdown-links naar je belangrijkste pagina's op de canonieke host."}},"maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"measured_study"},{"id":"ia.meta-robots","name":"Meta robots / X-Robots-Tag","verify":{"command":"curl -sI https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.meta-robots","expect":"No X-Robots-Tag header with noindex, noai or nosnippet"},"fix":{"steps":[{"action":"Find noindex, nofollow, nosnippet, noai or noimageai in meta robots tags and in X-Robots-Tag headers.","order":1,"language":null,"code_example":null},{"action":"Remove the directives from public pages, or set index and follow.","order":2,"language":"html","code_example":"<meta name=\"robots\" content=\"index, follow\">"}],"summary":"Remove restrictive robots directives from pages that agents must use.","skill":{"name":"ai-content-discovery","anchor":"ia.meta-robots"}},"category":"discovery","aggregate":null,"references":[{"title":"Google - Robots meta tag and X-Robots-Tag","kind":"guide","url":"https://developers.google.com/search/docs/crawling-indexing/robots-meta-tag"},{"title":"MDN - Robots meta tag","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/meta/name#robots"}],"stage":"find","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-FIND-01","url":"https://www.agentready.org/#reachable"},"why":"Meta robots tags and X-Robots-Tag headers control per-page indexing. Restrictive directives like noindex or noai prevent AI systems from using your content.","profiles":["ai_search_visibility"],"score_role":"core","ar_strengths":{"AR-FIND-01":"MUST"},"ar_practice_ids":["AR-FIND-01"],"legacy_id":"1.5","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.meta-robots","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Meta robots / X-Robots-Tag","steps":["Zoek noindex, nofollow, nosnippet, noai of noimageai in meta robots-tags en in X-Robots-Tag-headers.","Verwijder de richtlijnen van publieke pagina's, of zet index en follow."],"why":"Meta robots-tags en X-Robots-Tag-headers sturen de indexering per pagina. Richtlijnen zoals noindex of noai houden AI-systemen weg van je content.","verify_expect":"Geen X-Robots-Tag-header met noindex, noai of nosnippet","fix_summary":"Verwijder beperkende robots-richtlijnen van pagina's die agents moeten gebruiken."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"partial","evidence_type":"scanner_data"},{"id":"ia.content-freshness","name":"Content freshness signals","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.content-freshness","expect":null},"fix":{"steps":[{"action":"Add datePublished and dateModified to the Article JSON-LD of each editorial page.","order":1,"language":"json","code_example":"{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"Article\",\n  \"datePublished\": \"2026-09-01\",\n  \"dateModified\": \"2026-10-01\"\n}"},{"action":"Add the Open Graph tag article:modified_time with the same date.","order":2,"language":"html","code_example":"<meta property=\"article:modified_time\" content=\"2026-10-01T09:00:00Z\">"},{"action":"Update dateModified only when the content changes.","order":3,"language":null,"code_example":null}],"summary":"Publish machine-readable publication and modification dates on editorial pages.","skill":{"name":"ai-content-discovery","anchor":"ia.content-freshness"}},"category":"discovery","aggregate":null,"references":[{"title":"Schema.org dateModified property","kind":"spec","url":"https://schema.org/dateModified"},{"title":"Open Graph article:modified_time","kind":"guide","url":"https://ogp.me/#type_article"}],"stage":"find","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"Schema.org dateModified property","url":"https://schema.org/dateModified"},"why":"Editorial pages can publish machine-readable modification and publication dates. This checkpoint validates those values only after the page is identified as editorial content.","profiles":["ai_search_visibility"],"score_role":"bonus","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"1.6","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.content-freshness","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Signalen voor actualiteit","steps":["Voeg datePublished en dateModified toe aan de Article-JSON-LD van elke redactionele pagina.","Voeg de Open Graph-tag article:modified_time met dezelfde datum toe.","Wijzig dateModified alleen als de content verandert."],"why":"Redactionele pagina's kunnen machineleesbare publicatie- en wijzigingsdatums publiceren. Dit checkpoint controleert die waarden alleen op redactionele content.","verify_expect":null,"fix_summary":"Publiceer machineleesbare publicatie- en wijzigingsdatums op redactionele pagina's."}},"maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MAY","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.markdown-negotiation","name":"Content negotiation (text/markdown)","verify":{"command":"curl -s -o /dev/null -w '%{content_type}\\n' -H 'Accept: text/markdown' https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.markdown-negotiation","expect":"text/markdown"},"fix":{"steps":[{"action":"Generate a Markdown version of each content page.","order":1,"language":null,"code_example":null},{"action":"Return the Markdown version with Content-Type text/markdown when the Accept header asks for it.","order":2,"language":null,"code_example":null},{"action":"Add Vary: Accept so that caches keep the two formats apart.","order":3,"language":"text","code_example":"Content-Type: text/markdown; charset=utf-8\nVary: Accept"}],"summary":"Return Markdown when a request sends Accept: text/markdown, and add Vary: Accept.","skill":{"name":"ai-content-discovery","anchor":"ia.markdown-negotiation"}},"category":"discovery","aggregate":null,"references":[{"title":"HTTP Content Negotiation - MDN","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Content_negotiation"},{"title":"RFC 9110 - HTTP Semantics: Content Negotiation","kind":"spec","url":"https://www.rfc-editor.org/rfc/rfc9110#name-content-negotiation"},{"title":"Cloudflare: Introducing Markdown for Agents","kind":"guide","url":"https://blog.cloudflare.com/markdown-for-agents/"}],"stage":"read","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-READ-09","url":"https://www.agentready.org/#read"},"why":"AI agents fetch pages programmatically and benefit from machine-readable formats. Serving Markdown via Accept: text/markdown allows agents to consume structured content without HTML parsing overhead, saving up to 80% of tokens while preserving headings, links, and emphasis.","profiles":["ai_search_visibility"],"score_role":"bonus","ar_strengths":{"AR-READ-09":"MAY"},"ar_practice_ids":["AR-READ-09"],"legacy_id":"1.7","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.markdown-negotiation","strength_source":"agentready","i18n":{"nl":{"name":"Content negotiation (text/markdown)","steps":["Genereer een Markdown-versie van elke contentpagina.","Geef de Markdown-versie terug met Content-Type text/markdown als de Accept-header erom vraagt.","Voeg Vary: Accept toe, zodat caches de twee formaten gescheiden houden."],"why":"AI-agents halen pagina's programmatisch op en hebben baat bij machineleesbare formaten. Markdown via Accept: text/markdown bespaart tot 80% tokens en houdt koppen, links en nadruk intact.","verify_expect":"text/markdown","fix_summary":"Geef Markdown terug als een request Accept: text/markdown stuurt, en voeg Vary: Accept toe."}},"maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MAY","ar_mapping":"full","evidence_type":"measured_study"},{"id":"ia.bot-accessibility","name":"HTTP bot accessibility","verify":{"command":"curl -s -o /dev/null -w '%{http_code}\\n' -A 'GPTBot/1.0' https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.bot-accessibility","expect":"200"},"fix":{"steps":[{"action":"Request the home page with a bot user agent and record the HTTP status.","order":1,"language":null,"code_example":null},{"action":"When the status is 401 or 403, add a WAF or CDN rule that allows known AI user agents.","order":2,"language":"nginx","code_example":"map $http_user_agent $is_ai_bot {\n  default       0;\n  \"~*GPTBot\"    1;\n  \"~*ClaudeBot\" 1;\n}"},{"action":"Keep rate limits, but do not answer verified AI crawlers with a challenge page.","order":3,"language":null,"code_example":null}],"summary":"Return HTTP 200 to legitimate bots and do not block them in the WAF or CDN.","skill":{"name":"ai-content-discovery","anchor":"ia.bot-accessibility"}},"category":"discovery","aggregate":null,"references":[{"title":"Cloudflare Bot Management documentation","kind":"guide","url":"https://developers.cloudflare.com/bots/"},{"title":"Google crawlers and user agents overview","kind":"guide","url":"https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers"}],"expected":"HTTP 2xx for the home page","stage":"find","lifecycle":{"introduced":"2026-08-24","revised":["2026-10-30"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-FIND-01","url":"https://www.agentready.org/#reachable"},"why":"HTTP probes with agent user-agent strings show how the sampled page responds from the scanner. They do not establish access from provider IPs or successful retrieval of the expected answer.","profiles":["ai_search_visibility"],"score_role":"core","ar_strengths":{"AR-FIND-01":"MUST"},"ar_practice_ids":["AR-FIND-01"],"legacy_id":"1.8","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.bot-accessibility","strength_source":"agentready","i18n":{"nl":{"name":"HTTP-toegankelijkheid voor bots","steps":["Vraag de homepage op met een bot-user-agent en noteer de HTTP-status.","Voeg bij status 401 of 403 een WAF- of CDN-regel toe die bekende AI-user-agents toestaat.","Houd rate limits, maar geef geverifieerde AI-crawlers geen challengepagina."],"why":"HTTP-probes met agent-user-agent-strings tonen hoe de bemonsterde pagina reageert vanaf de scanner. Ze bewijzen geen toegang vanaf provider-IP-adressen of succesvolle opvraging van het verwachte antwoord.","verify_expect":"200","fix_summary":"Geef legitieme bots HTTP 200 en blokkeer ze niet in de WAF of het CDN."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"full","evidence_type":"scanner_data"},{"id":"ia.link-headers","name":"Link response headers","verify":{"command":"curl -sI https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.link-headers","expect":"A Link header with rel api-catalog, service-desc or service-doc"},"fix":{"steps":[{"action":"Add a Link header to the home page response that points to your API description.","order":1,"language":"text","code_example":"Link: </.well-known/api-catalog>; rel=\"api-catalog\", </openapi.json>; rel=\"service-desc\""},{"action":"Make sure that each linked resource returns HTTP 200.","order":2,"language":null,"code_example":null}],"summary":"Advertise your API catalog, service description or documentation with an RFC 8288 Link header.","skill":{"name":"ai-content-discovery","anchor":"ia.link-headers"}},"category":"discovery","aggregate":null,"references":[{"title":"RFC 8288 - Web Linking","kind":"spec","url":"https://www.rfc-editor.org/rfc/rfc8288"},{"title":"IANA Link Relations registry","kind":"guide","url":"https://www.iana.org/assignments/link-relations/link-relations.xhtml"},{"title":"RFC 9727 - API Catalog (`api-catalog` link relation)","kind":"spec","url":"https://datatracker.ietf.org/doc/rfc9727/"},{"title":"RFC 9264 - Linkset media types","kind":"spec","url":"https://www.rfc-editor.org/rfc/rfc9264"},{"title":"OpenAPI Specification","kind":"spec","url":"https://spec.openapis.org/oas/latest.html"}],"stage":"find","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02","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":"RFC 8288 Link headers let an established API advertise concrete machine-readable descriptions and documentation. This checkpoint never creates its own API applicability.","profiles":["ai_search_visibility","api_tool_readiness"],"score_role":"bonus","ar_strengths":{"AR-FIND-04":"MAY","AR-READ-06":"SHOULD"},"ar_practice_ids":["AR-FIND-04","AR-READ-06"],"legacy_id":"1.9","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.link-headers","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Link-responseheaders","steps":["Voeg aan de response van de homepage een Link-header toe die naar je API-beschrijving verwijst.","Zorg dat elke gelinkte resource HTTP 200 geeft."],"why":"RFC 8288 Link-headers laten een bestaande API naar machineleesbare beschrijvingen en documentatie verwijzen. Dit checkpoint maakt zelf geen API-toepasbaarheid.","verify_expect":"Een Link-header met rel api-catalog, service-desc of service-doc","fix_summary":"Verwijs met een RFC 8288 Link-header naar je API-catalogus, servicebeschrijving of documentatie."}},"maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MAY","ar_mapping":"partial","evidence_type":"recommendation"},{"id":"ia.content-usage","name":"Content-Usage preferences","verify":{"command":"curl -sf https://{domain}/robots.txt","rescan":"isagentready results {domain} --checkpoint ia.content-usage","expect":"A Content-Usage line with valid AIPREF vocabulary"},"fix":{"steps":[{"action":"Decide your preferences for the AIPREF categories, for example train-ai and search.","order":1,"language":null,"code_example":null},{"action":"Add a Content-Usage line to robots.txt, or send a Content-Usage header.","order":2,"language":"text","code_example":"User-agent: *\nAllow: /\nContent-Usage: train-ai=n, search=y"}],"summary":"Declare your content-use preferences with a Content-Usage rule in robots.txt or an HTTP header.","skill":{"name":"ai-content-discovery","anchor":"ia.content-usage"}},"category":"discovery","aggregate":null,"references":[{"title":"AIPREF Content-Usage attachment draft (work in progress)","kind":"guide","url":"https://ietf-wg-aipref.github.io/drafts/draft-ietf-aipref-attach.html"},{"title":"AIPREF vocabulary draft (work in progress)","kind":"guide","url":"https://ietf-wg-aipref.github.io/drafts/draft-ietf-aipref-vocab.html"},{"title":"RFC 9651 - Structured Field Values for HTTP","kind":"spec","url":"https://www.rfc-editor.org/rfc/rfc9651"}],"stage":"find","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"AIPREF Content-Usage attachment draft (work in progress)","url":"https://ietf-wg-aipref.github.io/drafts/draft-ietf-aipref-attach.html"},"why":"Content-Usage is an AIPREF working-group draft for declaring content-use preferences. It is descriptive preference metadata, not crawler access control.","profiles":["ai_search_visibility"],"score_role":"bonus","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"1.10","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.content-usage","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Content-Usage-voorkeuren","steps":["Bepaal je voorkeuren voor de AIPREF-categorieen, bijvoorbeeld train-ai en search.","Voeg een Content-Usage-regel toe aan robots.txt, of stuur een Content-Usage-header."],"why":"Content-Usage is een AIPREF-draft om voorkeuren voor contentgebruik te declareren. Het is beschrijvende metadata, geen toegangscontrole voor crawlers.","verify_expect":"Een Content-Usage-regel met geldige AIPREF-termen","fix_summary":"Declareer je voorkeuren voor contentgebruik met een Content-Usage-regel in robots.txt of een HTTP-header."}},"maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MAY","ar_mapping":"none","evidence_type":"recommendation"},{"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-30","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","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"1.11","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.agents-md","strength_source":"isagentready_policy","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.","verify_expect":"HTTP 200 met een Markdown-handleiding","fix_summary":"Publiceer /AGENTS.md dat agents vertelt wat de site biedt en hoe ze verbinden."}},"maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MAY","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.agent-content-contracts","name":"Agent content contracts","verify":{"command":"curl -sf https://{domain}/pricing.md","rescan":"isagentready results {domain} --checkpoint ia.agent-content-contracts","expect":"HTTP 200 with a Markdown body (run the same command for /auth.md)"},"fix":{"steps":[{"action":"Write /auth.md with the auth flow, the scopes and the token lifetime.","order":1,"language":"markdown","code_example":"# Authentication\n\nUse OAuth 2.0 authorization code with PKCE S256.\nScopes: read, write.\nTokens expire after 1 hour."},{"action":"Write /pricing.md with each plan, its price, its limits and the billing period.","order":2,"language":"markdown","code_example":"# Pricing\n\n| Plan | Price | Limit |\n|---|---|---|\n| Free | 0 EUR | 100 calls/day |\n| Pro | 29 EUR/month | 10,000 calls/day |"},{"action":"Link both files from llms.txt.","order":3,"language":null,"code_example":null}],"summary":"Publish /auth.md and /pricing.md when the site has sign-in or paid plans.","skill":{"name":"ai-content-discovery","anchor":"ia.agent-content-contracts"}},"category":"discovery","aggregate":null,"references":[{"title":"llms.txt proposal","kind":"guide","url":"https://llmstxt.org/"},{"title":"AGENTS.md convention","kind":"guide","url":"https://agents.md/"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-READ-11","url":"https://www.agentready.org/#read"},"why":"Agents need concise, stable contracts for high-friction product questions before they can act safely. auth.md explains authentication flows and token handling. pricing.md explains plan and billing constraints without forcing agents to scrape marketing pages.","profiles":["ai_search_visibility","api_tool_readiness"],"score_role":"bonus","ar_strengths":{"AR-ACT-01":"SHOULD","AR-READ-11":"SHOULD"},"ar_practice_ids":["AR-READ-11","AR-ACT-01"],"legacy_id":"1.12","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.agent-content-contracts","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Agent-contentcontracten","steps":["Schrijf /auth.md met de authflow, de scopes en de levensduur van tokens.","Schrijf /pricing.md met elk plan, de prijs, de limieten en de factuurperiode.","Link beide bestanden vanuit llms.txt."],"why":"Agents hebben korte, stabiele contracten nodig voor lastige productvragen voordat ze veilig kunnen handelen. auth.md legt authenticatie en tokens uit. pricing.md legt plannen en facturatie uit zonder dat agents marketingpagina's moeten scrapen.","verify_expect":"HTTP 200 met een Markdown-body (voer hetzelfde commando uit voor /auth.md)","fix_summary":"Publiceer /auth.md en /pricing.md als de site inloggen of betaalde plannen heeft."}},"maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MAY","ar_mapping":"partial","evidence_type":"recommendation"},{"id":"ia.soft-404","name":"Soft-404 hygiene","verify":{"command":"curl -s -o /dev/null -w '%{http_code}\\n' https://{domain}/isagentready-missing-check","rescan":"isagentready results {domain} --checkpoint ia.soft-404","expect":"404 or 410"},"fix":{"steps":[{"action":"Request a random path that does not exist and record the status.","order":1,"language":null,"code_example":null},{"action":"Configure the server or the single-page app router to return 404 for unknown routes.","order":2,"language":"nginx","code_example":"location / {\n  try_files $uri $uri/ =404;\n}"},{"action":"Do not redirect unknown paths to the home page.","order":3,"language":null,"code_example":null}],"summary":"Answer unknown paths with HTTP 404 or 410, not with HTTP 200 or a redirect.","skill":{"name":"ai-content-discovery","anchor":"ia.soft-404"}},"category":"discovery","aggregate":null,"references":[{"title":"Google Search Central: soft 404 errors","kind":"guide","url":"https://developers.google.com/search/docs/crawling-indexing/http-network-errors#soft-404-errors"},{"title":"RFC 9110 section 15.5.5: 404 Not Found","kind":"spec","url":"https://www.rfc-editor.org/rfc/rfc9110#name-404-not-found"}],"expected":"HTTP 404 or 410 for a path that does not exist","stage":"read","lifecycle":{"introduced":"2026-08-25","revised":["2026-10-30"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-READ-02","url":"https://www.agentready.org/#read"},"why":"Agents and crawlers rely on a real 404 or 410 status to know a resource is missing. A 200 with the app shell (soft 404) makes them believe every probed path exists, pollutes indexes, and hides broken links from monitoring.","profiles":["ai_search_visibility","browser_agent_usability","api_tool_readiness"],"score_role":"core","ar_strengths":{"AR-READ-02":"MUST"},"ar_practice_ids":["AR-READ-02"],"legacy_id":"1.13","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.soft-404","strength_source":"agentready","i18n":{"nl":{"name":"Soft-404-hygiene","steps":["Vraag een willekeurig pad op dat niet bestaat en noteer de status.","Stel de server of de router van de single-page app zo in dat onbekende routes 404 geven.","Stuur onbekende paden niet door naar de homepage."],"why":"Agents en crawlers vertrouwen op een echte 404- of 410-status om te weten dat een resource ontbreekt. Een 200 met de app-shell (soft 404) laat ze denken dat elk pad bestaat, vervuilt indexen en verbergt kapotte links.","verify_expect":"404 of 410","fix_summary":"Beantwoord onbekende paden met HTTP 404 of 410, niet met HTTP 200 of een redirect."}},"maturity":"recommended","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.dns-aid","name":"DNS-AID agent records","verify":{"command":"curl -sf -H 'accept: application/dns-json' 'https://cloudflare-dns.com/dns-query?name=_index._agents.{domain}&type=SVCB' | jq -e '.Answer | length > 0'","rescan":"isagentready results {domain} --checkpoint ia.dns-aid","expect":"exit code 0"},"fix":{"steps":[{"action":"Add an SVCB record at _index._agents.<zone> that points to your agent index.","order":1,"language":"text","code_example":"_index._agents.example.com. 3600 IN SVCB 1 agents.example.com. alpn=h2"},{"action":"Add _mcp._agents and _a2a._agents records only for protocols that you serve.","order":2,"language":null,"code_example":null}],"summary":"Publish an SVCB record for your agent index under _index._agents.","skill":{"name":"ai-content-discovery","anchor":"ia.dns-aid"}},"category":"discovery","aggregate":null,"references":[{"title":"draft-mozleywilliams-dnsop-dnsaid: DNS for AI Discovery","kind":"spec","url":"https://datatracker.ietf.org/doc/draft-mozleywilliams-dnsop-dnsaid/"},{"title":"RFC 9460: SVCB and HTTPS resource records","kind":"spec","url":"https://www.rfc-editor.org/rfc/rfc9460"}],"stage":"find","lifecycle":{"introduced":"2026-08-25","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"draft-mozleywilliams-dnsop-dnsaid: DNS for AI Discovery","url":"https://datatracker.ietf.org/doc/draft-mozleywilliams-dnsop-dnsaid/"},"why":"DNS-AID publishes agent discovery pointers under the _agents DNS names. This checkpoint detects SVCB or HTTPS answers and accepts an index TXT fallback; it does not verify the advertised service.","profiles":["api_tool_readiness"],"score_role":"bonus","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"1.14","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.dns-aid","strength_source":"isagentready_policy","i18n":{"nl":{"name":"DNS-AID-agentrecords","steps":["Voeg een SVCB-record toe op _index._agents.<zone> dat naar je agentindex verwijst.","Voeg _mcp._agents- en _a2a._agents-records alleen toe voor protocollen die je aanbiedt."],"why":"DNS-AID publiceert verwijzingen voor agentdiscovery onder de _agents-DNS-namen. Dit checkpoint zoekt SVCB- of HTTPS-antwoorden en accepteert een index-TXT als alternatief. Het controleert de geadverteerde service niet.","verify_expect":"exitcode 0","fix_summary":"Publiceer een SVCB-record voor je agentindex onder _index._agents."}},"maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MAY","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.pricing-page","name":"First-party pricing page","verify":{"command":"curl -sL https://{domain}/pricing | grep -Eo '[$€£][0-9]+' | head -1","rescan":"isagentready results {domain} --checkpoint ia.pricing-page","expect":"a price such as $19"},"fix":{"steps":[{"action":"Publish a pricing page on your own origin, for example /pricing, and link it from the home page.","order":1,"language":null,"code_example":null},{"action":"Render each price in the server HTML. Do not load prices with JavaScript only.","order":2,"language":null,"code_example":null},{"action":"Add Offer schema to each plan.","order":3,"language":"html","code_example":"<script type=\"application/ld+json\">\n{\"@context\": \"https://schema.org\", \"@type\": \"Offer\", \"name\": \"Team\", \"price\": \"49\", \"priceCurrency\": \"EUR\"}\n</script>"}],"summary":"Serve a first-party pricing page with the prices in the server HTML.","skill":{"name":"ai-content-discovery","anchor":"ia.pricing-page"}},"category":"discovery","aggregate":null,"references":[{"title":"agentready.org AR-READ-11","kind":"study","url":"https://www.agentready.org/#read"},{"title":"Schema.org Offer","kind":"spec","url":"https://schema.org/Offer"}],"expected":"A same-origin pricing page that returns HTTP 200 and shows prices in the server HTML","stage":"read","lifecycle":{"introduced":"2026-10-22","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-READ-11","url":"https://www.agentready.org/#read"},"why":"First-party pricing text gives agents a source for price questions. Detecting an amount does not verify complete plans, free tiers, limits or accurate answers.","profiles":["ai_search_visibility","agentic_commerce"],"score_role":"bonus","ar_strengths":{"AR-READ-11":"SHOULD"},"ar_practice_ids":["AR-READ-11"],"legacy_id":"1.15","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.pricing-page","strength_source":"agentready","i18n":{"nl":{"name":"Eigen prijspagina","steps":["Publiceer een prijspagina op je eigen origin, bijvoorbeeld /pricing, en link die vanaf de homepage.","Render elke prijs in de server-HTML. Laad prijzen niet alleen met JavaScript.","Voeg Offer-schema toe aan elk abonnement."],"why":"Prijstekst op een eigen pagina geeft agents een bron voor prijsvragen. Een gevonden bedrag verifieert geen volledige abonnementen, gratis varianten, limieten of juiste antwoorden.","verify_expect":"een prijs zoals €19","fix_summary":"Lever een eigen prijspagina met de prijzen in de server-HTML."}},"maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"measured_study"},{"id":"ia.json-ld","name":"JSON-LD present","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.json-ld","expect":null},"fix":{"steps":[{"action":"Add a script element with type application/ld+json to the head of the page.","order":1,"language":"html","code_example":"<script type=\"application/ld+json\">\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"WebPage\",\n  \"name\": \"Pricing\"\n}\n</script>"},{"action":"Repeat the key facts of the JSON-LD as visible text on the page.","order":2,"language":null,"code_example":null}],"summary":"Add a JSON-LD block with the schema.org context to each page.","skill":{"name":"structured-data","anchor":"ia.json-ld"}},"category":"structured_data","aggregate":null,"references":[{"title":"Schema.org Getting Started","kind":"spec","url":"https://schema.org/docs/gs.html"},{"title":"Google Structured Data Guide","kind":"guide","url":"https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data"},{"title":"W3C JSON-LD Specification","kind":"spec","url":"https://www.w3.org/TR/json-ld11/"},{"title":"Ahrefs: schema markup and AI citations (2026)","kind":"study","url":"https://ahrefs.com/blog/schema-ai-citations/"},{"title":"searchVIU: what AI assistants actually parse (2025)","kind":"study","url":"https://www.searchviu.com/en/schema-markup-and-ai-in-2025-what-chatgpt-claude-perplexity-gemini-really-see/"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-READ-08","url":"https://www.agentready.org/#read"},"why":"JSON-LD expresses page facts in a machine-readable vocabulary. Syntax and schema checks do not verify factual accuracy or parity with visible text.","profiles":["ai_search_visibility"],"score_role":"core","ar_strengths":{"AR-READ-08":"SHOULD"},"ar_practice_ids":["AR-READ-08"],"legacy_id":"2.1","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.json-ld","strength_source":"agentready","i18n":{"nl":{"name":"JSON-LD aanwezig","steps":["Voeg een script-element met type application/ld+json toe aan de head van de pagina.","Herhaal de belangrijkste feiten uit de JSON-LD als zichtbare tekst op de pagina."],"why":"JSON-LD drukt paginafeiten uit in een machineleesbare woordenschat. Syntaxis- en schemacontroles verifiëren geen feitelijke juistheid of overeenstemming met zichtbare tekst.","verify_expect":null,"fix_summary":"Voeg op elke pagina een JSON-LD-blok met de schema.org-context toe."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.organization-schema","name":"Organization / WebSite schema","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.organization-schema","expect":null},"fix":{"steps":[{"action":"Add an Organization entity with name, url, logo and sameAs.","order":1,"language":"json","code_example":"{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"Organization\",\n  \"@id\": \"https://example.com/#organization\",\n  \"name\": \"Example\",\n  \"url\": \"https://example.com\",\n  \"logo\": \"https://example.com/logo.png\"\n}"},{"action":"Add a WebSite entity with name and url that refers to the Organization as publisher.","order":2,"language":null,"code_example":null}],"summary":"Add Organization and WebSite JSON-LD with name and url to the home page.","skill":{"name":"structured-data","anchor":"ia.organization-schema"}},"category":"structured_data","aggregate":null,"references":[{"title":"Schema.org Organization","kind":"spec","url":"https://schema.org/Organization"},{"title":"Schema.org WebSite","kind":"spec","url":"https://schema.org/WebSite"},{"title":"Google Structured Data Guide","kind":"guide","url":"https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-READ-08","url":"https://www.agentready.org/#read"},"why":"Organization and WebSite schemas establish the brand identity in the knowledge graph. AI systems use them to attribute content and to build entity relations.","profiles":["ai_search_visibility"],"score_role":"core","ar_strengths":{"AR-READ-08":"SHOULD"},"ar_practice_ids":["AR-READ-08"],"legacy_id":"2.2","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.organization-schema","strength_source":"agentready","i18n":{"nl":{"name":"Organization- / WebSite-schema","steps":["Voeg een Organization-entiteit toe met name, url, logo en sameAs.","Voeg een WebSite-entiteit toe met name en url die naar de Organization verwijst als publisher."],"why":"Organization- en WebSite-schema's leggen de merkidentiteit vast in de knowledge graph. AI-systemen gebruiken ze om content toe te schrijven en entiteitsrelaties te bouwen.","verify_expect":null,"fix_summary":"Voeg Organization- en WebSite-JSON-LD met name en url toe aan de homepage."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.high-value-schema","name":"High-value schema types","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.high-value-schema","expect":null},"fix":{"steps":[{"action":"Identify the primary content type of the page, for example Product, Article or Event.","order":1,"language":null,"code_example":null},{"action":"Add JSON-LD of that type with the required properties.","order":2,"language":"json","code_example":"{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"Product\",\n  \"name\": \"Team plan\",\n  \"offers\": {\"@type\": \"Offer\", \"price\": \"29\", \"priceCurrency\": \"EUR\"}\n}"}],"summary":"Describe the primary content of each page with the matching schema.org type.","skill":{"name":"structured-data","anchor":"ia.high-value-schema"}},"category":"structured_data","aggregate":null,"references":[{"title":"Google Search Gallery","kind":"guide","url":"https://developers.google.com/search/docs/appearance/structured-data/search-gallery"},{"title":"Schema.org Getting Started","kind":"spec","url":"https://schema.org/docs/gs.html"},{"title":"Google Structured Data Guide","kind":"guide","url":"https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-READ-08","url":"https://www.agentready.org/#read"},"why":"Schema types such as Article, Product and FAQPage give agents typed entities to extract instead of free text. They also make the page eligible for rich results.","profiles":["ai_search_visibility","agentic_commerce"],"score_role":"core","ar_strengths":{"AR-READ-08":"SHOULD"},"ar_practice_ids":["AR-READ-08"],"legacy_id":"2.3","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.high-value-schema","strength_source":"agentready","i18n":{"nl":{"name":"Waardevolle schematypes","steps":["Bepaal het hoofdtype content van de pagina, bijvoorbeeld Product, Article of Event.","Voeg JSON-LD van dat type toe met de verplichte properties."],"why":"Schematypes zoals Article, Product en FAQPage geven agents getypeerde entiteiten in plaats van vrije tekst. Ze maken de pagina ook geschikt voor rich results.","verify_expect":null,"fix_summary":"Beschrijf de hoofdcontent van elke pagina met het passende schema.org-type."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.entity-linking","name":"Entity linking via @id","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.entity-linking","expect":null},"fix":{"steps":[{"action":"Add an @id with a fragment URL to each main entity.","order":1,"language":"json","code_example":"\"@id\": \"https://example.com/#organization\""},{"action":"Refer to the entity by @id from other entities, for example as publisher.","order":2,"language":"json","code_example":"\"publisher\": {\"@id\": \"https://example.com/#organization\"}"}],"summary":"Give each JSON-LD entity a stable @id and refer to it from other entities.","skill":{"name":"structured-data","anchor":"ia.entity-linking"}},"category":"structured_data","aggregate":null,"references":[{"title":"W3C JSON-LD Specification","kind":"spec","url":"https://www.w3.org/TR/json-ld11/"},{"title":"Schema.org Getting Started","kind":"spec","url":"https://schema.org/docs/gs.html"},{"title":"Google Structured Data Guide","kind":"guide","url":"https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-READ-08","url":"https://www.agentready.org/#read"},"why":"Entity links through @id make a connected graph of your content. AI systems follow the references to understand the relations between entities.","profiles":["ai_search_visibility"],"score_role":"core","ar_strengths":{"AR-READ-08":"SHOULD"},"ar_practice_ids":["AR-READ-08"],"legacy_id":"2.4","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.entity-linking","strength_source":"agentready","i18n":{"nl":{"name":"Entiteiten koppelen via @id","steps":["Voeg aan elke hoofdentiteit een @id met een fragment-URL toe.","Verwijs naar de entiteit via @id vanuit andere entiteiten, bijvoorbeeld als publisher."],"why":"Entiteitslinks via @id maken een verbonden graaf van je content. AI-systemen volgen de verwijzingen om de relaties tussen entiteiten te begrijpen.","verify_expect":null,"fix_summary":"Geef elke JSON-LD-entiteit een stabiele @id en verwijs ernaar vanuit andere entiteiten."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.schema-validation","name":"Schema validation","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.schema-validation","expect":null},"fix":{"steps":[{"action":"Run each JSON-LD block through a JSON parser and fix the syntax errors.","order":1,"language":null,"code_example":null},{"action":"Add @context and @type to each top-level entity.","order":2,"language":null,"code_example":null},{"action":"Test the page with the IsAgentReady structured data validator.","order":3,"language":null,"code_example":null}],"summary":"Fix JSON syntax errors and missing required properties in each JSON-LD block.","skill":{"name":"structured-data","anchor":"ia.schema-validation"}},"category":"structured_data","aggregate":null,"references":[{"title":"Schema.org Validator","kind":"guide","url":"https://validator.schema.org/"},{"title":"Schema.org Getting Started","kind":"spec","url":"https://schema.org/docs/gs.html"},{"title":"Google Structured Data Guide","kind":"guide","url":"https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-READ-08","url":"https://www.agentready.org/#read"},"why":"Search engines and AI systems ignore structured data that is not valid. Errors in the markup remove all of its value.","profiles":["ai_search_visibility"],"score_role":"core","ar_strengths":{"AR-READ-08":"SHOULD"},"ar_practice_ids":["AR-READ-08"],"legacy_id":"2.6","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.schema-validation","strength_source":"agentready","i18n":{"nl":{"name":"Schemavalidatie","steps":["Haal elk JSON-LD-blok door een JSON-parser en herstel de syntaxfouten.","Voeg @context en @type toe aan elke entiteit op het hoogste niveau.","Test de pagina met de IsAgentReady structured data validator."],"why":"Zoekmachines en AI-systemen negeren gestructureerde data die niet geldig is. Fouten in de markup nemen alle waarde weg.","verify_expect":null,"fix_summary":"Herstel JSON-syntaxfouten en ontbrekende verplichte properties in elk JSON-LD-blok."}},"maturity":"recommended","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.faq-schema","name":"FAQPage schema","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.faq-schema","expect":null},"fix":{"steps":[{"action":"Find the questions and answers that are visible on the page.","order":1,"language":null,"code_example":null},{"action":"Add a FAQPage entity with one Question and acceptedAnswer per pair.","order":2,"language":"json","code_example":"{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"FAQPage\",\n  \"mainEntity\": [{\n    \"@type\": \"Question\",\n    \"name\": \"Is there a free plan?\",\n    \"acceptedAnswer\": {\"@type\": \"Answer\", \"text\": \"Yes. The free plan has 100 calls per day.\"}\n  }]\n}"}],"summary":"Add FAQPage JSON-LD for the questions and answers that are visible on the page.","skill":{"name":"structured-data","anchor":"ia.faq-schema"}},"category":"structured_data","aggregate":null,"references":[{"title":"Schema.org FAQPage","kind":"spec","url":"https://schema.org/FAQPage"},{"title":"Google structured data guidelines","kind":"guide","url":"https://developers.google.com/search/docs/appearance/structured-data/sd-policies"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":["2026-08-29"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-READ-08","url":"https://www.agentready.org/#read"},"why":"FAQPage schema exposes questions and answers as separate machine-readable pairs. An agent can then use a direct answer without parsing prose.","profiles":["ai_search_visibility"],"score_role":"core","ar_strengths":{"AR-READ-08":"SHOULD"},"ar_practice_ids":["AR-READ-08"],"legacy_id":"2.7","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.faq-schema","strength_source":"agentready","i18n":{"nl":{"name":"FAQPage-schema","steps":["Zoek de vragen en antwoorden die zichtbaar op de pagina staan.","Voeg een FAQPage-entiteit toe met een Question en acceptedAnswer per paar."],"why":"FAQPage-schema toont vragen en antwoorden als losse machineleesbare paren. Een agent kan dan een direct antwoord gebruiken zonder proza te parsen.","verify_expect":null,"fix_summary":"Voeg FAQPage-JSON-LD toe voor de vragen en antwoorden die zichtbaar op de pagina staan."}},"maturity":"recommended","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.author-attribution","name":"Author attribution","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.author-attribution","expect":null},"fix":{"steps":[{"action":"Add an author property of type Person to the Article JSON-LD.","order":1,"language":"json","code_example":"\"author\": {\"@type\": \"Person\", \"name\": \"Jane Doe\", \"url\": \"https://example.com/team/jane\"}"},{"action":"Show the author name as visible text on the page.","order":2,"language":null,"code_example":null}],"summary":"Add a Person author with name and url to the JSON-LD of each editorial page.","skill":{"name":"structured-data","anchor":"ia.author-attribution"}},"category":"structured_data","aggregate":null,"references":[{"title":"Schema.org Person","kind":"spec","url":"https://schema.org/Person"},{"title":"Schema.org author property","kind":"spec","url":"https://schema.org/author"},{"title":"Google E-E-A-T guidelines","kind":"guide","url":"https://developers.google.com/search/docs/fundamentals/creating-helpful-content"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-READ-08","url":"https://www.agentready.org/#read"},"why":"Author attribution gives agents and search engines a clear, machine-readable signal of who stands behind the content and links it to a known entity. This supports trust and provenance (E-E-A-T) and lets systems attribute the content to its author.","profiles":["ai_search_visibility"],"score_role":"core","ar_strengths":{"AR-READ-08":"SHOULD"},"ar_practice_ids":["AR-READ-08"],"legacy_id":"2.8","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.author-attribution","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Auteurvermelding","steps":["Voeg een author-property van type Person toe aan de Article-JSON-LD.","Toon de naam van de auteur als zichtbare tekst op de pagina."],"why":"Auteurvermelding geeft agents en zoekmachines een duidelijk, machineleesbaar signaal van wie achter de content staat. Dit ondersteunt vertrouwen en herkomst (E-E-A-T).","verify_expect":null,"fix_summary":"Voeg een Person-auteur met name en url toe aan de JSON-LD van elke redactionele pagina."}},"maturity":"recommended","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"partial","evidence_type":"recommendation"},{"id":"ia.trust-pages","name":"Trust anchor pages","verify":{"command":"curl -s -o /dev/null -w '%{http_code}\\n' https://{domain}/contact","rescan":"isagentready results {domain} --checkpoint ia.trust-pages","expect":"200 (run the same command for /about and /privacy)"},"fix":{"steps":[{"action":"Publish /about, /contact and /privacy with real text, an address and contact details.","order":1,"language":null,"code_example":null},{"action":"Link the three pages from the footer of each page.","order":2,"language":null,"code_example":null},{"action":"Add ContactPage and AboutPage JSON-LD to the pages.","order":3,"language":null,"code_example":null}],"summary":"Publish about, contact and privacy pages with real content and link them from each page.","skill":{"name":"structured-data","anchor":"ia.trust-pages"}},"category":"structured_data","aggregate":null,"references":[{"title":"Google Search Quality Rater Guidelines: E-E-A-T and trust","kind":"guide","url":"https://developers.google.com/search/docs/fundamentals/creating-helpful-content"},{"title":"Schema.org ContactPage","kind":"spec","url":"https://schema.org/ContactPage"}],"stage":"read","lifecycle":{"introduced":"2026-08-25","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"Google Search Quality Rater Guidelines: E-E-A-T and trust","url":"https://developers.google.com/search/docs/fundamentals/creating-helpful-content"},"why":"Agents check about, contact and privacy pages to verify a business is legitimate and to answer contact questions before recommending it. Thin or missing trust pages read as an anonymous site.","profiles":["ai_search_visibility","agentic_commerce"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"2.9","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.trust-pages","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Vertrouwenspagina's","steps":["Publiceer /about, /contact en /privacy met echte tekst, een adres en contactgegevens.","Link de drie pagina's vanuit de footer van elke pagina.","Voeg ContactPage- en AboutPage-JSON-LD toe aan de pagina's."],"why":"Agents controleren about-, contact- en privacypagina's om te zien of een bedrijf legitiem is. Dunne of ontbrekende vertrouwenspagina's lijken op een anonieme site.","verify_expect":"200 (voer hetzelfde commando uit voor /about en /privacy)","fix_summary":"Publiceer about-, contact- en privacypagina's met echte content en link ze vanaf elke pagina."}},"maturity":"recommended","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.server-rendered-content","name":"Server-side rendered content","verify":{"command":"curl -sf https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.server-rendered-content","expect":"The HTML response contains the main headings and body text"},"fix":{"steps":[{"action":"Fetch the page without JavaScript and compare the text with the rendered page.","order":1,"language":null,"code_example":null},{"action":"Enable server-side rendering or static generation for the main content.","order":2,"language":null,"code_example":null},{"action":"Keep headings, body text and links in the initial HTML.","order":3,"language":null,"code_example":null}],"summary":"Render the main content in the HTML response, without JavaScript.","skill":{"name":"content-semantics","anchor":"ia.server-rendered-content"}},"category":"semantics","aggregate":null,"references":[{"title":"Build agent-friendly websites","kind":"guide","url":"https://web.dev/articles/ai-agent-site-ux"},{"title":"Google JavaScript SEO basics","kind":"guide","url":"https://developers.google.com/search/docs/crawling-indexing/javascript/javascript-seo-basics"}],"expected":"Meaningful text content in the initial HTML response","stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-READ-01","url":"https://www.agentready.org/#read"},"why":"Fetch-only crawlers and non-rendered retrieval cannot depend on client-side JavaScript. Browser agents may combine the rendered DOM, accessibility tree, and screenshots. Meaningful server-rendered HTML keeps core content available across both access modes.","profiles":["ai_search_visibility","browser_agent_usability"],"score_role":"core","ar_strengths":{"AR-READ-01":"MUST","AR-READ-03":"SHOULD"},"ar_practice_ids":["AR-READ-01","AR-READ-03"],"legacy_id":"3.1","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.server-rendered-content","strength_source":"agentready","i18n":{"nl":{"name":"Server-side gerenderde content","steps":["Haal de pagina op zonder JavaScript en vergelijk de tekst met de gerenderde pagina.","Zet server-side rendering of statische generatie aan voor de hoofdcontent.","Houd koppen, bodytekst en links in de initiele HTML."],"why":"Crawlers die alleen ophalen kunnen niet op client-side JavaScript vertrouwen. Browseragents combineren de DOM, de accessibility tree en screenshots. Betekenisvolle server-HTML houdt de kerncontent beschikbaar voor beide.","verify_expect":"Het HTML-antwoord bevat de hoofdkoppen en de tekst van de pagina","fix_summary":"Render de hoofdcontent in de HTML-response, zonder JavaScript."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"full","evidence_type":"measured_study"},{"id":"ia.heading-hierarchy","name":"Heading hierarchy","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.heading-hierarchy","expect":null},"fix":{"steps":[{"action":"Give each page one h1 that names the main topic.","order":1,"language":null,"code_example":null},{"action":"Use h2 for sections and h3 for subsections, without skipped levels.","order":2,"language":"html","code_example":"<h1>Pricing</h1>\n<h2>Plans</h2>\n<h3>Team plan</h3>"}],"summary":"Use one h1 and do not skip heading levels.","skill":{"name":"content-semantics","anchor":"ia.heading-hierarchy"}},"category":"semantics","aggregate":null,"references":[{"title":"MDN Heading Elements","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements"},{"title":"W3C Using h1-h6 to identify headings","kind":"spec","url":"https://www.w3.org/WAI/WCAG22/Techniques/html/H42"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-READ-03","url":"https://www.agentready.org/#read"},"why":"AI agents use headings to build a content outline and determine topic hierarchy. A clear h1→h2→h3 structure helps AI systems extract and summarize your content accurately.","profiles":["ai_search_visibility","browser_agent_usability"],"score_role":"core","ar_strengths":{"AR-READ-03":"SHOULD"},"ar_practice_ids":["AR-READ-03"],"legacy_id":"3.2","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.heading-hierarchy","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Kophierarchie","steps":["Geef elke pagina een h1 die het hoofdonderwerp noemt.","Gebruik h2 voor secties en h3 voor subsecties, zonder overgeslagen niveaus."],"why":"AI-agents gebruiken koppen om een outline te maken en de hierarchie van onderwerpen te bepalen. Een duidelijke h1-h2-h3-structuur helpt AI-systemen om content correct samen te vatten.","verify_expect":null,"fix_summary":"Gebruik een h1 en sla geen kopniveaus over."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"partial","evidence_type":"recommendation"},{"id":"ia.semantic-html","name":"Semantic HTML elements","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.semantic-html","expect":null},"fix":{"steps":[{"action":"Replace layout div elements with semantic elements.","order":1,"language":"html","code_example":"<header>...</header>\n<nav>...</nav>\n<main>\n  <article>...</article>\n</main>\n<footer>...</footer>"},{"action":"Use one main element per page.","order":2,"language":null,"code_example":null}],"summary":"Use main, nav, header, footer and article for the page structure.","skill":{"name":"content-semantics","anchor":"ia.semantic-html"}},"category":"semantics","aggregate":null,"references":[{"title":"MDN Semantics in HTML","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Glossary/Semantics#semantics_in_html"},{"title":"W3C HTML5 Document Sections","kind":"spec","url":"https://www.w3.org/TR/html52/sections.html"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"MDN Semantics in HTML","url":"https://developer.mozilla.org/en-US/docs/Glossary/Semantics#semantics_in_html"},"why":"Browser agents may combine the DOM, accessibility tree, and screenshots. Semantic elements like <main>, <nav>, and <article> provide durable structural meaning across those representations.","profiles":["ai_search_visibility","browser_agent_usability"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"3.3","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.semantic-html","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Semantische HTML-elementen","steps":["Vervang layout-div-elementen door semantische elementen.","Gebruik een main-element per pagina."],"why":"Browseragents combineren de DOM, de accessibility tree en screenshots. Semantische elementen zoals <main>, <nav> en <article> geven blijvende structuur in al die weergaven.","verify_expect":null,"fix_summary":"Gebruik main, nav, header, footer en article voor de paginastructuur."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.landmarks-aria","name":"Landmarks and ARIA","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.landmarks-aria","expect":null},"fix":{"steps":[{"action":"Make sure that each page has a main, a navigation and a contentinfo landmark.","order":1,"language":null,"code_example":null},{"action":"Add aria-label when a landmark type occurs more than once.","order":2,"language":"html","code_example":"<nav aria-label=\"Main\">...</nav>\n<nav aria-label=\"Footer\">...</nav>"}],"summary":"Give each page region a landmark and label repeated landmarks.","skill":{"name":"content-semantics","anchor":"ia.landmarks-aria"}},"category":"semantics","aggregate":null,"references":[{"title":"W3C Landmarks Pattern","kind":"guide","url":"https://www.w3.org/WAI/ARIA/apg/patterns/landmarks/"},{"title":"MDN ARIA Roles","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"W3C Landmarks Pattern","url":"https://www.w3.org/WAI/ARIA/apg/patterns/landmarks/"},"why":"ARIA landmarks help AI agents identify page regions (navigation, main content, footer). This is the same API used by screen readers and is increasingly used by AI browsing agents.","profiles":["browser_agent_usability"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"3.4","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.landmarks-aria","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Landmarks en ARIA","steps":["Zorg dat elke pagina een main-, een navigation- en een contentinfo-landmark heeft.","Voeg aria-label toe als een landmarktype meer dan een keer voorkomt."],"why":"ARIA-landmarks helpen AI-agents om paginagebieden te herkennen (navigatie, hoofdcontent, footer). Screenreaders gebruiken dezelfde API, en AI-browseragents steeds vaker ook.","verify_expect":null,"fix_summary":"Geef elk paginagebied een landmark en label herhaalde landmarks."}},"maturity":"recommended","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.image-alt","name":"Image alt text","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.image-alt","expect":null},"fix":{"steps":[{"action":"Add an alt attribute that describes the content of each informative image.","order":1,"language":"html","code_example":"<img src=\"chart.png\" alt=\"Revenue grew 20% in 2026\">"},{"action":"Use alt=\"\" for decorative images.","order":2,"language":null,"code_example":null}],"summary":"Give each content image a descriptive alt text and decorative images an empty alt.","skill":{"name":"content-semantics","anchor":"ia.image-alt"}},"category":"semantics","aggregate":null,"references":[{"title":"WCAG Non-text Content","kind":"spec","url":"https://www.w3.org/WAI/WCAG22/Understanding/non-text-content.html"},{"title":"MDN img alt attribute","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img#alt"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"WCAG Non-text Content","url":"https://www.w3.org/WAI/WCAG22/Understanding/non-text-content.html"},"why":"Some browser agents can inspect screenshots, but image understanding varies by access mode. Descriptive alt text provides a durable machine-readable description of image content and context.","profiles":["ai_search_visibility","browser_agent_usability"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"3.5","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.image-alt","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Alt-tekst bij afbeeldingen","steps":["Voeg een alt-attribuut toe dat de inhoud van elke informatieve afbeelding beschrijft.","Gebruik alt=\"\" voor decoratieve afbeeldingen."],"why":"Sommige browseragents bekijken screenshots, maar beeldbegrip verschilt per toegangsmodus. Beschrijvende alt-tekst geeft een blijvende machineleesbare beschrijving van de afbeelding.","verify_expect":null,"fix_summary":"Geef elke contentafbeelding een beschrijvende alt-tekst en decoratieve afbeeldingen een lege alt."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.lang-attribute","name":"Language attribute","verify":{"command":"curl -sf https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.lang-attribute","expect":"The html element has a lang attribute"},"fix":{"steps":[{"action":"Set the lang attribute on the html element to the language of the page.","order":1,"language":"html","code_example":"<html lang=\"en\">"}],"summary":"Add a valid lang attribute to the html element.","skill":{"name":"content-semantics","anchor":"ia.lang-attribute"}},"category":"semantics","aggregate":null,"references":[{"title":"MDN lang attribute","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang"},{"title":"W3C Declaring language in HTML","kind":"guide","url":"https://www.w3.org/International/questions/qa-html-language-declarations"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"MDN lang attribute","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang"},"why":"The lang attribute tells AI agents what language your content is in, enabling correct text processing, translation, and language-specific understanding.","profiles":["ai_search_visibility","browser_agent_usability"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"3.6","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.lang-attribute","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Taalattribuut","steps":["Zet het lang-attribuut op het html-element naar de taal van de pagina."],"why":"Het lang-attribuut vertelt AI-agents in welke taal je content is. Dat maakt correcte tekstverwerking, vertaling en taalbegrip mogelijk.","verify_expect":"Het html-element heeft een lang-attribuut","fix_summary":"Voeg een geldig lang-attribuut toe aan het html-element."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.link-text","name":"Descriptive link texts","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.link-text","expect":null},"fix":{"steps":[{"action":"Find links with texts such as click here, read more or here.","order":1,"language":null,"code_example":null},{"action":"Change the text so that it names the target page.","order":2,"language":"html","code_example":"<a href=\"/pricing\">See the pricing plans</a>"}],"summary":"Replace generic link texts with texts that name the target.","skill":{"name":"content-semantics","anchor":"ia.link-text"}},"category":"semantics","aggregate":null,"references":[{"title":"WCAG Link Purpose (In Context)","kind":"spec","url":"https://www.w3.org/WAI/WCAG22/Understanding/link-purpose-in-context.html"},{"title":"MDN Anchor element","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"WCAG Link Purpose (In Context)","url":"https://www.w3.org/WAI/WCAG22/Understanding/link-purpose-in-context.html"},"why":"AI agents use link text to understand navigation and discover related content. Generic text like 'click here' provides no context about where the link leads.","profiles":["ai_search_visibility","browser_agent_usability"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"3.7","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.link-text","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Beschrijvende linkteksten","steps":["Zoek links met teksten zoals klik hier, lees meer of hier.","Wijzig de tekst zodat die de doelpagina noemt."],"why":"AI-agents gebruiken linktekst om navigatie te begrijpen en verwante content te vinden. Algemene tekst zoals 'klik hier' zegt niet waar de link heen gaat.","verify_expect":null,"fix_summary":"Vervang algemene linkteksten door teksten die het doel noemen."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.form-labels","name":"Form label coverage","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.form-labels","expect":null},"fix":{"steps":[{"action":"Add a label element for each input, select and textarea.","order":1,"language":"html","code_example":"<label for=\"email\">Email</label>\n<input id=\"email\" name=\"email\" type=\"email\">"},{"action":"Use aria-label only when a visible label is not possible.","order":2,"language":null,"code_example":null}],"summary":"Give each form field a visible label that is linked with for and id.","skill":{"name":"content-semantics","anchor":"ia.form-labels"}},"category":"semantics","aggregate":null,"references":[{"title":"WCAG Labels or Instructions","kind":"spec","url":"https://www.w3.org/WAI/WCAG22/Understanding/labels-or-instructions.html"},{"title":"MDN label element","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Element/label"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"WCAG Labels or Instructions","url":"https://www.w3.org/WAI/WCAG22/Understanding/labels-or-instructions.html"},"why":"AI agents interact with forms via the accessibility tree, which maps labels to inputs. Without proper label associations, AI agents cannot determine what data a form field expects, making form interaction unreliable or impossible.","profiles":["browser_agent_usability"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"3.9","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.form-labels","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Dekking van formulierlabels","steps":["Voeg een label-element toe voor elke input, select en textarea.","Gebruik aria-label alleen als een zichtbaar label niet mogelijk is."],"why":"AI-agents gebruiken formulieren via de accessibility tree, die labels aan inputs koppelt. Zonder labels weet een agent niet welke data een veld verwacht.","verify_expect":null,"fix_summary":"Geef elk formulierveld een zichtbaar label dat met for en id is gekoppeld."}},"maturity":"recommended","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.form-autocomplete","name":"Form field autocomplete","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.form-autocomplete","expect":null},"fix":{"steps":[{"action":"Add the matching WHATWG autocomplete token to each personal data field.","order":1,"language":"html","code_example":"<input name=\"email\" type=\"email\" autocomplete=\"email\">\n<input name=\"name\" autocomplete=\"name\">"}],"summary":"Add autocomplete tokens to personal data fields.","skill":{"name":"content-semantics","anchor":"ia.form-autocomplete"}},"category":"semantics","aggregate":null,"references":[{"title":"WHATWG Autofill","kind":"spec","url":"https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#autofill"},{"title":"WCAG Identify Input Purpose","kind":"spec","url":"https://www.w3.org/WAI/WCAG22/Understanding/identify-input-purpose.html"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"WHATWG Autofill","url":"https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#autofill"},"why":"The autocomplete attribute tells AI agents and browsers what type of data a field expects (email, name, address). This semantic hint helps AI agents fill forms accurately without guessing field purposes from visual context.","profiles":["browser_agent_usability"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"3.10","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.form-autocomplete","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Autocomplete in formuliervelden","steps":["Voeg het passende WHATWG-autocomplete-token toe aan elk veld met persoonsgegevens."],"why":"Het autocomplete-attribuut vertelt AI-agents en browsers welk type data een veld verwacht (e-mail, naam, adres). Agents vullen formulieren dan correct in zonder te gokken.","verify_expect":null,"fix_summary":"Voeg autocomplete-tokens toe aan velden met persoonsgegevens."}},"maturity":"recommended","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.keyboard-navigation","name":"Keyboard navigability","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.keyboard-navigation","expect":null},"fix":{"steps":[{"action":"Replace tabindex values above 0 with 0 or remove them.","order":1,"language":null,"code_example":null},{"action":"Use native button and a elements, or add tabindex=\"0\" and a role to custom controls.","order":2,"language":"html","code_example":"<div role=\"button\" tabindex=\"0\">Open menu</div>"}],"summary":"Remove positive tabindex values and make custom controls focusable.","skill":{"name":"content-semantics","anchor":"ia.keyboard-navigation"}},"category":"semantics","aggregate":null,"references":[{"title":"MDN tabindex","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex"},{"title":"W3C Focus Order","kind":"spec","url":"https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"MDN tabindex","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex"},"why":"AI agents navigate pages using keyboard-style interactions via the accessibility tree. Positive tabindex values break natural focus order, and missing focusable elements on interactive widgets prevent AI agents from discovering and operating controls.","profiles":["browser_agent_usability"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"3.11","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.keyboard-navigation","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Toetsenbordnavigatie","steps":["Vervang tabindex-waarden boven 0 door 0 of verwijder ze.","Gebruik native button- en a-elementen, of voeg tabindex=\"0\" en een role toe aan eigen controls."],"why":"AI-agents navigeren via toetsenbordachtige interacties in de accessibility tree. Positieve tabindex-waarden breken de focusvolgorde, en widgets zonder focus zijn onvindbaar.","verify_expect":null,"fix_summary":"Verwijder positieve tabindex-waarden en maak eigen controls focusbaar."}},"maturity":"recommended","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.document-title","name":"Document title","verify":{"command":"curl -sf https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.document-title","expect":"The head contains a non-empty title element"},"fix":{"steps":[{"action":"Add a title element in the head with the page topic and the site name.","order":1,"language":"html","code_example":"<title>Pricing - Example</title>"}],"summary":"Give each page a unique, descriptive title element.","skill":{"name":"content-semantics","anchor":"ia.document-title"}},"category":"semantics","aggregate":null,"references":[{"title":"MDN title element","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Element/title"},{"title":"WCAG Page Titled","kind":"spec","url":"https://www.w3.org/WAI/WCAG22/Understanding/page-titled.html"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-READ-03","url":"https://www.agentready.org/#read"},"why":"AI agents use the <title> element as the primary label when citing, indexing, or summarizing a page. A missing, empty, or generic title makes your page unidentifiable in AI-generated responses and search results.","profiles":["ai_search_visibility","browser_agent_usability"],"score_role":"core","ar_strengths":{"AR-READ-03":"SHOULD"},"ar_practice_ids":["AR-READ-03"],"legacy_id":"3.12","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.document-title","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Documenttitel","steps":["Voeg een title-element in de head toe met het paginaonderwerp en de sitenaam."],"why":"AI-agents gebruiken het <title>-element als hoofdlabel om een pagina te citeren, te indexeren of samen te vatten. Een ontbrekende of algemene titel maakt de pagina onherkenbaar.","verify_expect":"De head bevat een title-element dat niet leeg is","fix_summary":"Geef elke pagina een unieke, beschrijvende title."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"partial","evidence_type":"recommendation"},{"id":"ia.button-names","name":"Button accessible names","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.button-names","expect":null},"fix":{"steps":[{"action":"Add visible text to each button, or an aria-label for icon buttons.","order":1,"language":"html","code_example":"<button type=\"button\" aria-label=\"Close dialog\"><svg aria-hidden=\"true\">...</svg></button>"}],"summary":"Give each button a text or an aria-label.","skill":{"name":"content-semantics","anchor":"ia.button-names"}},"category":"semantics","aggregate":null,"references":[{"title":"WCAG Name, Role, Value","kind":"spec","url":"https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html"},{"title":"MDN button element","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"WCAG Name, Role, Value","url":"https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html"},"why":"AI agents invoke buttons by their accessible name in the accessibility tree. Without a discernible name, an AI agent cannot identify what a button does, making form submission and page interaction impossible.","profiles":["browser_agent_usability"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"3.13","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.button-names","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Toegankelijke namen van knoppen","steps":["Voeg zichtbare tekst toe aan elke knop, of een aria-label voor icoonknoppen."],"why":"AI-agents activeren knoppen via hun toegankelijke naam in de accessibility tree. Zonder naam weet een agent niet wat een knop doet.","verify_expect":null,"fix_summary":"Geef elke knop een tekst of een aria-label."}},"maturity":"recommended","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.aria-hidden","name":"aria-hidden misuse","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.aria-hidden","expect":null},"fix":{"steps":[{"action":"Remove aria-hidden=\"true\" from the body element.","order":1,"language":null,"code_example":null},{"action":"Remove aria-hidden from links, buttons and inputs, or make them not focusable.","order":2,"language":null,"code_example":null}],"summary":"Remove aria-hidden from the body and from focusable elements.","skill":{"name":"content-semantics","anchor":"ia.aria-hidden"}},"category":"semantics","aggregate":null,"references":[{"title":"MDN aria-hidden","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-hidden"},{"title":"WCAG Name, Role, Value","kind":"spec","url":"https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"MDN aria-hidden","url":"https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-hidden"},"why":"aria-hidden=\"true\" removes elements from the accessibility tree. When applied to the <body> or to focusable elements, it corrupts the tree that AI agents navigate, causing them to miss content or encounter invisible controls.","profiles":["browser_agent_usability"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"3.14","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.aria-hidden","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Verkeerd gebruik van aria-hidden","steps":["Verwijder aria-hidden=\"true\" van het body-element.","Verwijder aria-hidden van links, knoppen en inputs, of maak ze niet focusbaar."],"why":"aria-hidden=\"true\" haalt elementen uit de accessibility tree. Op de <body> of op focusbare elementen beschadigt dat de tree die AI-agents gebruiken.","verify_expect":null,"fix_summary":"Verwijder aria-hidden van de body en van focusbare elementen."}},"maturity":"recommended","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.widget-state","name":"Dynamic widget state","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.widget-state","expect":null},"fix":{"steps":[{"action":"Add aria-expanded and aria-controls to disclosure buttons.","order":1,"language":"html","code_example":"<button aria-expanded=\"false\" aria-controls=\"filters\">Filters</button>\n<section id=\"filters\" hidden>...</section>"},{"action":"Add aria-selected to tabs, aria-checked to switches and role=\"status\" to async messages.","order":2,"language":null,"code_example":null}],"summary":"Expose the state of interactive widgets with ARIA state attributes.","skill":{"name":"content-semantics","anchor":"ia.widget-state"}},"category":"semantics","aggregate":null,"references":[{"title":"WAI-ARIA Authoring Practices","kind":"guide","url":"https://www.w3.org/WAI/ARIA/apg/"},{"title":"MDN ARIA states and properties","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes"},{"title":"WCAG Name, Role, Value","kind":"spec","url":"https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"WAI-ARIA Authoring Practices","url":"https://www.w3.org/WAI/ARIA/apg/"},"why":"Agents operate interactive widgets through the accessibility tree. Expandable panels, tabs, menus, switches, dialogs, and async status areas need explicit state so agents can tell what is open, selected, checked, current, or updating.","profiles":["browser_agent_usability"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"3.15","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.widget-state","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Status van dynamische widgets","steps":["Voeg aria-expanded en aria-controls toe aan uitklapknoppen.","Voeg aria-selected toe aan tabs, aria-checked aan schakelaars en role=\"status\" aan asynchrone meldingen."],"why":"Agents bedienen interactieve widgets via de accessibility tree. Panelen, tabs, menu's, schakelaars, dialogen en statusgebieden hebben een expliciete status nodig, zodat agents zien wat open, gekozen of bezig is.","verify_expect":null,"fix_summary":"Toon de status van interactieve widgets met ARIA-statusattributen."}},"maturity":"recommended","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.webmcp-declarative","name":"WebMCP declarative API","verify":{"command":"curl -sf https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.webmcp-declarative","expect":"The HTML contains a form with toolname and tooldescription attributes"},"fix":{"steps":[{"action":"Add toolname and tooldescription to each form that agents may use.","order":1,"language":"html","code_example":"<form toolname=\"search\" tooldescription=\"Search products by keyword\">\n  <input name=\"q\" toolparamdescription=\"Search keywords\">\n</form>"},{"action":"Or register tools in JavaScript with document.modelContext.registerTool().","order":2,"language":"javascript","code_example":"document.modelContext.registerTool({\n  name: \"search\",\n  description: \"Search products\",\n  inputSchema: {type: \"object\", properties: {q: {type: \"string\"}}},\n  execute: async ({q}) => ({content: []})\n});"}],"summary":"Annotate your main forms with WebMCP toolname and tooldescription attributes.","skill":{"name":"agent-protocols","anchor":"ia.webmcp-declarative"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"WebMCP specification","kind":"guide","url":"https://webmachinelearning.github.io/webmcp/"},{"title":"WebMCP Chrome Early Preview","kind":"guide","url":"https://developer.chrome.com/blog/webmcp-epp"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"experimental","evidence_source":{"title":"agentready.org AR-ACT-07","url":"https://www.agentready.org/#act"},"why":"WebMCP form annotations describe potential browser tools. Static source inspection does not execute the tools or verify that a signed-in task can finish.","profiles":["browser_agent_usability","api_tool_readiness"],"score_role":"informational","ar_strengths":{"AR-ACT-07":"SHOULD"},"ar_practice_ids":["AR-ACT-07"],"legacy_id":"4.1","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.webmcp-declarative","strength_source":"agentready","i18n":{"nl":{"name":"WebMCP declaratieve API","steps":["Voeg toolname en tooldescription toe aan elk formulier dat agents mogen gebruiken.","Of registreer tools in JavaScript met document.modelContext.registerTool()."],"why":"WebMCP-formulierannotaties beschrijven mogelijke browsertools. Statische broninspectie voert de tools niet uit en verifieert niet dat een aangemelde taak kan worden afgerond.","verify_expect":"De HTML bevat een formulier met de attributen toolname en tooldescription","fix_summary":"Annoteer je belangrijkste formulieren met de WebMCP-attributen toolname en tooldescription."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["mcp"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.a2a-agent-card","name":"A2A Agent Card","verify":{"command":"curl -sf https://{domain}/.well-known/agent-card.json | jq -e '.name and .url'","rescan":"isagentready results {domain} --checkpoint ia.a2a-agent-card","expect":"exit code 0"},"fix":{"steps":[{"action":"Create /.well-known/agent-card.json with the required A2A 1.0 fields.","order":1,"language":"json","code_example":"{\n  \"name\": \"Example agent\",\n  \"description\": \"Answers questions about Example products\",\n  \"url\": \"https://example.com/a2a\",\n  \"version\": \"1.0.0\",\n  \"capabilities\": {\"streaming\": false},\n  \"supportedInterfaces\": [{\"url\": \"https://example.com/a2a\", \"protocolBinding\": \"JSONRPC\"}],\n  \"skills\": [{\"id\": \"search\", \"name\": \"Search\", \"description\": \"Search the catalog\"}]\n}"},{"action":"Serve the file as application/json with HTTP 200.","order":2,"language":null,"code_example":null}],"summary":"Serve an A2A Agent Card with name, description, url, capabilities and supportedInterfaces.","skill":{"name":"agent-protocols","anchor":"ia.a2a-agent-card"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"A2A 1.0 specification","kind":"spec","url":"https://a2a-protocol.org/latest/specification/"}],"expected":"JSON document with name, description, url, capabilities","stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-READ-06","url":"https://www.agentready.org/#read"},"why":"The Agent2Agent (A2A) protocol enables autonomous agent-to-agent communication. An Agent Card at /.well-known/agent-card.json advertises the agent's capabilities and supported A2A interfaces.","profiles":["api_tool_readiness"],"score_role":"bonus","ar_strengths":{"AR-READ-06":"SHOULD"},"ar_practice_ids":["AR-READ-06"],"legacy_id":"4.3","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.a2a-agent-card","strength_source":"isagentready_policy","i18n":{"nl":{"name":"A2A Agent Card","steps":["Maak /.well-known/agent-card.json met de verplichte A2A 1.0-velden.","Lever het bestand als application/json met HTTP 200."],"why":"Het Agent2Agent-protocol (A2A) maakt communicatie tussen agents mogelijk. Een Agent Card op /.well-known/agent-card.json beschrijft de mogelijkheden en de ondersteunde A2A-interfaces van de agent.","verify_expect":"exitcode 0","fix_summary":"Lever een A2A Agent Card met name, description, url, capabilities en supportedInterfaces."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api"]},"strength":"MAY","ar_mapping":"partial","evidence_type":"recommendation"},{"id":"ia.mcp-discovery","name":"MCP discovery","verify":{"command":"curl -sf https://{domain}/.well-known/mcp/server-card.json | jq -e '.serverInfo.name or .name'","rescan":"isagentready results {domain} --checkpoint ia.mcp-discovery","expect":"exit code 0"},"fix":{"steps":[{"action":"Create /.well-known/mcp/server-card.json with serverInfo.name and a transport.","order":1,"language":"json","code_example":"{\n  \"serverInfo\": {\"name\": \"Example MCP\", \"version\": \"1.0.0\"},\n  \"transport\": {\"type\": \"streamable-http\", \"endpoint\": \"https://example.com/mcp\"}\n}"},{"action":"Link the MCP endpoint from llms.txt and the AI Catalog.","order":2,"language":null,"code_example":null}],"summary":"Publish an MCP server card with serverInfo and a transport object.","skill":{"name":"agent-protocols","anchor":"ia.mcp-discovery"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"Model Context Protocol","kind":"guide","url":"https://modelcontextprotocol.io"},{"title":"MCP specification","kind":"spec","url":"https://spec.modelcontextprotocol.io"},{"title":"SEP-1649 server card","kind":"guide","url":"https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2127"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-ACT-03","url":"https://www.agentready.org/#act"},"why":"The Model Context Protocol (MCP) by Anthropic is the standard for connecting AI assistants to external tools and data. A discovery document lets AI systems find and connect to your MCP server. SEP-1649 (modelcontextprotocol PR 2127) defines the new server-card.json schema with serverInfo, transport, and capabilities fields.","profiles":["api_tool_readiness"],"score_role":"bonus","ar_strengths":{"AR-ACT-03":"SHOULD","AR-ACT-10":"MUST"},"ar_practice_ids":["AR-ACT-03","AR-ACT-10"],"legacy_id":"4.4","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.mcp-discovery","strength_source":"isagentready_policy","i18n":{"nl":{"name":"MCP-discovery","steps":["Maak /.well-known/mcp/server-card.json met serverInfo.name en een transport.","Link het MCP-endpoint vanuit llms.txt en de AI Catalog."],"why":"Het Model Context Protocol (MCP) is de standaard om AI-assistenten met externe tools en data te verbinden. Een discoverydocument laat AI-systemen je MCP-server vinden en verbinden.","verify_expect":"exitcode 0","fix_summary":"Publiceer een MCP-servercard met serverInfo en een transport-object."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api"]},"strength":"MAY","ar_mapping":"partial","evidence_type":"scanner_data"},{"id":"ia.openapi","name":"OpenAPI / API docs","verify":{"command":"curl -sf https://{domain}/openapi.json | jq -e '.openapi | startswith(\"3.\")'","rescan":"isagentready results {domain} --checkpoint ia.openapi","expect":"exit code 0"},"fix":{"steps":[{"action":"Generate an OpenAPI 3.1 document from the API code.","order":1,"language":"json","code_example":"{\n  \"openapi\": \"3.1.0\",\n  \"info\": {\"title\": \"Example API\", \"version\": \"1.0.0\"},\n  \"paths\": {\"/api/search\": {\"get\": {\"operationId\": \"search\", \"summary\": \"Search items\"}}}\n}"},{"action":"Serve it at /openapi.json or /.well-known/openapi with HTTP 200.","order":2,"language":null,"code_example":null},{"action":"Link it from the API catalog and a service-desc Link header.","order":3,"language":null,"code_example":null}],"summary":"Publish an OpenAPI 3.x document at /openapi.json and link it.","skill":{"name":"agent-protocols","anchor":"ia.openapi"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"OpenAPI Specification","kind":"spec","url":"https://spec.openapis.org/oas/latest.html"},{"title":"Swagger Editor","kind":"guide","url":"https://editor.swagger.io/"}],"expected":"OpenAPI 3.x document at a well-known location","stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-ACT-02","url":"https://www.agentready.org/#act"},"why":"OpenAPI specifications let AI agents understand and call your API programmatically. AI coding assistants and agent frameworks use OpenAPI to generate correct API calls automatically.","profiles":["api_tool_readiness","agentic_commerce"],"score_role":"core","ar_strengths":{"AR-ACT-02":"SHOULD"},"ar_practice_ids":["AR-ACT-02"],"legacy_id":"4.5","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.openapi","strength_source":"agentready","i18n":{"nl":{"name":"OpenAPI / API-docs","steps":["Genereer een OpenAPI 3.1-document uit de API-code.","Lever het op /openapi.json of /.well-known/openapi met HTTP 200.","Link het vanuit de API-catalogus en een service-desc-Link-header."],"why":"OpenAPI-specificaties laten AI-agents je API begrijpen en aanroepen. AI-codeassistenten en agentframeworks gebruiken OpenAPI om correcte API-calls te maken.","verify_expect":"exitcode 0","fix_summary":"Publiceer een OpenAPI 3.x-document op /openapi.json en link het."}},"maturity":"recommended","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"measured_study"},{"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-30","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","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"4.6","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.agents-json","strength_source":"isagentready_policy","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.","verify_expect":"exitcode 0","fix_summary":"Publiceer /.well-known/agents.json met je agentendpoints."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api"]},"strength":"MAY","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.webmcp-form-quality","name":"Declarative form quality","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.webmcp-form-quality","expect":null},"fix":{"steps":[{"action":"Use a snake_case toolname that names the action.","order":1,"language":null,"code_example":null},{"action":"Add toolparamdescription and a label to each field.","order":2,"language":"html","code_example":"<form toolname=\"search_products\" tooldescription=\"Search products by keyword and category\">\n  <label for=\"q\">Query</label>\n  <input id=\"q\" name=\"q\" toolparamdescription=\"Search keywords\">\n</form>"}],"summary":"Give each WebMCP form a clear tool name, a description and parameter descriptions.","skill":{"name":"agent-protocols","anchor":"ia.webmcp-form-quality"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"WebMCP specification","kind":"guide","url":"https://webmachinelearning.github.io/webmcp/"},{"title":"WebMCP Chrome Early Preview","kind":"guide","url":"https://developer.chrome.com/blog/webmcp-epp"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"experimental","evidence_source":{"title":"agentready.org AR-ACT-07","url":"https://www.agentready.org/#act"},"why":"High-quality declarative annotations help AI agents understand form purpose, field semantics, and expected input - reducing errors and improving tool invocation accuracy.","profiles":["browser_agent_usability","api_tool_readiness"],"score_role":"informational","ar_strengths":{"AR-ACT-07":"SHOULD"},"ar_practice_ids":["AR-ACT-07"],"legacy_id":"4.7","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.webmcp-form-quality","strength_source":"agentready","i18n":{"nl":{"name":"Kwaliteit van declaratieve formulieren","steps":["Gebruik een toolname in snake_case die de actie noemt.","Voeg toolparamdescription en een label toe aan elk veld."],"why":"Goede declaratieve annotaties helpen AI-agents om het doel van een formulier, de velden en de verwachte input te begrijpen. Dat geeft minder fouten bij het aanroepen van tools.","verify_expect":null,"fix_summary":"Geef elk WebMCP-formulier een duidelijke toolnaam, een beschrijving en parameterbeschrijvingen."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["mcp"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.interactive-surface-coverage","name":"Interactive surface coverage","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.interactive-surface-coverage","expect":null},"fix":{"steps":[{"action":"List the forms on the page that agents need for tasks.","order":1,"language":null,"code_example":null},{"action":"Add WebMCP annotations to each form in the list.","order":2,"language":null,"code_example":null}],"summary":"Annotate each important interactive form on the page with WebMCP.","skill":{"name":"agent-protocols","anchor":"ia.interactive-surface-coverage"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"WebMCP specification","kind":"guide","url":"https://webmachinelearning.github.io/webmcp/"},{"title":"WebMCP Chrome Early Preview","kind":"guide","url":"https://developer.chrome.com/blog/webmcp-epp"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":["2026-08-29"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"experimental","evidence_source":{"title":"agentready.org AR-ACT-07","url":"https://www.agentready.org/#act"},"why":"Higher coverage of interactive surfaces with WebMCP annotations means AI agents can perform more actions on your site without screen scraping or brittle heuristics.","profiles":["browser_agent_usability","api_tool_readiness"],"score_role":"informational","ar_strengths":{"AR-ACT-07":"SHOULD"},"ar_practice_ids":["AR-ACT-07"],"legacy_id":"4.9","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.interactive-surface-coverage","strength_source":"agentready","i18n":{"nl":{"name":"Dekking van interactieve onderdelen","steps":["Maak een lijst van de formulieren op de pagina die agents voor taken nodig hebben.","Voeg WebMCP-annotaties toe aan elk formulier in de lijst."],"why":"Hoe meer interactieve onderdelen WebMCP-annotaties hebben, hoe meer acties AI-agents kunnen doen zonder screen scraping of fragiele heuristiek.","verify_expect":null,"fix_summary":"Annoteer elk belangrijk interactief formulier op de pagina met WebMCP."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["mcp"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.api-catalog","name":"API Catalog (RFC 9727)","verify":{"command":"curl -sf https://{domain}/.well-known/api-catalog | jq -e '.linkset | length > 0'","rescan":"isagentready results {domain} --checkpoint ia.api-catalog","expect":"exit code 0"},"fix":{"steps":[{"action":"Create a linkset with one entry per API and service-desc, service-doc and status links.","order":1,"language":"json","code_example":"{\n  \"linkset\": [{\n    \"anchor\": \"https://example.com/api/v1\",\n    \"service-desc\": [{\"href\": \"https://example.com/openapi.json\", \"type\": \"application/openapi+json\"}],\n    \"service-doc\": [{\"href\": \"https://example.com/docs\", \"type\": \"text/html\"}]\n  }]\n}"},{"action":"Serve it at /.well-known/api-catalog with Content-Type application/linkset+json.","order":2,"language":null,"code_example":null}],"summary":"Serve /.well-known/api-catalog as an application/linkset+json document.","skill":{"name":"agent-protocols","anchor":"ia.api-catalog"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"RFC 9727 API Catalog","kind":"spec","url":"https://datatracker.ietf.org/doc/rfc9727/"},{"title":"RFC 9264 Linkset","kind":"spec","url":"https://datatracker.ietf.org/doc/rfc9264/"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-READ-06","url":"https://www.agentready.org/#read"},"why":"An API Catalog (RFC 9727 with an RFC 9264 linkset) gives agents one discovery endpoint for all APIs of the site. It links to OpenAPI documents, human docs and health endpoints.","profiles":["api_tool_readiness"],"score_role":"bonus","ar_strengths":{"AR-ACT-02":"SHOULD","AR-READ-06":"SHOULD"},"ar_practice_ids":["AR-READ-06","AR-ACT-02"],"legacy_id":"4.10","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.api-catalog","strength_source":"agentready","i18n":{"nl":{"name":"API Catalog (RFC 9727)","steps":["Maak een linkset met een entry per API en links voor service-desc, service-doc en status.","Lever het op /.well-known/api-catalog met Content-Type application/linkset+json."],"why":"Een API Catalog (RFC 9727 met een RFC 9264-linkset) geeft agents een discoverypunt voor alle API's van de site. Het linkt naar OpenAPI-documenten, docs en health-endpoints.","verify_expect":"exitcode 0","fix_summary":"Lever /.well-known/api-catalog als application/linkset+json-document."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.agent-skills-index","name":"Agent Skills index","verify":{"command":"curl -sf https://{domain}/.well-known/agent-skills/index.json | jq -e '.skills | length > 0'","rescan":"isagentready results {domain} --checkpoint ia.agent-skills-index","expect":"exit code 0"},"fix":{"steps":[{"action":"Write a SKILL.md for each task that agents do on your site.","order":1,"language":null,"code_example":null},{"action":"List the skills in the index with name, type, description, url and digest.","order":2,"language":"json","code_example":"{\n  \"version\": \"0.2.0\",\n  \"skills\": [{\n    \"name\": \"search-products\",\n    \"type\": \"skill-md\",\n    \"description\": \"Search the product catalog\",\n    \"url\": \"https://example.com/.well-known/agent-skills/search-products/SKILL.md\",\n    \"digest\": \"sha256:<64 hex>\"\n  }]\n}"}],"summary":"Publish /.well-known/agent-skills/index.json with a digest for each skill.","skill":{"name":"agent-protocols","anchor":"ia.agent-skills-index"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"cloudflare/agent-skills-discovery-rfc","kind":"guide","url":"https://github.com/cloudflare/agent-skills-discovery-rfc"},{"title":"agentskills.io","kind":"guide","url":"https://agentskills.io"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-ACT-06","url":"https://www.agentready.org/#act"},"why":"An Agent Skills index lets a site publish a list of agent skills with SHA-256 digests of the SKILL.md content. Agents can then install and verify the skills.","profiles":["api_tool_readiness"],"score_role":"bonus","ar_strengths":{"AR-ACT-06":"SHOULD"},"ar_practice_ids":["AR-ACT-06"],"legacy_id":"4.11","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.agent-skills-index","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Agent Skills-index","steps":["Schrijf een SKILL.md voor elke taak die agents op je site doen.","Zet de skills in de index met name, type, description, url en digest."],"why":"Een Agent Skills-index laat een site een lijst van agentskills publiceren met SHA-256-digests van de SKILL.md-content. Agents kunnen de skills dan installeren en verifieren.","verify_expect":"exitcode 0","fix_summary":"Publiceer /.well-known/agent-skills/index.json met een digest per skill."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api"]},"strength":"MAY","ar_mapping":"partial","evidence_type":"recommendation"},{"id":"ia.x402","name":"x402 payments","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.x402","expect":null},"fix":{"steps":[{"action":"Choose the paid endpoints and the price per call.","order":1,"language":null,"code_example":null},{"action":"Return HTTP 402 with the x402 payment requirements when a request has no payment.","order":2,"language":null,"code_example":null}],"summary":"Return HTTP 402 with an x402 payment challenge on paid endpoints.","skill":{"name":"agent-protocols","anchor":"ia.x402"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"x402 protocol","kind":"guide","url":"https://www.x402.org"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"experimental","evidence_source":{"title":"agentready.org AR-ACT-08","url":"https://www.agentready.org/#act"},"why":"The x402 protocol uses HTTP 402 Payment Required responses so agents can negotiate micropayments before consuming a paid API. A commerce site that supports x402 lets agents transact without manual checkout.","profiles":["agentic_commerce"],"score_role":"informational","ar_strengths":{"AR-ACT-08":"MAY"},"ar_practice_ids":["AR-ACT-08"],"legacy_id":"4.12","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.x402","strength_source":"isagentready_policy","i18n":{"nl":{"name":"x402-betalingen","steps":["Kies de betaalde endpoints en de prijs per call.","Geef HTTP 402 met de x402-betaalvereisten terug als een request geen betaling heeft."],"why":"Het x402-protocol gebruikt HTTP 402 Payment Required, zodat agents microbetalingen kunnen regelen voordat ze een betaalde API gebruiken. Agents betalen dan zonder handmatige checkout.","verify_expect":null,"fix_summary":"Geef HTTP 402 met een x402-betaalchallenge terug op betaalde endpoints."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["commerce"]},"strength":"MAY","ar_mapping":"partial","evidence_type":"recommendation"},{"id":"ia.mpp","name":"MPP (x-payment-info)","verify":{"command":"curl -sf https://{domain}/openapi.json | jq -e '[.. | objects | has(\"x-payment-info\")] | any'","rescan":"isagentready results {domain} --checkpoint ia.mpp","expect":"exit code 0"},"fix":{"steps":[{"action":"Add an x-payment-info object to each paid operation in the OpenAPI document.","order":1,"language":"json","code_example":"\"x-payment-info\": {\"price\": \"0.01\", \"currency\": \"USD\", \"protocols\": [\"x402\"]}"}],"summary":"Annotate paid OpenAPI operations with x-payment-info.","skill":{"name":"agent-protocols","anchor":"ia.mpp"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"Merchant Payments Protocol","kind":"guide","url":"https://merchantpaymentsprotocol.org"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"experimental","evidence_source":{"title":"agentready.org AR-ACT-08","url":"https://www.agentready.org/#act"},"why":"The Merchant Payments Protocol (MPP) extends OpenAPI with x-payment-info on individual operations so agents know which calls are paid and how to settle them.","profiles":["agentic_commerce"],"score_role":"informational","ar_strengths":{"AR-ACT-08":"MAY"},"ar_practice_ids":["AR-ACT-08"],"legacy_id":"4.13","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.mpp","strength_source":"isagentready_policy","i18n":{"nl":{"name":"MPP (x-payment-info)","steps":["Voeg een x-payment-info-object toe aan elke betaalde operatie in het OpenAPI-document."],"why":"Het Merchant Payments Protocol (MPP) voegt x-payment-info toe aan OpenAPI-operaties, zodat agents weten welke calls betaald zijn en hoe ze afrekenen.","verify_expect":"exitcode 0","fix_summary":"Annoteer betaalde OpenAPI-operaties met x-payment-info."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["commerce"]},"strength":"MAY","ar_mapping":"partial","evidence_type":"recommendation"},{"id":"ia.ucp","name":"UCP","verify":{"command":"curl -sf https://{domain}/.well-known/ucp | jq -e 'type == \"object\"'","rescan":"isagentready results {domain} --checkpoint ia.ucp","expect":"exit code 0"},"fix":{"steps":[{"action":"Describe the commerce capabilities, payment handlers and endpoints in the profile.","order":1,"language":null,"code_example":null},{"action":"Serve the profile as JSON with HTTP 200.","order":2,"language":null,"code_example":null}],"summary":"Serve a Universal Commerce Profile at /.well-known/ucp.","skill":{"name":"agent-protocols","anchor":"ia.ucp"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"Universal Commerce Profile","kind":"guide","url":"https://universalcommerce.org"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"experimental","evidence_source":{"title":"agentready.org AR-ACT-08","url":"https://www.agentready.org/#act"},"why":"Universal Commerce Profile (UCP) at /.well-known/ucp publishes a machine-readable profile of a merchant's commerce capabilities so agents can negotiate purchases.","profiles":["agentic_commerce"],"score_role":"informational","ar_strengths":{"AR-ACT-08":"MAY","AR-READ-06":"SHOULD"},"ar_practice_ids":["AR-ACT-08","AR-READ-06"],"legacy_id":"4.14","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.ucp","strength_source":"isagentready_policy","i18n":{"nl":{"name":"UCP","steps":["Beschrijf de commerce-mogelijkheden, betaalhandlers en endpoints in het profiel.","Lever het profiel als JSON met HTTP 200."],"why":"Een Universal Commerce Profile (UCP) op /.well-known/ucp publiceert een machineleesbaar profiel van de commerce-mogelijkheden van een merchant, zodat agents aankopen kunnen regelen.","verify_expect":"exitcode 0","fix_summary":"Lever een Universal Commerce Profile op /.well-known/ucp."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["commerce"]},"strength":"MAY","ar_mapping":"partial","evidence_type":"recommendation"},{"id":"ia.acp-manifest","name":"ACP manifest","verify":{"command":"curl -sf https://{domain}/.well-known/acp.json | jq -e 'type == \"object\"'","rescan":"isagentready results {domain} --checkpoint ia.acp-manifest","expect":"exit code 0"},"fix":{"steps":[{"action":"List the checkout endpoints and supported flows in /.well-known/acp.json.","order":1,"language":null,"code_example":null},{"action":"Serve the file as application/json with HTTP 200.","order":2,"language":null,"code_example":null}],"summary":"Serve an Agentic Commerce Protocol discovery document at /.well-known/acp.json.","skill":{"name":"agent-protocols","anchor":"ia.acp-manifest"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"Agentic Commerce Protocol","kind":"guide","url":"https://agenticcommerce.org"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"experimental","evidence_source":{"title":"agentready.org AR-ACT-08","url":"https://www.agentready.org/#act"},"why":"Agentic Commerce Protocol (ACP) discovery document at /.well-known/acp.json advertises commerce endpoints, supported flows, and capabilities for autonomous agents.","profiles":["agentic_commerce"],"score_role":"informational","ar_strengths":{"AR-ACT-08":"MAY","AR-READ-06":"SHOULD"},"ar_practice_ids":["AR-ACT-08","AR-READ-06"],"legacy_id":"4.15","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.acp-manifest","strength_source":"isagentready_policy","i18n":{"nl":{"name":"ACP-manifest","steps":["Zet de checkout-endpoints en ondersteunde flows in /.well-known/acp.json.","Lever het bestand als application/json met HTTP 200."],"why":"Een discoverydocument voor het Agentic Commerce Protocol (ACP) op /.well-known/acp.json noemt commerce-endpoints, flows en mogelijkheden voor autonome agents.","verify_expect":"exitcode 0","fix_summary":"Lever een Agentic Commerce Protocol-discoverydocument op /.well-known/acp.json."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["commerce"]},"strength":"MAY","ar_mapping":"partial","evidence_type":"recommendation"},{"id":"ia.ap2","name":"AP2","verify":{"command":"curl -sf https://{domain}/.well-known/agent-card.json | jq -e '[.extensions[]?.uri | test(\"ap2\")] | any'","rescan":"isagentready results {domain} --checkpoint ia.ap2","expect":"exit code 0"},"fix":{"steps":[{"action":"Add an extensions entry with a uri that points to the AP2 specification.","order":1,"language":"json","code_example":"\"extensions\": [{\"uri\": \"https://google.github.io/A2A/extensions/ap2\", \"required\": false}]"}],"summary":"Add an AP2 entry to the extensions array of the A2A Agent Card.","skill":{"name":"agent-protocols","anchor":"ia.ap2"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"Google A2A Protocol","kind":"spec","url":"https://a2a-protocol.org/latest/specification/"},{"title":"AP2 Agent Payments Protocol","kind":"guide","url":"https://github.com/google/A2A/blob/main/docs/payments.md"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"experimental","evidence_source":{"title":"agentready.org AR-ACT-08","url":"https://www.agentready.org/#act"},"why":"Agent Payments Protocol (AP2) declares payment capability via the A2A Agent Card. The canonical encoding is an entry in the `extensions` array whose `uri` references AP2; agents inspect this array to know your service can transact.","profiles":["agentic_commerce"],"score_role":"informational","ar_strengths":{"AR-ACT-08":"MAY"},"ar_practice_ids":["AR-ACT-08"],"legacy_id":"4.16","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.ap2","strength_source":"isagentready_policy","i18n":{"nl":{"name":"AP2","steps":["Voeg een extensions-entry toe met een uri die naar de AP2-specificatie verwijst."],"why":"Het Agent Payments Protocol (AP2) declareert betaalmogelijkheden via de A2A Agent Card. Een entry in de extensions-array met een uri naar AP2 vertelt agents dat je service kan afrekenen.","verify_expect":"exitcode 0","fix_summary":"Voeg een AP2-entry toe aan de extensions-array van de A2A Agent Card."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["commerce"]},"strength":"MAY","ar_mapping":"partial","evidence_type":"recommendation"},{"id":"ia.openapi-quality","name":"OpenAPI actionability quality","verify":{"command":"curl -sf https://{domain}/openapi.json | jq -e '[.paths[][] | objects | has(\"operationId\")] | all'","rescan":"isagentready results {domain} --checkpoint ia.openapi-quality","expect":"exit code 0"},"fix":{"steps":[{"action":"Add a unique operationId and a description to each operation.","order":1,"language":null,"code_example":null},{"action":"Add a schema with a type to each parameter and each response.","order":2,"language":"json","code_example":"\"parameters\": [{\"name\": \"q\", \"in\": \"query\", \"required\": true, \"schema\": {\"type\": \"string\"}}]"}],"summary":"Give each operation an operationId, a description, typed parameters and response schemas.","skill":{"name":"agent-protocols","anchor":"ia.openapi-quality"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"OpenAPI Specification","kind":"spec","url":"https://spec.openapis.org/oas/latest.html"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":["2026-08-29"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-ACT-02","url":"https://www.agentready.org/#act"},"why":"An OpenAPI document helps agents only when each operation is concrete. Agents need operationId, descriptions, typed parameters and response schemas to make a correct call.","profiles":["api_tool_readiness","agentic_commerce"],"score_role":"core","ar_strengths":{"AR-ACT-02":"SHOULD"},"ar_practice_ids":["AR-ACT-02"],"legacy_id":"4.17","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.openapi-quality","strength_source":"agentready","i18n":{"nl":{"name":"Bruikbaarheid van OpenAPI","steps":["Voeg een unieke operationId en een beschrijving toe aan elke operatie.","Voeg aan elke parameter en elke response een schema met type toe."],"why":"Een OpenAPI-document helpt agents alleen als elke operatie concreet is. Agents hebben operationId, beschrijvingen, getypeerde parameters en responseschema's nodig voor een correcte call.","verify_expect":"exitcode 0","fix_summary":"Geef elke operatie een operationId, een beschrijving, getypeerde parameters en responseschema's."}},"maturity":"recommended","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api","commerce"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.mcp-server-card","name":"MCP server card quality","verify":{"command":"curl -sf https://{domain}/.well-known/mcp/server-card.json | jq -e '.serverInfo and .transport and .capabilities'","rescan":"isagentready results {domain} --checkpoint ia.mcp-server-card","expect":"exit code 0"},"fix":{"steps":[{"action":"Complete the server card with all SEP-1649 fields.","order":1,"language":"json","code_example":"{\n  \"serverInfo\": {\"name\": \"Example MCP\", \"version\": \"1.0.0\"},\n  \"description\": \"Search and read product docs.\",\n  \"transport\": {\"type\": \"streamable-http\", \"endpoint\": \"https://example.com/mcp\"},\n  \"capabilities\": {\"tools\": {}},\n  \"auth\": {\"type\": \"oauth2\"}\n}"}],"summary":"Add serverInfo, a description, a transport, capabilities and auth to the server card.","skill":{"name":"agent-protocols","anchor":"ia.mcp-server-card"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"Model Context Protocol","kind":"guide","url":"https://modelcontextprotocol.io"},{"title":"MCP specification","kind":"spec","url":"https://spec.modelcontextprotocol.io"},{"title":"SEP-1649 server card","kind":"guide","url":"https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2127"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-ACT-04","url":"https://www.agentready.org/#act"},"why":"An MCP server card should be actionable, not just discoverable. Agents need identity, transport, capabilities, and auth metadata before they can connect safely.","profiles":["api_tool_readiness"],"score_role":"bonus","ar_strengths":{"AR-ACT-04":"MAY"},"ar_practice_ids":["AR-ACT-04"],"legacy_id":"4.18","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.mcp-server-card","strength_source":"agentready","i18n":{"nl":{"name":"Kwaliteit van de MCP-servercard","steps":["Vul de servercard aan met alle SEP-1649-velden."],"why":"Een MCP-servercard moet bruikbaar zijn, niet alleen vindbaar. Agents hebben identiteit, transport, capabilities en auth-metadata nodig voordat ze veilig verbinden.","verify_expect":"exitcode 0","fix_summary":"Voeg serverInfo, een beschrijving, een transport, capabilities en auth toe aan de servercard."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api"]},"strength":"MAY","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.openapi-live","name":"Live OpenAPI verification","verify":{"command":"curl -sf https://{domain}/openapi.json | jq -r '.paths | keys[]'","rescan":"isagentready results {domain} --checkpoint ia.openapi-live","expect":"A list of paths. Call one documented GET path with curl to check it."},"fix":{"steps":[{"action":"Document at least one GET operation that needs no auth, for example a health or a search endpoint.","order":1,"language":null,"code_example":null},{"action":"Make sure that the response matches the documented status and schema.","order":2,"language":null,"code_example":null}],"summary":"Make sure that one safe GET operation in the OpenAPI document works as documented.","skill":{"name":"agent-protocols","anchor":"ia.openapi-live"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"OpenAPI Specification","kind":"spec","url":"https://spec.openapis.org/oas/latest.html"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"supported","evidence_source":{"title":"agentready.org AR-ACT-02","url":"https://www.agentready.org/#act"},"why":"A machine-readable API description is more useful when one demonstrably safe operation also behaves as documented.","profiles":["api_tool_readiness"],"score_role":"core","ar_strengths":{"AR-ACT-02":"SHOULD"},"ar_practice_ids":["AR-ACT-02"],"legacy_id":"4.19","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.openapi-live","strength_source":"agentready","i18n":{"nl":{"name":"Live OpenAPI-verificatie","steps":["Documenteer minimaal een GET-operatie zonder auth, bijvoorbeeld een health- of zoekendpoint.","Zorg dat de response overeenkomt met de gedocumenteerde status en het schema."],"why":"Een machineleesbare API-beschrijving is nuttiger als een aantoonbaar veilige operatie zich ook gedraagt zoals beschreven.","verify_expect":"Een lijst met paden. Roep met curl één gedocumenteerd GET-pad aan om het te controleren.","fix_summary":"Zorg dat een veilige GET-operatie in het OpenAPI-document werkt zoals beschreven."}},"maturity":"recommended","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"measured_study"},{"id":"ia.mcp-live","name":"Live MCP verification","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.mcp-live","expect":null},"fix":{"steps":[{"action":"Serve the Streamable HTTP transport at the endpoint in the server card.","order":1,"language":null,"code_example":null},{"action":"Answer initialize and tools/list without auth for public tools.","order":2,"language":null,"code_example":null}],"summary":"Make sure that the MCP endpoint answers initialize and tools/list.","skill":{"name":"agent-protocols","anchor":"ia.mcp-live"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"MCP specification","kind":"spec","url":"https://spec.modelcontextprotocol.io"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":["2026-10-30"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"supported","evidence_source":{"title":"agentready.org AR-ACT-03","url":"https://www.agentready.org/#act"},"why":"Live read-only negotiation proves that discovered MCP metadata maps to a usable protocol endpoint.","profiles":["api_tool_readiness"],"score_role":"core","ar_strengths":{"AR-ACT-03":"SHOULD"},"ar_practice_ids":["AR-ACT-03"],"legacy_id":"4.20","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.mcp-live","strength_source":"agentready","i18n":{"nl":{"name":"Live MCP-verificatie","steps":["Lever het Streamable HTTP-transport op het endpoint uit de servercard.","Antwoord op initialize en tools/list zonder auth voor publieke tools."],"why":"Een live, alleen-lezen negotiatie bewijst dat de gevonden MCP-metadata naar een bruikbaar protocolendpoint leidt.","verify_expect":null,"fix_summary":"Zorg dat het MCP-endpoint antwoordt op initialize en tools/list."}},"maturity":"recommended","applicability":{"mode":"detected_surface","condition":null,"surfaces":["mcp"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"scanner_data"},{"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"},{"id":"ia.api-errors","name":"API error responses","verify":{"command":"curl -s https://{domain}/api/isagentready-missing-check | jq -e '.status or .error'","rescan":"isagentready results {domain} --checkpoint ia.api-errors","expect":"exit code 0"},"fix":{"steps":[{"action":"Return application/problem+json for each 4xx and 5xx response of the API.","order":1,"language":"json","code_example":"{\"type\": \"https://example.com/problems/not-found\", \"title\": \"Not found\", \"status\": 404, \"detail\": \"No such resource\"}"}],"summary":"Return RFC 9457 problem details as JSON for API errors.","skill":{"name":"agent-protocols","anchor":"ia.api-errors"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"RFC 9457: Problem Details for HTTP APIs","kind":"spec","url":"https://www.rfc-editor.org/rfc/rfc9457"}],"stage":"act","lifecycle":{"introduced":"2026-08-25","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"supported","evidence_source":{"title":"agentready.org AR-ACT-02","url":"https://www.agentready.org/#act"},"why":"Agents call APIs programmatically and cannot recover from an HTML error page. A JSON problem-details body with a machine-readable code and a human-readable message lets them branch on failures instead of guessing.","profiles":["api_tool_readiness","agentic_commerce"],"score_role":"core","ar_strengths":{"AR-ACT-02":"SHOULD"},"ar_practice_ids":["AR-ACT-02"],"legacy_id":"4.22","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.api-errors","strength_source":"isagentready_policy","i18n":{"nl":{"name":"API-foutresponses","steps":["Geef application/problem+json terug voor elke 4xx- en 5xx-response van de API."],"why":"Agents roepen API's programmatisch aan en kunnen niet herstellen van een HTML-foutpagina. Een JSON problem-details-body met een code en een bericht laat ze op fouten reageren.","verify_expect":"exitcode 0","fix_summary":"Geef RFC 9457 problem details als JSON terug bij API-fouten."}},"maturity":"recommended","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api"]},"strength":"SHOULD","ar_mapping":"partial","evidence_type":"recommendation"},{"id":"ia.api-rate-limits","name":"API rate-limit headers","verify":{"command":"curl -sI https://{domain}/api/","rescan":"isagentready results {domain} --checkpoint ia.api-rate-limits","expect":"RateLimit or RateLimit-Policy headers"},"fix":{"steps":[{"action":"Add the IETF RateLimit and RateLimit-Policy headers to API responses.","order":1,"language":"text","code_example":"RateLimit-Policy: \"hourly\";q=100;w=3600\nRateLimit: \"hourly\";r=42;t=1800"},{"action":"Add Retry-After to each 429 response.","order":2,"language":null,"code_example":null}],"summary":"Send RateLimit and RateLimit-Policy headers on API responses.","skill":{"name":"agent-protocols","anchor":"ia.api-rate-limits"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"Active Internet-Draft: RateLimit header fields for HTTP","kind":"spec","url":"https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/"},{"title":"RFC 9651: Structured Field Values for HTTP","kind":"spec","url":"https://www.rfc-editor.org/rfc/rfc9651"},{"title":"RFC 6585 section 4: 429 Too Many Requests","kind":"spec","url":"https://www.rfc-editor.org/rfc/rfc6585#section-4"}],"stage":"act","lifecycle":{"introduced":"2026-08-25","revised":["2026-09-02","2026-10-30"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-ACT-02","url":"https://www.agentready.org/#act"},"why":"Rate-limit headers let agents pace themselves before they hit a 429, and document the quota alongside the API instead of in prose only.","profiles":["api_tool_readiness"],"score_role":"bonus","ar_strengths":{"AR-ACT-02":"SHOULD"},"ar_practice_ids":["AR-ACT-02"],"legacy_id":"4.23","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.api-rate-limits","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Rate-limit-headers van de API","steps":["Voeg de IETF-headers RateLimit en RateLimit-Policy toe aan API-responses.","Voeg Retry-After toe aan elke 429-response."],"why":"Rate-limit-headers laten agents hun tempo aanpassen voordat ze een 429 krijgen. Ze documenteren het quotum naast de API en niet alleen in tekst.","verify_expect":"Headers RateLimit of RateLimit-Policy","fix_summary":"Stuur RateLimit- en RateLimit-Policy-headers op API-responses."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api"]},"strength":"MAY","ar_mapping":"partial","evidence_type":"recommendation"},{"id":"ia.developer-docs-link","name":"Developer docs discoverability","verify":{"command":"curl -sI https://{domain}/docs","rescan":"isagentready results {domain} --checkpoint ia.developer-docs-link","expect":"HTTP 200 for the documentation root"},"fix":{"steps":[{"action":"Add a link to /docs or /developers in the main navigation or the footer.","order":1,"language":"html","code_example":"<a href=\"/docs\">Developer documentation</a>"},{"action":"Add a service-doc Link header that points to the same documentation.","order":2,"language":"text","code_example":"Link: </docs>; rel=\"service-doc\""}],"summary":"Link your developer documentation from the home page with a clear link text.","skill":{"name":"agent-protocols","anchor":"ia.developer-docs-link"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"RFC 8288 service-doc link relation","kind":"guide","url":"https://www.iana.org/assignments/link-relations/link-relations.xhtml"}],"stage":"find","lifecycle":{"introduced":"2026-08-25","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-FIND-02","url":"https://www.agentready.org/#reachable"},"why":"Agents and developers look for /docs, /developers or /api links on the home page to find how to integrate. An API that is only discoverable through well-known files is easy to miss.","profiles":["api_tool_readiness"],"score_role":"bonus","ar_strengths":{"AR-FIND-02":"SHOULD","AR-READ-04":"SHOULD"},"ar_practice_ids":["AR-FIND-02","AR-READ-04"],"legacy_id":"4.24","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.developer-docs-link","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Vindbaarheid van developerdocs","steps":["Voeg een link naar /docs of /developers toe aan de hoofdnavigatie of de footer.","Voeg een service-doc-Link-header toe die naar dezelfde documentatie verwijst."],"why":"Agents en developers zoeken op de homepage naar links zoals /docs, /developers of /api. Een API die alleen via well-known-bestanden vindbaar is, wordt snel gemist.","verify_expect":"HTTP 200 voor de startpagina van de documentatie","fix_summary":"Link je developerdocumentatie vanaf de homepage met een duidelijke linktekst."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api","mcp"]},"strength":"MAY","ar_mapping":"partial","evidence_type":"measured_study"},{"id":"ia.mcp-apps","name":"MCP Apps UI resources","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.mcp-apps","expect":null},"fix":{"steps":[{"action":"Add _meta.ui.resourceUri with a ui:// URI to each tool that has a view.","order":1,"language":"json","code_example":"{\"name\": \"show_chart\", \"_meta\": {\"ui\": {\"resourceUri\": \"ui://charts/view\"}}}"},{"action":"Answer resources/read for that URI with mimeType text/html;profile=mcp-app and the HTML in text.","order":2,"language":null,"code_example":null}],"summary":"Link each tool view to a ui:// resource and serve it with the MCP App media type.","skill":{"name":"agent-protocols","anchor":"ia.mcp-apps"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"MCP Apps extension (SEP-1865)","kind":"spec","url":"https://github.com/modelcontextprotocol/ext-apps"},{"title":"agentready.org AR-ACT-05","kind":"guide","url":"https://www.agentready.org/#act"}],"expected":"A tool with _meta.ui.resourceUri or a ui:// resource that reads as text/html;profile=mcp-app. The scanner sends one read-only JSON-RPC resources/read POST inside the verified 4.20 session. This is the only POST of the coverage checks.","stage":"act","lifecycle":{"introduced":"2026-10-22","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-ACT-05","url":"https://www.agentready.org/#act"},"why":"MCP Apps let an agent host show an interactive view of a tool result. The host can render the view only when the server links a ui:// resource and serves it as text/html;profile=mcp-app.","profiles":["api_tool_readiness"],"score_role":"bonus","ar_strengths":{"AR-ACT-05":"MAY"},"ar_practice_ids":["AR-ACT-05"],"legacy_id":"4.25","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.mcp-apps","strength_source":"agentready","i18n":{"nl":{"name":"MCP Apps UI-resources","steps":["Voeg _meta.ui.resourceUri met een ui://-URI toe aan elke tool met een weergave.","Beantwoord resources/read voor die URI met mimeType text/html;profile=mcp-app en de HTML in text."],"why":"Met MCP Apps kan een agent-host een interactieve weergave van een toolresultaat tonen. De host kan die weergave alleen renderen als de server een ui://-resource koppelt en die levert als text/html;profile=mcp-app.","verify_expect":null,"fix_summary":"Koppel elke toolweergave aan een ui://-resource en lever die met het MCP App-mediatype."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["mcp"]},"strength":"MAY","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.nlweb-ask","name":"NLWeb ask endpoint","verify":{"command":"curl -s 'https://{domain}/ask?query=what+does+this+site+offer&streaming=false' | jq -e '.results | length > 0'","rescan":"isagentready results {domain} --checkpoint ia.nlweb-ask","expect":"The HTTP answer contains schema.org results. Also verify the MCP handshake and read-only tools/list response includes the ask tool. Listing the tool does not prove equivalent answers or successful execution."},"fix":{"steps":[{"action":"Answer GET /ask?query=... with JSON that has a results array.","order":1,"language":"json","code_example":"{\"query_id\": \"q1\", \"results\": [{\"url\": \"https://example.com/shoe\", \"name\": \"Trail shoe\", \"schema_object\": {\"@type\": \"Product\", \"name\": \"Trail shoe\"}}]}"},{"action":"Give each result a schema.org object, and support streaming=false for a plain JSON answer.","order":2,"language":null,"code_example":null},{"action":"Expose the same ask tool through a discoverable MCP server. A read-only tools/list response must include the ask tool.","order":3,"language":null,"code_example":null}],"summary":"Serve NLWeb at /ask with schema.org results and expose the same ask tool over MCP.","skill":{"name":"agent-protocols","anchor":"ia.nlweb-ask"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"NLWeb","kind":"spec","url":"https://github.com/nlweb-ai/NLWeb"},{"title":"agentready.org AR-ACT-09","kind":"guide","url":"https://www.agentready.org/#act"}],"expected":"GET /ask?query=... returns schema.org results and a verified MCP session lists the same ask tool. Equivalent answer behavior remains unverified.","stage":"act","lifecycle":{"introduced":"2026-10-22","revised":["2026-10-30"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"experimental","evidence_source":{"title":"agentready.org AR-ACT-09","url":"https://www.agentready.org/#act"},"why":"NLWeb offers a site-specific answer interface through /ask and the same ask tool over MCP. This informational check observes the HTTP response and MCP tool listing; it does not execute the MCP tool or verify equivalent answers.","profiles":["ai_search_visibility","api_tool_readiness"],"score_role":"informational","ar_strengths":{"AR-ACT-09":"MAY"},"ar_practice_ids":["AR-ACT-09"],"legacy_id":"4.26","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.nlweb-ask","strength_source":"agentready","i18n":{"nl":{"name":"NLWeb ask-endpoint","steps":["Beantwoord GET /ask?query=... met JSON met een results-array.","Geef elk resultaat een schema.org-object, en ondersteun streaming=false voor een gewoon JSON-antwoord.","Bied dezelfde ask-tool aan via een vindbare MCP-server. Een tools/list-antwoord zonder schrijfacties moet de ask-tool bevatten."],"why":"NLWeb biedt een sitegebonden antwoordinterface via /ask en dezelfde ask-tool via MCP. Deze informatieve controle bekijkt het HTTP-antwoord en de MCP-toollijst; de MCP-tool wordt niet uitgevoerd en gelijke antwoorden worden niet geverifieerd.","verify_expect":"Het HTTP-antwoord bevat schema.org-resultaten. Controleer ook of de MCP-handshake slaagt en tools/list de ask-tool vermeldt. De toollijst bewijst geen gelijke antwoorden of geslaagde uitvoering.","fix_summary":"Lever NLWeb op /ask met schema.org-resultaten en bied dezelfde ask-tool via MCP aan."}},"maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MAY","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.agent-checkout","name":"Agent checkout","verify":{"command":"curl -s https://{domain}/.well-known/acp.json | grep -q checkout_sessions","rescan":"isagentready results {domain} --checkpoint ia.agent-checkout","expect":"exit code 0"},"fix":{"steps":[{"action":"Accept Stripe Link or Shared Payment Tokens on the checkout page.","order":1,"language":null,"code_example":null},{"action":"Declare the checkout_sessions endpoint in /.well-known/acp.json.","order":2,"language":"json","code_example":"{\"flows\": [\"checkout\"], \"capabilities\": {\"checkout\": {\"endpoint\": \"https://example.com/acp/checkout_sessions\"}}}"}],"summary":"Give agents a payment path at checkout.","skill":{"name":"agent-protocols","anchor":"ia.agent-checkout"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"agentready.org AR-ACT-08","kind":"study","url":"https://www.agentready.org/#act"},{"title":"Agentic Commerce Protocol","kind":"spec","url":"https://www.agenticcommerce.dev"},{"title":"Stripe agentic commerce","kind":"guide","url":"https://docs.stripe.com/agentic-commerce"}],"expected":"A Stripe Link or Shared Payment Token marker at checkout, or checkout_sessions in /.well-known/acp.json","stage":"act","lifecycle":{"introduced":"2026-10-22","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"experimental","evidence_source":{"title":"agentready.org AR-ACT-08","url":"https://www.agentready.org/#act"},"why":"Agents finish a purchase only when the checkout accepts an agent payment path. In the agentready.org study, agents completed Link checkouts correctly in most cases. The check looks for Stripe Link, Shared Payment Tokens or an ACP checkout_sessions endpoint, and never sends a POST.","profiles":["agentic_commerce"],"score_role":"informational","ar_strengths":{"AR-ACT-08":"MAY"},"ar_practice_ids":["AR-ACT-08"],"legacy_id":"4.27","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.agent-checkout","strength_source":"agentready","i18n":{"nl":{"name":"Agent-checkout","steps":["Accepteer Stripe Link of Shared Payment Tokens op de checkoutpagina.","Declareer het checkout_sessions-endpoint in /.well-known/acp.json."],"why":"Agents ronden een aankoop alleen af als de checkout een betaalpad voor agents accepteert. In het onderzoek van agentready.org rondden agents Link-checkouts meestal juist af. De check zoekt Stripe Link, Shared Payment Tokens of een ACP-checkout_sessions-endpoint en stuurt nooit een POST.","verify_expect":"exitcode 0","fix_summary":"Geef agents een betaalpad bij de checkout."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["commerce"]},"strength":"MAY","ar_mapping":"full","evidence_type":"measured_study"},{"id":"ia.sdk-cli","name":"SDKs and CLI","verify":{"command":"curl -sf https://{domain}/llms.txt","rescan":"isagentready results {domain} --checkpoint ia.sdk-cli","expect":"Follow both documentation links. Check that the SDK has a labeled registry link and the CLI has its own installation command. This does not verify installation or task execution."},"fix":{"steps":[{"action":"Publish an SDK in a package registry and label its registry link as an SDK in your docs.","order":1,"language":null,"code_example":null},{"action":"Document the CLI separately, including its installation command and a first-call example.","order":2,"language":null,"code_example":null},{"action":"Link both the SDK and CLI documentation from llms.txt.","order":3,"language":"markdown","code_example":"## Tools\n- [SDK](https://www.npmjs.com/package/@example/sdk): SDK package and usage examples\n- [CLI](https://example.com/docs/cli): `npm install -g @example/cli`, then `example --help`"}],"summary":"Publish an SDK and a CLI, with separate installation and first-call examples.","skill":{"name":"agent-protocols","anchor":"ia.sdk-cli"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"agentready.org AR-ACT-06","kind":"guide","url":"https://www.agentready.org/#act"}],"expected":"An SDK-labeled package registry link and separately documented CLI installation instructions. Installation and task execution remain unverified.","stage":"act","lifecycle":{"introduced":"2026-10-22","revised":["2026-10-30"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-ACT-06","url":"https://www.agentready.org/#act"},"why":"SDK links and CLI installation examples help agents find an interface. An SDK reference does not prove a CLI, and source hints do not verify installation or task execution.","profiles":["api_tool_readiness"],"score_role":"bonus","ar_strengths":{"AR-ACT-06":"SHOULD"},"ar_practice_ids":["AR-ACT-06"],"legacy_id":"4.28","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.sdk-cli","strength_source":"agentready","i18n":{"nl":{"name":"SDK's en CLI","steps":["Publiceer een SDK in een package-registry en benoem de registry-link als SDK in je documentatie.","Documenteer de CLI afzonderlijk, met het installatiecommando en een eerste gebruiksvoorbeeld.","Link naar de documentatie van zowel de SDK als de CLI vanuit llms.txt."],"why":"SDK-links en CLI-installatievoorbeelden helpen agents een interface te vinden. Een SDK-verwijzing bewijst geen CLI en bronsignalen verifiëren geen installatie of taakuitvoering.","verify_expect":"Volg beide documentatielinks. Controleer of de SDK een benoemde registry-link heeft en de CLI een eigen installatiecommando. Dit verifieert geen installatie of taakuitvoering.","fix_summary":"Publiceer een SDK en een CLI, elk met installatie-instructies en een eerste gebruiksvoorbeeld."}},"maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.agent-task-access","name":"Agent task access","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.agent-task-access","expect":null},"fix":{"steps":[{"action":"Serve a public MCP server that answers initialize and tools/list, or the stateless server/discover.","order":1,"language":null,"code_example":null},{"action":"Or publish a CLI and show its install command in your docs.","order":2,"language":null,"code_example":null}],"summary":"Give agents an MCP server or a CLI for the tasks on your site.","skill":{"name":"agent-protocols","anchor":"ia.agent-task-access"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"agentready.org AR-ACT-10","kind":"guide","url":"https://www.agentready.org/#act"}],"expected":"A verified MCP server (4.20) or a CLI (4.28) on a site with an API, MCP, commerce or auth surface","stage":"act","lifecycle":{"introduced":"2026-10-22","revised":["2026-10-30"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-ACT-10","url":"https://www.agentready.org/#act"},"why":"AgentReady requires an MCP server or CLI when agents are expected to act on a product. This bonus checkpoint records interface evidence independently of grade; product intent and successful tasks remain unverified.","profiles":["api_tool_readiness","agentic_commerce"],"score_role":"bonus","ar_strengths":{"AR-ACT-10":"MUST"},"ar_practice_ids":["AR-ACT-10"],"legacy_id":"4.29","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.agent-task-access","strength_source":"agentready","i18n":{"nl":{"name":"Taaktoegang voor agents","steps":["Lever een publieke MCP-server die antwoordt op initialize en tools/list, of op de stateless server/discover.","Of publiceer een CLI en toon het installatiecommando in je docs."],"why":"AgentReady vereist een MCP-server of CLI wanneer agents taken op een product moeten uitvoeren. Dit bonuscheckpoint legt interfacebewijs vast, onafhankelijk van de grade; productbedoeling en succesvolle taken blijven ongeverifieerd.","verify_expect":null,"fix_summary":"Geef agents een MCP-server of een CLI voor de taken op je site."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api","mcp","commerce","auth"]},"strength":"MUST","ar_mapping":"full","evidence_type":"recommendation"},{"id":"ia.docs-answer","name":"Docs pages that answer","verify":{"command":"curl -sL https://{domain}/docs | grep -c 'class=\"language-'","rescan":"isagentready results {domain} --checkpoint ia.docs-answer","expect":"a count above 0"},"fix":{"steps":[{"action":"Render the docs text in the server HTML, with at least a few paragraphs per page.","order":1,"language":null,"code_example":null},{"action":"Give each page an h1 and h2 or h3 headings.","order":2,"language":null,"code_example":null},{"action":"Tag each code block with its language.","order":3,"language":"html","code_example":"<pre><code class=\"language-bash\">curl https://api.example.com/v1/items</code></pre>"}],"summary":"Render docs pages on the server with headings and language-tagged code.","skill":{"name":"agent-protocols","anchor":"ia.docs-answer"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"agentready.org AR-READ-04","kind":"study","url":"https://www.agentready.org/#read"},{"title":"agentready.org AR-READ-05","kind":"study","url":"https://www.agentready.org/#read"}],"expected":"Docs pages with HTTP 200, server-rendered text, a heading structure and language-tagged code blocks","stage":"read","lifecycle":{"introduced":"2026-10-22","revised":["2026-10-30"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-READ-04","url":"https://www.agentready.org/#read"},"why":"Server-rendered docs, headings and tagged code help agents retrieve information. These structural checks do not establish that the page answers a user task accurately or completely.","profiles":["api_tool_readiness"],"score_role":"bonus","ar_strengths":{"AR-FIND-02":"SHOULD","AR-READ-04":"SHOULD","AR-READ-05":"SHOULD"},"ar_practice_ids":["AR-READ-04","AR-FIND-02","AR-READ-05"],"legacy_id":"4.30","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.docs-answer","strength_source":"agentready","i18n":{"nl":{"name":"Docspagina's die antwoord geven","steps":["Render de docstekst in de server-HTML, met minstens een paar alinea's per pagina.","Geef elke pagina een h1 en h2- of h3-koppen.","Tag elk codeblok met de taal."],"why":"Server-gerenderde docs, koppen en code met taaltags helpen agents informatie te vinden. Deze structuurchecks bewijzen niet dat de pagina een gebruikerstaak juist of volledig beantwoordt.","verify_expect":"een aantal boven 0","fix_summary":"Render docspagina's op de server met koppen en code met een taaltag."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["website"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"measured_study"},{"id":"ia.https","name":"HTTPS","verify":{"command":"curl -sI https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.https","expect":"A response without a TLS error"},"fix":{"steps":[{"action":"Install a valid TLS certificate, for example from Let's Encrypt.","order":1,"language":null,"code_example":null},{"action":"Redirect all HTTP requests to HTTPS with a 301.","order":2,"language":"nginx","code_example":"server {\n  listen 80;\n  return 301 https://$host$request_uri;\n}"}],"summary":"Serve the site over HTTPS with a valid certificate and redirect HTTP to HTTPS.","skill":{"name":"security-trust","anchor":"ia.https"}},"category":"security","aggregate":null,"references":[{"title":"Let's Encrypt","kind":"guide","url":"https://letsencrypt.org/"},{"title":"Why HTTPS Matters","kind":"guide","url":"https://web.dev/articles/why-https-matters"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"Let's Encrypt","url":"https://letsencrypt.org/"},"why":"HTTPS is the baseline for secure communication. AI agents and crawlers refuse to interact with insecure sites, and browsers mark HTTP sites as unsafe.","profiles":["browser_agent_usability","api_tool_readiness","agentic_commerce"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"5.1","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.https","strength_source":"isagentready_policy","i18n":{"nl":{"name":"HTTPS","steps":["Installeer een geldig TLS-certificaat, bijvoorbeeld van Let's Encrypt.","Stuur alle HTTP-requests met een 301 door naar HTTPS."],"why":"HTTPS is de basis voor veilige communicatie. AI-agents en crawlers mijden onveilige sites, en browsers markeren HTTP-sites als onveilig.","verify_expect":"Een antwoord zonder TLS-fout","fix_summary":"Lever de site via HTTPS met een geldig certificaat en stuur HTTP door naar HTTPS."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.hsts","name":"HSTS","verify":{"command":"curl -sI https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.hsts","expect":"A Strict-Transport-Security header with max-age=31536000 or higher"},"fix":{"steps":[{"action":"Add the Strict-Transport-Security header to all HTTPS responses.","order":1,"language":"nginx","code_example":"add_header Strict-Transport-Security \"max-age=31536000; includeSubDomains\" always;"}],"summary":"Send Strict-Transport-Security with a max-age of at least one year.","skill":{"name":"security-trust","anchor":"ia.hsts"}},"category":"security","aggregate":null,"references":[{"title":"MDN: Strict-Transport-Security","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security"},{"title":"HSTS Preload List","kind":"guide","url":"https://hstspreload.org/"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"MDN: Strict-Transport-Security","url":"https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security"},"why":"HSTS prevents protocol downgrade attacks by telling browsers to always use HTTPS. AI agents that follow redirects benefit from HSTS as it eliminates insecure initial connections.","profiles":["browser_agent_usability","api_tool_readiness","agentic_commerce"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"5.3","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.hsts","strength_source":"isagentready_policy","i18n":{"nl":{"name":"HSTS","steps":["Voeg de Strict-Transport-Security-header toe aan alle HTTPS-responses."],"why":"HSTS voorkomt downgrade-aanvallen door browsers te vertellen altijd HTTPS te gebruiken. AI-agents die redirects volgen, hebben er baat bij omdat de eerste onveilige verbinding verdwijnt.","verify_expect":"Een Strict-Transport-Security-header met max-age=31536000 of hoger","fix_summary":"Stuur Strict-Transport-Security met een max-age van minimaal een jaar."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.csp","name":"Content-Security-Policy","verify":{"command":"curl -sI https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.csp","expect":"A Content-Security-Policy header"},"fix":{"steps":[{"action":"Start with a report-only policy and collect the violations.","order":1,"language":null,"code_example":null},{"action":"Send the enforced policy when the violations are fixed.","order":2,"language":"nginx","code_example":"add_header Content-Security-Policy \"default-src 'self'; script-src 'self'\" always;"}],"summary":"Send a Content-Security-Policy header with default-src and script-src.","skill":{"name":"security-trust","anchor":"ia.csp"}},"category":"security","aggregate":null,"references":[{"title":"MDN: Content Security Policy","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP"},{"title":"OWASP CSP Cheat Sheet","kind":"guide","url":"https://cheatsheetseries.owasp.org/cheatsheets/Content_Security_Policy_Cheat_Sheet.html"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"MDN: Content Security Policy","url":"https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP"},"why":"Content-Security-Policy prevents XSS and injection attacks. For AI agents that interact with your site, CSP ensures the page content hasn't been tampered with by malicious scripts.","profiles":["browser_agent_usability","api_tool_readiness","agentic_commerce"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"5.4","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.csp","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Content-Security-Policy","steps":["Begin met een report-only-policy en verzamel de overtredingen.","Stuur de afgedwongen policy als de overtredingen zijn opgelost."],"why":"Content-Security-Policy voorkomt XSS- en injectie-aanvallen. Voor AI-agents zorgt CSP dat kwaadaardige scripts de pagina niet hebben aangepast.","verify_expect":"Een Content-Security-Policy-header","fix_summary":"Stuur een Content-Security-Policy-header met default-src en script-src."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.x-content-type-options","name":"X-Content-Type-Options","verify":{"command":"curl -sI https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.x-content-type-options","expect":"X-Content-Type-Options: nosniff"},"fix":{"steps":[{"action":"Add the header to all responses.","order":1,"language":"nginx","code_example":"add_header X-Content-Type-Options \"nosniff\" always;"}],"summary":"Send X-Content-Type-Options: nosniff.","skill":{"name":"security-trust","anchor":"ia.x-content-type-options"}},"category":"security","aggregate":null,"references":[{"title":"MDN: X-Content-Type-Options","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Content-Type-Options"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"MDN: X-Content-Type-Options","url":"https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Content-Type-Options"},"why":"This header prevents MIME type sniffing attacks. It ensures browsers and HTTP clients interpret your content exactly as intended, reducing the risk of content injection.","profiles":["browser_agent_usability","api_tool_readiness","agentic_commerce"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"5.5","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.x-content-type-options","strength_source":"isagentready_policy","i18n":{"nl":{"name":"X-Content-Type-Options","steps":["Voeg de header toe aan alle responses."],"why":"Deze header voorkomt MIME-sniffing. Browsers en HTTP-clients interpreteren je content precies zoals bedoeld.","verify_expect":"X-Content-Type-Options: nosniff","fix_summary":"Stuur X-Content-Type-Options: nosniff."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.frame-protection","name":"X-Frame-Options / frame-ancestors","verify":{"command":"curl -sI https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.frame-protection","expect":"X-Frame-Options or a Content-Security-Policy with frame-ancestors"},"fix":{"steps":[{"action":"Add frame-ancestors to the Content-Security-Policy, or send X-Frame-Options.","order":1,"language":"nginx","code_example":"add_header Content-Security-Policy \"frame-ancestors 'self'\" always;"}],"summary":"Send X-Frame-Options or a CSP frame-ancestors directive.","skill":{"name":"security-trust","anchor":"ia.frame-protection"}},"category":"security","aggregate":null,"references":[{"title":"MDN: X-Frame-Options","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options"},{"title":"MDN: Content Security Policy","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"MDN: X-Frame-Options","url":"https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options"},"why":"Frame protection prevents your site from being embedded in malicious iframes (clickjacking). This protects users who interact with your site through AI-suggested links.","profiles":["browser_agent_usability","api_tool_readiness","agentic_commerce"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"5.6","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.frame-protection","strength_source":"isagentready_policy","i18n":{"nl":{"name":"X-Frame-Options / frame-ancestors","steps":["Voeg frame-ancestors toe aan de Content-Security-Policy, of stuur X-Frame-Options."],"why":"Frame-bescherming voorkomt dat je site in kwaadaardige iframes wordt geladen (clickjacking). Dit beschermt gebruikers die via AI-links op je site komen.","verify_expect":"X-Frame-Options of een Content-Security-Policy met frame-ancestors","fix_summary":"Stuur X-Frame-Options of een CSP-frame-ancestors-richtlijn."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.cors","name":"CORS","verify":{"command":"curl -sI -H 'Origin: https://example.org' https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.cors","expect":"No Access-Control-Allow-Origin: * together with Access-Control-Allow-Credentials: true"},"fix":{"steps":[{"action":"Allow only the origins that need browser access to the API.","order":1,"language":"nginx","code_example":"add_header Access-Control-Allow-Origin \"https://app.example.com\" always;"},{"action":"Do not send Access-Control-Allow-Credentials: true with a * origin.","order":2,"language":null,"code_example":null}],"summary":"Send a deliberate Access-Control-Allow-Origin on API responses and never combine * with credentials.","skill":{"name":"security-trust","anchor":"ia.cors"}},"category":"security","aggregate":null,"references":[{"title":"MDN: CORS","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CORS"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"MDN: CORS","url":"https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CORS"},"why":"CORS controls which origins can call your site from a browser. Public APIs need a deliberate CORS policy. A wildcard with credentials is not safe.","profiles":["api_tool_readiness"],"score_role":"bonus","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"5.7","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.cors","strength_source":"isagentready_policy","i18n":{"nl":{"name":"CORS","steps":["Sta alleen de origins toe die browsertoegang tot de API nodig hebben.","Stuur geen Access-Control-Allow-Credentials: true met een *-origin."],"why":"CORS bepaalt welke origins je site vanuit een browser mogen aanroepen. Publieke API's hebben een bewust CORS-beleid nodig. Een wildcard met credentials is niet veilig.","verify_expect":"Geen Access-Control-Allow-Origin: * samen met Access-Control-Allow-Credentials: true","fix_summary":"Stuur een bewuste Access-Control-Allow-Origin op API-responses en combineer * nooit met credentials."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api"]},"strength":"MAY","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.referrer-policy","name":"Referrer-Policy","verify":{"command":"curl -sI https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.referrer-policy","expect":"A Referrer-Policy header"},"fix":{"steps":[{"action":"Add the header to all responses.","order":1,"language":"nginx","code_example":"add_header Referrer-Policy \"strict-origin-when-cross-origin\" always;"}],"summary":"Send Referrer-Policy: strict-origin-when-cross-origin or stricter.","skill":{"name":"security-trust","anchor":"ia.referrer-policy"}},"category":"security","aggregate":null,"references":[{"title":"MDN: Referrer-Policy","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referrer-Policy"}],"stage":"read","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"MDN: Referrer-Policy","url":"https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referrer-Policy"},"why":"Referrer-Policy controls what URL information is shared when users navigate away from your site. A strict policy protects user privacy and prevents leaking sensitive URL parameters.","profiles":["browser_agent_usability","api_tool_readiness","agentic_commerce"],"score_role":"core","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"5.9","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.referrer-policy","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Referrer-Policy","steps":["Voeg de header toe aan alle responses."],"why":"Referrer-Policy bepaalt welke URL-informatie wordt gedeeld als gebruikers je site verlaten. Een strikte policy beschermt privacy en lekt geen gevoelige URL-parameters.","verify_expect":"Een Referrer-Policy-header","fix_summary":"Stuur Referrer-Policy: strict-origin-when-cross-origin of strikter."}},"maturity":"essential","applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":"MUST","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.tool-definition-security","name":"Tool definition security","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.tool-definition-security","expect":null},"fix":{"steps":[{"action":"Add readOnlyHint and untrustedContentHint annotations to each tool.","order":1,"language":"javascript","code_example":"annotations: { readOnlyHint: true, untrustedContentHint: true }"},{"action":"Remove tokens, internal URLs and personal data from tool names and descriptions.","order":2,"language":null,"code_example":null},{"action":"Pass an AbortSignal so that the page can unregister tools.","order":3,"language":null,"code_example":null}],"summary":"Add trust annotations to WebMCP tools and keep secrets out of tool definitions.","skill":{"name":"security-trust","anchor":"ia.tool-definition-security"}},"category":"security","aggregate":null,"references":[{"title":"WebMCP W3C Proposal","kind":"guide","url":"https://webmachinelearning.github.io/webmcp/"},{"title":"OWASP Sensitive Data Exposure","kind":"guide","url":"https://owasp.org/www-project-web-security-testing-guide/"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"experimental","evidence_source":{"title":"WebMCP W3C Proposal","url":"https://webmachinelearning.github.io/webmcp/"},"why":"Tool definitions are visible to AI agents and may be cached or logged. Explicit trust metadata, bounded origin exposure, and lifecycle cancellation help agents invoke tools safely.","profiles":["api_tool_readiness","agentic_commerce"],"score_role":"informational","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"5.10","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.tool-definition-security","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Veiligheid van tooldefinities","steps":["Voeg de annotaties readOnlyHint en untrustedContentHint toe aan elke tool.","Verwijder tokens, interne URL's en persoonsgegevens uit toolnamen en beschrijvingen.","Geef een AbortSignal mee, zodat de pagina tools kan afmelden."],"why":"Tooldefinities zijn zichtbaar voor AI-agents en kunnen worden opgeslagen of gelogd. Expliciete vertrouwensmetadata, beperkte origin-blootstelling en annulering helpen agents om tools veilig te gebruiken.","verify_expect":null,"fix_summary":"Voeg vertrouwensannotaties toe aan WebMCP-tools en houd geheimen uit tooldefinities."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["auth"]},"strength":"MAY","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.auto-submit-risk","name":"Auto-submit risk","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.auto-submit-risk","expect":null},"fix":{"steps":[{"action":"Find forms with toolautosubmit and a password, payment or delete action.","order":1,"language":null,"code_example":null},{"action":"Remove toolautosubmit from these forms so that the user confirms each submit.","order":2,"language":null,"code_example":null}],"summary":"Remove toolautosubmit from forms with sensitive data.","skill":{"name":"security-trust","anchor":"ia.auto-submit-risk"}},"category":"security","aggregate":null,"references":[{"title":"WebMCP W3C Proposal","kind":"guide","url":"https://webmachinelearning.github.io/webmcp/"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"experimental","evidence_source":{"title":"WebMCP W3C Proposal","url":"https://webmachinelearning.github.io/webmcp/"},"why":"The toolautosubmit attribute allows AI agents to submit forms without user confirmation. This is safe for search/filter forms but risky for payment, account deletion, or password forms.","profiles":["browser_agent_usability","agentic_commerce"],"score_role":"informational","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"5.11","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.auto-submit-risk","strength_source":"isagentready_policy","i18n":{"nl":{"name":"Risico van automatisch verzenden","steps":["Zoek formulieren met toolautosubmit en een wachtwoord-, betaal- of verwijderactie.","Verwijder toolautosubmit van deze formulieren, zodat de gebruiker elke verzending bevestigt."],"why":"Het toolautosubmit-attribuut laat AI-agents formulieren verzenden zonder bevestiging. Dat is veilig voor zoek- en filterformulieren, maar riskant voor betalingen, accountverwijdering of wachtwoorden.","verify_expect":null,"fix_summary":"Verwijder toolautosubmit van formulieren met gevoelige data."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["auth"]},"strength":"MAY","ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.oauth-discovery","name":"OAuth discovery","verify":{"command":"curl -sf https://{domain}/.well-known/oauth-authorization-server | jq -e '.issuer and .token_endpoint'","rescan":"isagentready results {domain} --checkpoint ia.oauth-discovery","expect":"exit code 0"},"fix":{"steps":[{"action":"Serve the RFC 8414 metadata with issuer, authorization_endpoint and token_endpoint.","order":1,"language":"json","code_example":"{\n  \"issuer\": \"https://example.com\",\n  \"authorization_endpoint\": \"https://example.com/oauth/authorize\",\n  \"token_endpoint\": \"https://example.com/oauth/token\",\n  \"code_challenge_methods_supported\": [\"S256\"]\n}"}],"summary":"Publish OAuth authorization server metadata at /.well-known/oauth-authorization-server.","skill":{"name":"security-trust","anchor":"ia.oauth-discovery"}},"category":"security","aggregate":null,"references":[{"title":"RFC 8414: OAuth 2.0 Authorization Server Metadata","kind":"spec","url":"https://datatracker.ietf.org/doc/html/rfc8414"},{"title":"OpenID Connect Discovery 1.0","kind":"spec","url":"https://openid.net/specs/openid-connect-discovery-1_0.html"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-ACT-01","url":"https://www.agentready.org/#act"},"why":"OAuth and OIDC discovery (RFC 8414, OpenID Connect Discovery 1.0) let agents authenticate with your APIs without manual setup.","profiles":["api_tool_readiness","agentic_commerce"],"score_role":"core","ar_strengths":{"AR-ACT-01":"SHOULD"},"ar_practice_ids":["AR-ACT-01"],"legacy_id":"5.12","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.oauth-discovery","strength_source":"agentready","i18n":{"nl":{"name":"OAuth-discovery","steps":["Lever de RFC 8414-metadata met issuer, authorization_endpoint en token_endpoint."],"why":"OAuth- en OIDC-discovery (RFC 8414, OpenID Connect Discovery 1.0) laten agents bij je API's authenticeren zonder handmatige setup.","verify_expect":"exitcode 0","fix_summary":"Publiceer OAuth-metadata van de autorisatieserver op /.well-known/oauth-authorization-server."}},"maturity":"recommended","applicability":{"mode":"detected_surface","condition":null,"surfaces":["auth"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"scanner_data"},{"id":"ia.oauth-protected-resource","name":"OAuth protected resource","verify":{"command":"curl -sf https://{domain}/.well-known/oauth-protected-resource | jq -e '.resource and .authorization_servers'","rescan":"isagentready results {domain} --checkpoint ia.oauth-protected-resource","expect":"exit code 0"},"fix":{"steps":[{"action":"Serve the RFC 9728 metadata.","order":1,"language":"json","code_example":"{\n  \"resource\": \"https://api.example.com\",\n  \"authorization_servers\": [\"https://example.com\"],\n  \"bearer_methods_supported\": [\"header\"]\n}"},{"action":"Return WWW-Authenticate with resource_metadata on 401 responses.","order":2,"language":null,"code_example":null}],"summary":"Publish /.well-known/oauth-protected-resource with the resource and its authorization servers.","skill":{"name":"security-trust","anchor":"ia.oauth-protected-resource"}},"category":"security","aggregate":null,"references":[{"title":"RFC 9728: OAuth 2.0 Protected Resource Metadata","kind":"spec","url":"https://datatracker.ietf.org/doc/html/rfc9728"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-ACT-01","url":"https://www.agentready.org/#act"},"why":"OAuth Protected Resource Metadata (RFC 9728) tells agents which authorization servers issue tokens for your APIs.","profiles":["api_tool_readiness","agentic_commerce"],"score_role":"bonus","ar_strengths":{"AR-ACT-01":"SHOULD"},"ar_practice_ids":["AR-ACT-01"],"legacy_id":"5.13","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.oauth-protected-resource","strength_source":"agentready","i18n":{"nl":{"name":"OAuth protected resource","steps":["Lever de RFC 9728-metadata.","Geef WWW-Authenticate met resource_metadata terug op 401-responses."],"why":"OAuth Protected Resource Metadata (RFC 9728) vertelt agents welke autorisatieservers tokens voor je API's uitgeven.","verify_expect":"exitcode 0","fix_summary":"Publiceer /.well-known/oauth-protected-resource met de resource en de autorisatieservers."}},"maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["auth"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"scanner_data"},{"id":"ia.agent-auth-readiness","name":"Agent auth readiness","verify":{"command":"curl -sf https://{domain}/auth.md","rescan":"isagentready results {domain} --checkpoint ia.agent-auth-readiness","expect":"The documentation explains self-serve API-key creation and named scopes, or an OAuth flow with discoverable metadata, PKCE S256 and scopes. This check does not attempt authentication."},"fix":{"steps":[{"action":"For API keys, explain where to create a key without manual approval and name the available scopes. For OAuth, publish the authorization server and protected resource metadata.","order":1,"language":null,"code_example":null},{"action":"Explain what each scope permits. For OAuth, list scopes_supported and include S256 in code_challenge_methods_supported.","order":2,"language":null,"code_example":null},{"action":"Publish /auth.md with the credential setup, narrowest usable scope and an authenticated request example for the supported flow.","order":3,"language":"markdown","code_example":"# Authentication for agents\n\nCreate an API key in the [dashboard](https://example.com/settings/api-keys) without manual approval.\n\n## Scopes\n- `catalog:read`: Read the catalog. Select this scope for catalog queries.\n\nSend the key in the Authorization header as a bearer token.\n\nExample: `curl -H \"Authorization: Bearer $API_KEY\" https://example.com/api/catalog`"}],"summary":"Document a scoped API-key flow or an OAuth flow with discovery metadata and PKCE S256.","skill":{"name":"security-trust","anchor":"ia.agent-auth-readiness"}},"category":"security","aggregate":null,"references":[{"title":"RFC 8414: OAuth 2.0 Authorization Server Metadata","kind":"spec","url":"https://datatracker.ietf.org/doc/html/rfc8414"},{"title":"RFC 9728: OAuth 2.0 Protected Resource Metadata","kind":"spec","url":"https://datatracker.ietf.org/doc/html/rfc9728"},{"title":"RFC 7636: PKCE","kind":"spec","url":"https://datatracker.ietf.org/doc/html/rfc7636"}],"expected":"A documented self-serve API-key flow with named scopes, or discoverable OAuth metadata with PKCE S256, scopes and an authentication walkthrough.","stage":"act","lifecycle":{"introduced":"2026-08-24","revised":["2026-10-30"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":"standard","evidence_source":{"title":"agentready.org AR-ACT-01","url":"https://www.agentready.org/#act"},"why":"Agents need a documented way to obtain credentials with permissions suited to the task. Self-serve scoped API keys or delegated OAuth with discovery metadata and PKCE can provide that path. Documentation does not verify that authentication succeeds.","profiles":["api_tool_readiness","agentic_commerce"],"score_role":"core","ar_strengths":{"AR-ACT-01":"SHOULD"},"ar_practice_ids":["AR-ACT-01"],"legacy_id":"5.14","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.agent-auth-readiness","strength_source":"agentready","i18n":{"nl":{"name":"Auth-gereedheid voor agents","steps":["Leg bij API-sleutels uit waar je zonder handmatige goedkeuring een sleutel aanmaakt en benoem de beschikbare scopes. Publiceer bij OAuth de metadata van de autorisatieserver en de beschermde resource.","Leg uit wat elke scope toestaat. Vermeld bij OAuth scopes_supported en voeg S256 toe aan code_challenge_methods_supported.","Publiceer /auth.md met het instellen van inloggegevens, de minimaal benodigde scope en een voorbeeld van een geauthenticeerd verzoek voor de ondersteunde flow."],"why":"Agents hebben een gedocumenteerde manier nodig om inloggegevens te verkrijgen met machtigingen die passen bij de taak. Dat kan met zelf aan te maken API-sleutels met scopes, of met gedelegeerde OAuth met vindbare metadata en PKCE. Documentatie bewijst niet dat authenticatie slaagt.","verify_expect":"De documentatie beschrijft het zelf aanmaken van API-sleutels met benoemde scopes, of een OAuth-flow met vindbare metadata, PKCE S256 en scopes. Deze controle probeert geen authenticatie.","fix_summary":"Documenteer een API-sleutelflow met scopes of een OAuth-flow met vindbare metadata en PKCE S256."}},"maturity":"recommended","applicability":{"mode":"detected_surface","condition":null,"surfaces":["auth"]},"strength":"SHOULD","ar_mapping":"full","evidence_type":"scanner_data"},{"id":"ia.common-crawl-presence","name":"Common Crawl presence","verify":{"command":"curl -sf 'https://index.commoncrawl.org/collinfo.json' | jq -r '.[0].id'","rescan":"isagentready results {domain} --checkpoint ia.common-crawl-presence","expect":"The latest index id. Query that index for url={domain} to see the presence."},"fix":{"steps":[{"action":"Decide if the content of the site may appear in public training archives.","order":1,"language":null,"code_example":null},{"action":"To opt out, add a Disallow rule for CCBot to robots.txt.","order":2,"language":"text","code_example":"User-agent: CCBot\nDisallow: /"}],"summary":"Decide if you want your content in public training archives, then set CCBot rules in robots.txt.","skill":{"name":"ai-content-discovery","anchor":"ia.common-crawl-presence"}},"category":"training_exposure","aggregate":null,"references":[{"title":"Common Crawl","kind":"guide","url":"https://commoncrawl.org/"}],"stage":"find","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":null,"evidence_source":{"title":"IsAgentReady benchmark","url":"https://isagentready.com/en/research/state-of-agent-ready-web"},"why":"Common Crawl is a public web archive that many AI training sets use. This check reports if the domain is in the latest index. It is information only and does not change the score.","profiles":[],"score_role":"informational","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"te.1","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.common-crawl-presence","strength_source":null,"i18n":{"nl":{"name":"Aanwezigheid in Common Crawl","steps":["Bepaal of de content van de site in publieke trainingsarchieven mag staan.","Voeg voor een opt-out een Disallow-regel voor CCBot toe aan robots.txt."],"why":"Common Crawl is een publiek webarchief dat veel AI-trainingssets gebruiken. Deze check meldt of het domein in de laatste index staat. Het is alleen informatie en verandert de score niet.","verify_expect":"De id van de nieuwste index. Zoek in die index naar url={domain} om de aanwezigheid te zien.","fix_summary":"Bepaal of je content in publieke trainingsarchieven wilt, en zet daarna CCBot-regels in robots.txt."}},"maturity":null,"applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":null,"ar_mapping":"none","evidence_type":"scanner_data"},{"id":"ia.training-crawler-blocking","name":"Training crawler blocking","verify":{"command":"curl -sf https://{domain}/robots.txt","rescan":"isagentready results {domain} --checkpoint ia.training-crawler-blocking","expect":"User-agent groups for the training crawlers that match your policy"},"fix":{"steps":[{"action":"List the training crawlers that you want to allow or block, for example GPTBot, CCBot and Google-Extended.","order":1,"language":null,"code_example":null},{"action":"Add a User-agent group for each crawler with Allow or Disallow.","order":2,"language":"text","code_example":"User-agent: Google-Extended\nDisallow: /\n\nUser-agent: GPTBot\nAllow: /"},{"action":"Keep search and user-triggered agents allowed, for example OAI-SearchBot and Claude-User.","order":3,"language":null,"code_example":null}],"summary":"Set explicit rules for training crawlers that match your policy.","skill":{"name":"ai-content-discovery","anchor":"ia.training-crawler-blocking"}},"category":"training_exposure","aggregate":null,"references":[{"title":"RFC 9309 - Robots Exclusion Protocol","kind":"spec","url":"https://www.rfc-editor.org/rfc/rfc9309"}],"stage":"find","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":null,"evidence_source":{"title":"agentready.org AR-FIND-01","url":"https://www.agentready.org/#reachable"},"why":"Some crawlers collect data for model training. This check reports which training crawlers robots.txt blocks. It is policy information and does not change the score.","profiles":[],"score_role":"informational","ar_strengths":{"AR-FIND-01":"MUST"},"ar_practice_ids":["AR-FIND-01"],"legacy_id":"te.2","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.training-crawler-blocking","strength_source":null,"i18n":{"nl":{"name":"Blokkade van trainingscrawlers","steps":["Maak een lijst van de trainingscrawlers die je wilt toestaan of blokkeren, bijvoorbeeld GPTBot, CCBot en Google-Extended.","Voeg per crawler een User-agent-groep met Allow of Disallow toe.","Sta zoek- en gebruikersagents toe, bijvoorbeeld OAI-SearchBot en Claude-User."],"why":"Sommige crawlers verzamelen data voor modeltraining. Deze check meldt welke trainingscrawlers robots.txt blokkeert. Het is beleidsinformatie en verandert de score niet.","verify_expect":"User-agent-groepen voor de trainingscrawlers die passen bij je beleid","fix_summary":"Zet expliciete regels voor trainingscrawlers die passen bij je beleid."}},"maturity":null,"applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":null,"ar_mapping":"partial","evidence_type":"scanner_data"},{"id":"ia.tdmrep","name":"TDMRep declaration","verify":{"command":"curl -sf https://{domain}/.well-known/tdmrep.json | jq -e 'type == \"array\"'","rescan":"isagentready results {domain} --checkpoint ia.tdmrep","expect":"exit code 0"},"fix":{"steps":[{"action":"Create /.well-known/tdmrep.json with one entry per path pattern.","order":1,"language":"json","code_example":"[\n  {\"location\": \"/*\", \"tdm-reservation\": 1, \"tdm-policy\": \"https://example.com/tdm-policy.json\"}\n]"},{"action":"Serve the file as application/json with HTTP 200.","order":2,"language":null,"code_example":null}],"summary":"Publish /.well-known/tdmrep.json when you reserve text and data mining rights.","skill":{"name":"ai-content-discovery","anchor":"ia.tdmrep"}},"category":"training_exposure","aggregate":null,"references":[{"title":"W3C TDM Reservation Protocol","kind":"spec","url":"https://www.w3.org/community/reports/tdmrep/CG-FINAL-tdmrep-20240202/"}],"stage":"find","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":null,"evidence_source":{"title":"W3C TDM Reservation Protocol","url":"https://www.w3.org/community/reports/tdmrep/CG-FINAL-tdmrep-20240202/"},"why":"The W3C TDM Reservation Protocol lets a site reserve text and data mining rights in a machine-readable file. This check reports if the file exists. It does not change the score.","profiles":[],"score_role":"informational","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"te.3","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.tdmrep","strength_source":null,"i18n":{"nl":{"name":"TDMRep-declaratie","steps":["Maak /.well-known/tdmrep.json met een entry per padpatroon.","Lever het bestand als application/json met HTTP 200."],"why":"Het W3C TDM Reservation Protocol laat een site tekst- en datamining-rechten voorbehouden in een machineleesbaar bestand. Deze check meldt of het bestand bestaat. Het verandert de score niet.","verify_expect":"exitcode 0","fix_summary":"Publiceer /.well-known/tdmrep.json als je tekst- en datamining-rechten voorbehoudt."}},"maturity":null,"applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":null,"ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.ai-txt","name":"ai.txt policy","verify":{"command":"curl -sf https://{domain}/ai.txt","rescan":"isagentready results {domain} --checkpoint ia.ai-txt","expect":"HTTP 200 with a plain-text policy"},"fix":{"steps":[{"action":"Write your AI use policy in /ai.txt as plain text.","order":1,"language":null,"code_example":null},{"action":"Make sure that robots.txt and Content-Usage say the same.","order":2,"language":null,"code_example":null}],"summary":"Publish /ai.txt only when you also keep robots.txt and Content-Usage rules aligned with it.","skill":{"name":"ai-content-discovery","anchor":"ia.ai-txt"}},"category":"training_exposure","aggregate":null,"references":[{"title":"Spawning ai.txt","kind":"guide","url":"https://site.spawning.ai/spawning-ai-txt"}],"stage":"find","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":null,"evidence_source":{"title":"Spawning ai.txt","url":"https://site.spawning.ai/spawning-ai-txt"},"why":"ai.txt is an informal convention for a site policy on AI use. Few agents read it. This check reports if the file exists and does not change the score.","profiles":[],"score_role":"informational","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"te.4","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.ai-txt","strength_source":null,"i18n":{"nl":{"name":"ai.txt-beleid","steps":["Schrijf je beleid voor AI-gebruik in /ai.txt als platte tekst.","Zorg dat robots.txt en Content-Usage hetzelfde zeggen."],"why":"ai.txt is een informele conventie voor een sitebeleid over AI-gebruik. Weinig agents lezen het. Deze check meldt of het bestand bestaat en verandert de score niet.","verify_expect":"HTTP 200 met een beleid in platte tekst","fix_summary":"Publiceer /ai.txt alleen als je robots.txt- en Content-Usage-regels er ook op afstemt."}},"maturity":null,"applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":null,"ar_mapping":"none","evidence_type":"recommendation"},{"id":"ia.web-bot-auth","name":"Web Bot Auth","verify":{"command":"curl -sf https://{domain}/.well-known/http-message-signatures-directory | jq -e '.keys | length > 0'","rescan":"isagentready results {domain} --checkpoint ia.web-bot-auth","expect":"exit code 0"},"fix":{"steps":[{"action":"Generate an Ed25519 key pair for your bot.","order":1,"language":null,"code_example":null},{"action":"Publish the public key as a JWKS in the signatures directory.","order":2,"language":"json","code_example":"{\n  \"keys\": [{\"kty\": \"OKP\", \"crv\": \"Ed25519\", \"x\": \"<base64url key>\"}]\n}"}],"summary":"Publish /.well-known/http-message-signatures-directory when your site operates a signing bot.","skill":{"name":"ai-content-discovery","anchor":"ia.web-bot-auth"}},"category":"training_exposure","aggregate":null,"references":[{"title":"HTTP Message Signatures directory draft","kind":"spec","url":"https://datatracker.ietf.org/doc/draft-meunier-http-message-signatures-directory/"}],"stage":"find","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-30","evidence_tier":null,"evidence_source":{"title":"HTTP Message Signatures directory draft","url":"https://datatracker.ietf.org/doc/draft-meunier-http-message-signatures-directory/"},"why":"Web Bot Auth lets a bot sign its HTTP requests so that sites can verify it. A key directory at a well-known path publishes the public keys. This check reports if the directory exists.","profiles":[],"score_role":"informational","ar_strengths":{},"ar_practice_ids":[],"legacy_id":"te.5","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.web-bot-auth","strength_source":null,"i18n":{"nl":{"name":"Web Bot Auth","steps":["Genereer een Ed25519-sleutelpaar voor je bot.","Publiceer de publieke sleutel als JWKS in de signatures directory."],"why":"Met Web Bot Auth ondertekent een bot zijn HTTP-requests, zodat sites hem kunnen verifieren. Een key directory op een well-known-pad publiceert de publieke sleutels. Deze check meldt of die directory bestaat.","verify_expect":"exitcode 0","fix_summary":"Publiceer /.well-known/http-message-signatures-directory als je site een ondertekenende bot heeft."}},"maturity":null,"applicability":{"mode":"always","condition":null,"surfaces":["website"]},"strength":null,"ar_mapping":"none","evidence_type":"recommendation"}]}