Question 1

What is ai-catalog.json / Agentic Resource Discovery?

Accepted Answer

Agentic Resource Discovery (ARD) is a draft specification, backed by Google and Microsoft, for a /.well-known/ai-catalog.json manifest that advertises everything a site offers to AI agents in one place — its MCP servers, A2A agents, APIs and skills. Crawlers and registries read it to discover your agent-facing resources without guessing at well-known paths.

Question 2

Where do I host ai-catalog.json?

Accepted Answer

Serve it at https://your-domain/.well-known/ai-catalog.json. Each listed resource points to its own endpoint or manifest (for example an MCP server's URL or server-card), so agents can follow the catalog to the actual service.

Question 3

How does this fit with MCP and A2A?

Accepted Answer

ai-catalog.json is the index; MCP servers and A2A agent cards are the entries it points to. Generate the catalog here, then generate an MCP Server Card for each MCP endpoint, and health-check each server with MCP Pulse so the resources you advertise actually work.

ai-catalog.json generator