Discovery
Publish an Agent Card, commonly at /.well-known/agent-card.json, with skills, endpoints, protocol version, and security schemes.
Stable v1.0.1 · Verified May 28, 2026
A2A v1.0.1 defines how agents publish capabilities, exchange messages, manage tasks, and return artifacts across JSON-RPC, gRPC, or HTTP+JSON. A useful implementation still needs clear approvals, security, status, and failure handling.
Publish an Agent Card, commonly at /.well-known/agent-card.json, with skills, endpoints, protocol version, and security schemes.
Use messages for communication, tasks for stateful work, and artifacts for outputs that clients can inspect or download.
Declare and negotiate versions and bindings. Use the maintained conformance kit and Inspector instead of assuming two implementations interoperate.
Directory inclusion describes a submitted integration; it is not a security audit or protocol certification. Verify capabilities and permissions with the maintainer.
A polished happy path says little about how an integration handles sensitive data, partial failures, or destructive actions.
Accepted payloads, authentication, rate limits, and the event that starts work.
Systems changed, data written, messages sent, and operations that require approval.
Progress states, retries, idempotency, timeouts, cancellation, and actionable failure messages.
Maintainer, support channel, release policy, data retention, and security disclosure route.