---
title: "AR-FIND-04: AI Catalog at .well-known | Agent Ready Checklist"
description: "AR-FIND-04 (MAY, Find layer): AI Catalog at .well-known. What it asks, the evidence, the command that verifies it and the fix on 19 platforms."
canonical: https://agentreadychecklist.com/checklist/ar-find-04
site: "Agent Ready Checklist"
last_updated: 2026-11-05
section: "Checklist"
---
# AR-FIND-04: AI Catalog at .well-known | Agent Ready Checklist
> AR-FIND-04 (MAY, Find layer): AI Catalog at .well-known. What it asks, the evidence, the command that verifies it and the fix on 19 platforms.
Source: https://agentreadychecklist.com/checklist/ar-find-04
Site: Agent Ready Checklist
Last reviewed: 2026-11-05
Agent endpoints: https://agentreadychecklist.com/llms.txt (index), https://agentreadychecklist.com/openapi.json (API), https://agentreadychecklist.com/mcp (MCP server), https://agentreadychecklist.com/ask (search)
Access: https://agentreadychecklist.com/auth.md (no key). Pricing: https://agentreadychecklist.com/pricing.md (free).
# AR-FIND-04: AI Catalog at .well-known
AR-FIND-04 is a MAY on the find layer: Publish an AI Catalog at /.well-known/ai-catalog.json listing every agent-facing resource (MCP server card, OpenAPI, A2A card, docs, llms.txt, skills), linked with and an HTTP Link header. It applies to sites that ship more than one agent-facing resource. 19 of 19 platforms have a recipe below, 10 of them workarounds.
## The requirement
Identifier
AR-FIND-04
Level
MAY
Layer
Find
Applies to
sites that ship more than one agent-facing resource
Checked by
Ora, matched on this site, Cloudflare ard, Verify Kit ai-catalog
Ora check
[ai-catalog-published, ard-catalog](#ora)
The statement
Publish an AI Catalog at /.well-known/ai-catalog.json listing every agent-facing resource (MCP server card, OpenAPI, A2A card, docs, llms.txt, skills), linked with and an HTTP Link header.
## Why
- AR-FIND-04 was added in v2.0 (October 2026) and is marked not measured in the studies.primary source, 2026-10-20: [github.com/agentready-org/standard/blob/main/CHANGELOG.md](https://github.com/agentready-org/standard/blob/main/CHANGELOG.md), read 2026-11-04
- Cloudflare isitagentready checks the ARD manifest at /.well-known/ai-catalog.json and wants Content-Type application/json, HTTP 200 and Access-Control-Allow-Origin: \*.primary source: [isitagentready.com/.well-known/agent-skills/ard/SKILL.md](https://isitagentready.com/.well-known/agent-skills/ard/SKILL.md), read 2026-11-04
- The ARD spec is a v0.9 draft, so the Cloudflare scanner validates structure only and does not fail on non-conformant identifiers.primary source: [isitagentready.com/.well-known/agent-skills/ard/SKILL.md](https://isitagentready.com/.well-known/agent-skills/ard/SKILL.md), read 2026-11-04
- Each catalog entry needs exactly one of url or data, an identifier, a displayName and a media type.primary source: [isitagentready.com/.well-known/agent-skills/ard/SKILL.md](https://isitagentready.com/.well-known/agent-skills/ard/SKILL.md), read 2026-11-04
## How to verify
### [AI Catalog published](https://agentreadychecklist.com/kit/ai-catalog/)
```bash
curl -fsSL https://agentreadychecklist.com/kit/verify.sh | bash -s -- https://example.com --only=ai-catalog
```
Fetches /.well-known/ai-catalog.json, checks 200, JSON content type, Access-Control-Allow-Origin: \*, a specVersion and a non-empty entries array, and a on the home page.
**It cannot prove:** ARD is a v0.9 draft; structure checks only.
### The one-line version
curl -s /.well-known/ai-catalog.json | jq -e ".entries | length > 0".
## Verify with Ora
2 checks in Ora's catalogue (contract 1.38.0, read 2026-11-05) read this row. Each entry says what the check looks at and why this page lists it.
- `ai-catalog-published` AI Catalog discovery Tests for a valid AI Catalog at /.well-known/ai-catalog.json, the discovery path of the ai-catalog.io standard. A bonus check. Discovery, 1 point, bonus, recommended; catalogue applicability all. Listed because: same name, `ai catalog`.
- `ard-catalog` ARD discovery Looks for an ARD (Agentic Resource Discovery) catalog at /.well-known/ard.json, or one the homepage points to with a link rel=ard tag or a Link header. The older /.well-known/ai-catalog.json and rel=ai-catalog still count, with a nudge to move. Discovery, 1 point, required; catalogue applicability all. Listed because: same file in its description, `ai catalog json`.
### Run just these checks
```bash
curl -s -X POST https://ora.ai/api/scan/checks -H 'content-type: application/json' -d '{"url":"https://example.com","checkIds":["ai-catalog-published","ard-catalog"]}'
```
This calls the endpoint Ora documents for re-verifying a fix. It sends no cache, returns a result for each id and no total score, and spends one scan from the daily budget. Replace the URL with yours. [How to re-verify one fix](https://agentreadychecklist.com/guides/re-verify-one-fix-with-ora/).
### Or audit the whole site
```bash
npx ax@0.10 audit https://example.com --min-score 70
```
Exit code 1 means the score is below the number you passed, so the same line gates a deploy: [the CI recipe](https://agentreadychecklist.com/guides/gate-deploys-on-agent-readiness-in-ci/). [Why this site recommends Ora, and where it falls short](https://agentreadychecklist.com/verify-with-ora/).
## Fix it on your platform
### Next.js (App Router)recipe
Add app/.well-known/ai-catalog.json/route.ts exporting GET that returns Response.json({ specVersion: "1.0", host: {…}, entries: \[…\] }), or place the static file at public/.well-known/ai-catalog.json.
Next.js 16.x (npm latest 16.4.5, read 2026-11-04); docs at nextjs.org/docs/app. Read 2026-11-04. [nextjs.org/docs/app/api-reference/file-conventions/route](https://nextjs.org/docs/app/api-reference/file-conventions/route). [All Next.js (App Router) recipes](https://agentreadychecklist.com/platforms/nextjs-app-router/#ar-find-04)
### Astrorecipe
Put the catalog at public/.well-known/ai-catalog.json, or generate it in src/pages/.well-known/ai-catalog.json.ts with export const GET = () => Response.json(catalog).
Astro 7.x (npm latest astro 7.4.5, @astrojs/sitemap 3.7.4, read 2026-11-04). Read 2026-11-04. [docs.astro.build/en/guides/endpoints/](https://docs.astro.build/en/guides/endpoints/). [All Astro recipes](https://agentreadychecklist.com/platforms/astro/#ar-find-04)
### Nuxtrecipe
Place public/.well-known/ai-catalog.json, or return it from server/routes/.well-known/ai-catalog.json.ts with defineEventHandler(() => catalog).
Nuxt 4.x (npm latest nuxt 4.6.4, @nuxtjs/robots 7.0.2, @nuxtjs/sitemap 9.1.0, read 2026-11-04). Read 2026-11-04. [nuxt.com/docs/guide/directory-structure/server](https://nuxt.com/docs/guide/directory-structure/server). [All Nuxt recipes](https://agentreadychecklist.com/platforms/nuxt/#ar-find-04)
### SvelteKitrecipe
Put static/.well-known/ai-catalog.json, or a prerendered src/routes/.well-known/ai-catalog.json/+server.ts returning json(catalog).
SvelteKit (npm latest @sveltejs/kit 3.1.1, read 2026-11-04); docs at svelte.dev/docs/kit. Read 2026-11-04. [svelte.dev/docs/kit/routing](https://svelte.dev/docs/kit/routing). [All SvelteKit recipes](https://agentreadychecklist.com/platforms/sveltekit/#ar-find-04)
### Remix and React Router (framework mode)recipe
Add a resource route for /.well-known/ai-catalog.json whose loader returns Response.json(catalog), or place the file in public/.well-known/.
React Router framework mode (npm latest react-router 8.5.1; Remix v2 @remix-run/node 2.17.5, read 2026-11-04); docs at reactrouter.com. Read 2026-11-04. [reactrouter.com/how-to/resource-routes](https://reactrouter.com/how-to/resource-routes). [All Remix and React Router (framework mode) recipes](https://agentreadychecklist.com/platforms/remix-react-router/#ar-find-04)
### Plain static hosting (Netlify, Vercel static, Cloudflare Pages, GitHub Pages, S3 and CloudFront)recipe
Upload .well-known/ai-catalog.json. On Netlify and Cloudflare Pages add a \_headers rule "/.well-known/ai-catalog.json" with "Access-Control-Allow-Origin: \*". GitHub Pages: Jekyll skips dot folders unless you add a .nojekyll file.
Host documentation as published on 2026-11-04 (no version numbers; config files \_headers, \_redirects, vercel.json, 404.html). Read 2026-11-04. [docs.netlify.com/manage/routing/headers/](https://docs.netlify.com/manage/routing/headers/). [All Plain static hosting (Netlify, Vercel static, Cloudflare Pages, GitHub Pages, S3 and CloudFront) recipes](https://agentreadychecklist.com/platforms/static-hosting/#ar-find-04)
### WordPress and Elementorrecipe
Upload `.well-known/ai-catalog.json` to the web root (the web server serves it before WordPress loads). Advertise it in the head: `add_action('wp_head', fn() => print '');`
WordPress 7.1.4 (core release from the version-check API), Elementor 4.3.6 (plugin directory, updated 2026-11-02), Yoast SEO 28.8 noted for llms.txt; docs read 2026-11-04. Read 2026-11-04. [developer.wordpress.org/reference/hooks/wp\_head/](https://developer.wordpress.org/reference/hooks/wp_head/). [All WordPress and Elementor recipes](https://agentreadychecklist.com/platforms/wordpress-elementor/#ar-find-04)
### Shopify (Online Store 2.0 themes)workaround
Root paths such as /.well-known/ai-catalog.json are platform-owned. Host the catalog on your own domain or app proxy (/apps/…) and add `` to layout/theme.liquid.
Hosted SaaS, Online Store 2.0 Liquid themes, docs read 2026-11-04; storefront behaviour probed live on one Shopify store the same day. Read 2026-11-04. [shopify.dev/docs/apps/build/online-store/app-proxies](https://shopify.dev/docs/apps/build/online-store/app-proxies). [All Shopify (Online Store 2.0 themes) recipes](https://agentreadychecklist.com/platforms/shopify/#ar-find-04)
### Webflowworkaround
Webflow does not host files at /.well-known/. Serve ai-catalog.json from a reverse proxy or Cloudflare Worker in front of the origin, and add `` in Site settings > Custom code > Head code.
Hosted SaaS, help center articles read 2026-11-04 (updated dates 2024-10-14 to 2026-10-29). Read 2026-11-04. [help.webflow.com/hc/en-us/articles/49835650986259-Set-up-a-self-managed-reverse-proxy-in-Webflow](https://help.webflow.com/hc/en-us/articles/49835650986259-Set-up-a-self-managed-reverse-proxy-in-Webflow). [All Webflow recipes](https://agentreadychecklist.com/platforms/webflow/#ar-find-04)
### Framerrecipe
Site Settings > Hosting > Files > Add, upload ai-catalog.json with path /.well-known, publish; add `` as head Custom Code.
Hosted SaaS, help articles read 2026-11-04 (marked updated 2026-09-15). Read 2026-11-04. [framer.com/help/articles/static-files/](https://www.framer.com/help/articles/static-files/). [All Framer recipes](https://agentreadychecklist.com/platforms/framer/#ar-find-04)
### Wix (Wix Editor and Wix Studio)workaround
Wix-managed hosting has no file upload at /.well-known/. Workaround: list agent resources in the Wix-generated llms.txt, or move to Wix Headless where your code serves the path.
Hosted SaaS, help center read 2026-11-04. Read 2026-11-04. [dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/about-seo-support](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/about-seo-support). [All Wix (Wix Editor and Wix Studio) recipes](https://agentreadychecklist.com/platforms/wix/#ar-find-04)
### Squarespace (version 7.1)workaround
No file hosting at /.well-known/. Not possible on this platform; workaround: describe agent resources in llms.txt and host the catalog on a domain you control.
Hosted SaaS, version 7.1 sites, help center read 2026-11-04 (articles updated 2026-07-17 to 2026-11-03). Read 2026-11-04. [support.squarespace.com/hc/en-us/articles/47434125611277-Create-an-llms-txt-file (the article needs a Squarespace sign-in to read)](https://support.squarespace.com/hc/en-us/articles/47434125611277-Create-an-llms-txt-file). [All Squarespace (version 7.1) recipes](https://agentreadychecklist.com/platforms/squarespace/#ar-find-04)
### HubSpot CMS (Content Hub)workaround
Upload ai-catalog.json to the file manager, then create a URL redirect from /.well-known/ai-catalog.json to the file URL. Agents and validators that require a 200 at the origin path will not accept the redirect.
Hosted SaaS, Content Hub, knowledge base and developer docs read 2026-11-04. Read 2026-11-04. [knowledge.hubspot.com/domains-and-urls/create-and-manage-url-redirects](https://knowledge.hubspot.com/domains-and-urls/create-and-manage-url-redirects). [All HubSpot CMS (Content Hub) recipes](https://agentreadychecklist.com/platforms/hubspot-cms/#ar-find-04)
### Docusaurusrecipe
Add static/.well-known/ai-catalog.json; it is copied to /.well-known/ai-catalog.json. On GitHub Pages add an empty static/.nojekyll so dot and underscore paths are served. Add a headTags entry { tagName: 'link', attributes: { rel: 'ai-catalog', href: '/.well-known/ai-catalog.json' } }.
3.10.2 (npm @docusaurus/core latest, read 2026-11-04). Read 2026-11-04. [docusaurus.io/docs/static-assets](https://docusaurus.io/docs/static-assets). [All Docusaurus recipes](https://agentreadychecklist.com/platforms/docusaurus/#ar-find-04)
### Mintlifyworkaround
No generated ai-catalog.json (/.well-known/ai-catalog.json returned 404 on www.mintlify.com, 2026-11-04). Serve one from your reverse proxy or a Worker on the docs domain.
Hosted SaaS, docs read 2026-11-04. Read 2026-11-04. [mintlify.com/docs/deploy/reverse-proxy](https://mintlify.com/docs/deploy/reverse-proxy). [All Mintlify recipes](https://agentreadychecklist.com/platforms/mintlify/#ar-find-04)
### GitBookworkaround
No ai-catalog.json support documented. Serve docs under a subdirectory through Cloudflare and publish /.well-known/ai-catalog.json from your root domain.
Hosted SaaS, docs read 2026-11-04. Read 2026-11-04. [gitbook.com/docs/publish/custom-domain/setting-a-custom-subdirectory/configuring-a-subdirectory-with-cloudflare](https://gitbook.com/docs/publish/custom-domain/setting-a-custom-subdirectory/configuring-a-subdirectory-with-cloudflare). [All GitBook recipes](https://agentreadychecklist.com/platforms/gitbook/#ar-find-04)
### ReadMeworkaround
No ai-catalog.json toggle. Turn on API Catalog (/.well-known/api-catalog) and MCP Server Card; serve ai-catalog.json from your main domain or a proxy.
Hosted SaaS, docs read 2026-11-04. Read 2026-11-04. [docs.readme.com/main/docs/using-a-reverse-proxy](https://docs.readme.com/main/docs/using-a-reverse-proxy). [All ReadMe recipes](https://agentreadychecklist.com/platforms/readme/#ar-find-04)
### Salesforce B2C Commerce (SFRA and PWA Kit / Composable Storefront)workaround
No catalog feature. PWA Kit: add static/.well-known/ai-catalog.json to ssrShared and app.get('/.well-known/ai-catalog.json', runtime.serveStaticFile('static/.well-known/ai-catalog.json')) in ssr.js, following the sitemap pattern.
Hosted SaaS (B2C Commerce help release 264.0.0); PWA Kit retail-react-app 10.3.0 and pwa-kit-runtime 3.21.0 on npm, read 2026-11-04. Read 2026-11-04. [developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/create-a-sitemap.html](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/create-a-sitemap.html). [All Salesforce B2C Commerce (SFRA and PWA Kit / Composable Storefront) recipes](https://agentreadychecklist.com/platforms/salesforce-commerce-cloud/#ar-find-04)
### Adobe Commerce and Magento Open Sourceworkaround
No catalog feature. On-premise, place pub/.well-known/ai-catalog.json if the web server serves it; on cloud, serve it with a Fastly custom VCL snippet (synthetic response).
2.4.9 (GitHub tag published 2026-05-12; 2.4.10-alpha1 tagged 2026-10-13); release notes read 2026-11-04. Read 2026-11-04. [experienceleague.adobe.com/en/docs/commerce-on-cloud/user-guide/cdn/custom-vcl-snippets/fastly-vcl-custom-snippets](https://experienceleague.adobe.com/en/docs/commerce-on-cloud/user-guide/cdn/custom-vcl-snippets/fastly-vcl-custom-snippets). [All Adobe Commerce and Magento Open Source recipes](https://agentreadychecklist.com/platforms/adobe-commerce/#ar-find-04)
## What it does not do
- Not measured: no study shows agents reading ai-catalog.json today.
- Does not replace links from pages agents already read.
## Common mistakes
- Entry with both url and data.
- Served as text/html by a catch-all route.
- Missing CORS header, so browser-based agents cannot read it.
## Related
- Term: [llms.txt](https://agentreadychecklist.com/glossary/llms-txt/)
- Term: [Link header](https://agentreadychecklist.com/glossary/link-header/)
- Term: [.well-known](https://agentreadychecklist.com/glossary/well-known/)
- Term: [AI Catalog](https://agentreadychecklist.com/glossary/ai-catalog/)
- Term: [OpenAPI](https://agentreadychecklist.com/glossary/openapi/)
- Term: [MCP server](https://agentreadychecklist.com/glossary/mcp-server/)
## Sources
- [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md)read 2026-11-04
- [github.com/agentready-org/standard/blob/main/CHANGELOG.md](https://github.com/agentready-org/standard/blob/main/CHANGELOG.md)read 2026-11-04
- [isitagentready.com/.well-known/agent-skills/ard/SKILL.md](https://isitagentready.com/.well-known/agent-skills/ard/SKILL.md)read 2026-11-04
- [nextjs.org/docs/app/api-reference/file-conventions/route](https://nextjs.org/docs/app/api-reference/file-conventions/route)read 2026-11-04
- [docs.astro.build/en/guides/endpoints/](https://docs.astro.build/en/guides/endpoints/)read 2026-11-04
- [nuxt.com/docs/guide/directory-structure/server](https://nuxt.com/docs/guide/directory-structure/server)read 2026-11-04
- [svelte.dev/docs/kit/routing](https://svelte.dev/docs/kit/routing)read 2026-11-04
- [reactrouter.com/how-to/resource-routes](https://reactrouter.com/how-to/resource-routes)read 2026-11-04
- [docs.netlify.com/manage/routing/headers/](https://docs.netlify.com/manage/routing/headers/)read 2026-11-04
- [developer.wordpress.org/reference/hooks/wp\_head/](https://developer.wordpress.org/reference/hooks/wp_head/)read 2026-11-04
- [shopify.dev/docs/apps/build/online-store/app-proxies](https://shopify.dev/docs/apps/build/online-store/app-proxies)read 2026-11-04
- [help.webflow.com/hc/en-us/articles/49835650986259-Set-up-a-self-managed-reverse-proxy-in-Webflow](https://help.webflow.com/hc/en-us/articles/49835650986259-Set-up-a-self-managed-reverse-proxy-in-Webflow)read 2026-11-04
- [framer.com/help/articles/static-files/](https://www.framer.com/help/articles/static-files/)read 2026-11-04
- [dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/about-seo-support](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/seo/about-seo-support)read 2026-11-04
- [support.squarespace.com/hc/en-us/articles/47434125611277-Create-an-llms-txt-file (the article needs a Squarespace sign-in to read)](https://support.squarespace.com/hc/en-us/articles/47434125611277-Create-an-llms-txt-file)read 2026-11-04
- [knowledge.hubspot.com/domains-and-urls/create-and-manage-url-redirects](https://knowledge.hubspot.com/domains-and-urls/create-and-manage-url-redirects)read 2026-11-04
- [docusaurus.io/docs/static-assets](https://docusaurus.io/docs/static-assets)read 2026-11-04
- [mintlify.com/docs/deploy/reverse-proxy](https://mintlify.com/docs/deploy/reverse-proxy)read 2026-11-04
- [gitbook.com/docs/publish/custom-domain/setting-a-custom-subdirectory/configuring-a-subdirectory-with-cloudflare](https://gitbook.com/docs/publish/custom-domain/setting-a-custom-subdirectory/configuring-a-subdirectory-with-cloudflare)read 2026-11-04
- [docs.readme.com/main/docs/using-a-reverse-proxy](https://docs.readme.com/main/docs/using-a-reverse-proxy)read 2026-11-04
- [developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/create-a-sitemap.html](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/create-a-sitemap.html)read 2026-11-04
- [experienceleague.adobe.com/en/docs/commerce-on-cloud/user-guide/cdn/custom-vcl-snippets/fastly-vcl-custom-snippets](https://experienceleague.adobe.com/en/docs/commerce-on-cloud/user-guide/cdn/custom-vcl-snippets/fastly-vcl-custom-snippets)read 2026-11-04
- [ora.ai/api/checks, contract 1.38.0](https://ora.ai/api/checks?utm_source=agentreadychecklist.com&utm_medium=referral&utm_campaign=requirement)read 2026-11-05
- [ora.ai/llms-full.txt](https://ora.ai/llms-full.txt?utm_source=agentreadychecklist.com&utm_medium=referral&utm_campaign=requirement)read 2026-11-05
- [registry.npmjs.org/ax, the ax README](https://registry.npmjs.org/ax)read 2026-11-05
Verify with Ora
The scanner this site recommends for the whole checklist. 132 checks, a score out of 100, no account.
`npx ax@0.10 audit --min-score `
[Why Ora, and its limits](https://agentreadychecklist.com/verify-with-ora/)
Fix it on
- [Next.js (App Router)recipe](#p-nextjs-app-router)
- [Astrorecipe](#p-astro)
- [Nuxtrecipe](#p-nuxt)
- [SvelteKitrecipe](#p-sveltekit)
- [Remix and React Router (framework mode)recipe](#p-remix-react-router)
- [Plain static hosting (Netlify, Vercel static, Cloudflare Pages, GitHub Pages, S3 and CloudFront)recipe](#p-static-hosting)
- [WordPress and Elementorrecipe](#p-wordpress-elementor)
- [Shopify (Online Store 2.0 themes)workaround](#p-shopify)
- [Webflowworkaround](#p-webflow)
- [Framerrecipe](#p-framer)
- [Wix (Wix Editor and Wix Studio)workaround](#p-wix)
- [Squarespace (version 7.1)workaround](#p-squarespace)
- [HubSpot CMS (Content Hub)workaround](#p-hubspot-cms)
- [Docusaurusrecipe](#p-docusaurus)
- [Mintlifyworkaround](#p-mintlify)
- [GitBookworkaround](#p-gitbook)
- [ReadMeworkaround](#p-readme)
- [Salesforce B2C Commerce (SFRA and PWA Kit / Composable Storefront)workaround](#p-salesforce-commerce-cloud)
- [Adobe Commerce and Magento Open Sourceworkaround](#p-adobe-commerce)
Last reviewed 2026-11-05. AgentReady v2.0, read 2026-11-04.