AI Readiness
A2A Agent Card
A2A Agent Card is one of the public readiness signals included in isitready.dev reports.
What we check
How the scan observes this signal.
The scanner fetches /.well-known/agent-card.json, validates the JSON shape against the A2A schema, and reports whether name, description, url, and supportedInterfaces entries are present, well-formed, and reachable.
Why it matters
Why this shows up on the report card.
Agent cards advertise an agent's capabilities, protocols, and trust signals so other agents can collaborate without bespoke integration.
How to improve
Steps in the remediation brief.
Publish /.well-known/agent-card.json on the canonical origin of any service that exposes an A2A-compatible agent.
Populate supportedInterfaces with the full set of protocols you implement (A2A, MCP, agent-skills, OpenAPI) so peers can negotiate.
Keep url and name in sync with your public branding so agents that surface the card can attribute correctly.
Add a Link: <…/.well-known/agent-card.json>; rel="agent-card" header on the homepage to make discovery one-hop.