Glossary › Agent card
Agent card — a machine-readable identity file for a site
An agent card is a JSON file, conventionally at /.well-known/agent-card.json, that states who a site belongs to, what it offers, and where the machine-readable surfaces are.
It is the identity half of the pair. The fact file answers questions in prose; the card is the structured version an automated client can parse without guessing: name, description, the endpoints that matter, a version, and the attestation — who signed these facts off, and when.
We publish one for our own site and generate one for every package, because it costs nothing to be legible. What we will not do is dress it up as demand: we have never measured an agent reading a card in the wild. It is a standards bet with a small, known cost.
disambiguation
What Agent card is not
- It is not proof of identity. A file on a domain shows control of that domain and nothing more.
- It is not structured data for search. Search engines read schema.org markup in the page; this is a separate file for automated clients.
free audit
See what AI sees on your site
Vocabulary is cheap. The measurement is the part that tells you whether any of it applies to your site.
One model fetches your homepage and answers buyer questions from it. You get the recovery score and the specific answers it could not find. That is the whole free tier: it shows you the problem, and the fix package is not included.