Methodology
agents.json
ia.agents-json · 4.6
Act
MAY
Recommendation
Why it matters
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.
How to fix it
Publish /.well-known/agents.json with your agent endpoints.
-
Create /.well-known/agents.json with one entry per agent endpoint.
{ "agents": [{"name": "Example agent", "url": "https://example.com/a2a", "protocol": "a2a"}] }
Verify
curl -sf https://{domain}/.well-known/agents.json | jq -e 'type == "object"'
Expected: exit code 0
Run a new scan for this checkpoint:
isagentready results {domain} --checkpoint ia.agents-json
Details Mapping, lifecycle and references
- AR mapping
- No AR practice
- Evidence source
- A2A 1.0 specification
- Score role
- Informational
- Introduced
- 2026-08-24
- Methodology version
- 2026-10-22