Skip to the content

Agent readiness check

An ARD catalog lists the site's agentic resources

/.well-known/ai-catalog.json is an Agentic Resource Discovery manifest with a specVersion, a host and valid entries.

low severityagents.ard

Run this check on your site

Runs just this check in quick mode. The report opens with the evidence and the fix.

Why it matters

One manifest lists every resource an agent can use on the site, MCP servers, APIs, skills and agents, so registries and agents can index the site in one request.

How to fix it

Serve /.well-known/ai-catalog.json as application/json with "specVersion", a "host" object and an "entries" array. Give each entry a urn:air:<your-domain>:<namespace>:<name> identifier, a displayName, a media type in "type" and exactly one of "url" or "data".

The details

Category
Agent readiness
Severity of a failure
low
Confidence
high
Needs a browser
No
Check id
agents.ard

References