Skip to content
Methodology

A2A Agent Card

ia.a2a-agent-card · 4.3

Act MAY Recommendation AR-READ-06

Why it matters

The Agent2Agent (A2A) protocol enables autonomous agent-to-agent communication. An Agent Card at /.well-known/agent-card.json advertises the agent's capabilities and supported A2A interfaces.

How to fix it

Serve an A2A Agent Card with name, description, url, capabilities and supportedInterfaces.

  1. Create /.well-known/agent-card.json with the required A2A 1.0 fields.

    {
  "name": "Example agent",
  "description": "Answers questions about Example products",
  "url": "https://example.com/a2a",
  "version": "1.0.0",
  "capabilities": {"streaming": false},
  "supportedInterfaces": [{"url": "https://example.com/a2a", "protocolBinding": "JSONRPC"}],
  "skills": [{"id": "search", "name": "Search", "description": "Search the catalog"}]
}

  2. Serve the file as application/json with HTTP 200.

Verify

curl -sf https://{domain}/.well-known/agent-card.json | jq -e '.name and .url'

Expected: exit code 0

Run a new scan for this checkpoint:

isagentready results {domain} --checkpoint ia.a2a-agent-card
Details Mapping, lifecycle and references
AR mapping
Partial match
Score role
Bonus
Introduced
2026-08-24
Methodology version
2026-10-22

Checkpoint data (JSON)