AI Product Index / agent card at /.well-known/agent-card.json

agent card at /.well-known/agent-card.json

It is what turns a page into a tool: a machine-readable statement of what you can be asked to do. The path moved in A2A 1.0, and a card only at the old location is invisible to a compliant client.

10
of 122 points
8.2%
of the total grade
2025
checklist generation

Does this apply to your site?

For sites offering an A2A agent service. A content-only site does not need to invent one.

This score measures coverage of a published technical checklist. It does not measure AI visibility, referrals, content understanding or successful agent tasks. Optional service interfaces may not apply to your site; missing them still affects this fixed checklist.

How to address it when relevant

Publish an agent card at /.well-known/agent-card.json describing your callable interfaces (A2A 1.0) — this is what turns a page into a tool. Serve the same document at /.well-known/agent.json too, for clients written before the path moved.

Example to adapt

Replace {{ORIGIN}} with your own origin — or call the paid endpoint, which substitutes it for you and tells you which checks failed. Review all placeholder names, paths, prices and capabilities before publishing; origin substitution does not verify them.

{
  "_comment": "publish at {{ORIGIN}}/.well-known/agent-card.json (A2A 1.0), and at {{ORIGIN}}/.well-known/agent.json for pre-0.3 clients",
  "name": "Your Product",
  "description": "One sentence on what it does.",
  "url": "{{ORIGIN}}/",
  "provider": { "organization": "Your Company", "url": "{{ORIGIN}}/" },
  "version": "1.0.0",
  "capabilities": { "streaming": false },
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["application/json"],
  "skills": [{
    "id": "example",
    "name": "Example skill",
    "description": "What an agent can ask this service to do.",
    "tags": ["example"]
  }]
}

Check your own site

Free, no signup, same endpoint that produced every grade on the leaderboard:

curl "https://index.percall.dev/api/score?url=https://your-site.example"

It returns the letter grade and every check by name with pass/fail. The $0.05 call at POST /api/audit adds why each one failed and a snippet with your origin already in it.

The rest of the checklist

12 more 2025 checks, and 7 from the other generation.