Skip to content

Agent Cards

Every A2A agent publishes an agent card: a JSON document with its name, description, skills, and the interfaces it accepts. a2a reads the card to decide how to connect.

Command What it does
a2a card get <ref> Prints the card.
a2a card get <ref> -o json Prints the raw card.
a2a card get <ref> --extended Asks the agent for the card it shows authenticated callers.
a2a <command> -a <ref> Uses the card to pick the agent's interface for any command.

Card references

--agent-card (-a), and the argument of card get, take these forms:

You pass a2a reads
agent.example.com https://agent.example.com/.well-known/agent-card.json
localhost:8080 or 127.0.0.1:8080 http://localhost:8080/.well-known/agent-card.json
https://agent.example.com/cards/a.json That URL, since it has a path
./card.json or any existing file The file
urn:air:acme.com:agent:finance The card of that agent in your contacts or a registered AI Catalog
fin The card of the contact named fin
a2a card get localhost:8080
Name:         demo
Description:  demo is an acp coding agent reached through `a2a-serve`. ...
Version:      1.0.0
Interfaces:
  JSONRPC (A2A v1.0)     http://127.0.0.1:43229
  HTTP+JSON (A2A v1.0)   http://127.0.0.1:43229
Streaming:    true
Skills:
  coding               Coding agent

Interfaces lists the URLs and protocol bindings the agent accepts. Streaming says whether it can stream replies.

Save a card

a2a card get localhost:8080 -o json > agent-card.json
a2a send -a ./agent-card.json "hello"

A saved card skips the network round trip, and pins the interfaces you tested against.

Skip the card

When you know the interface URL and its protocol, connect to it directly with --endpoint (-e) and exactly one --transport:

a2a send -e http://127.0.0.1:43229 --transport jsonrpc "hello"

Transports covers the protocol choice, and Discovery how a2a picks an interface from the card.