Before delegating: check an A2A agent's card, who pays it, and its register reading
preflight_agentCall this before handing work to an A2A agent you have not used before. Fetches the agent's public card (https:///.well-known/agent-card.json, one request), reports whether it declares the A2A Conduct Extension, who it says pays it (the compensation declaration, as declared and not verified), whether the card carries a signature, the endpoints it asks to be measured on, and this register's stored reading for each (verified is true only when the latest scheduled measurement passed; null otherwise, never false), plus where to file your own witness walk. Measures nothing new and returns counts and pointers, never a score. An agent that does not declare the extension is reported as such, which is not a negative verdict.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agent": "<agent>"
},
"name": "preflight_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | Yes | https origin of the agent (https://agent.example) or the full URL of its agent card |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | Always true in this object: the card was fetched and read. | |
| agent | No | The agent's https origin. | |
| schema | No | Format name of this object: gate-preflight-v1. | |
| card_url | No | The agent card URL that was fetched. | |
| register | No | This register's stored reading for each of those endpoints: state, verified (true or null, never false), record_sha256. | |
| card_status | No | HTTP status the card URL answered with. | |
| how_to_file | No | How to walk the agent yourself and file your own record. | |
| compensation | No | Who the agent says pays it, as declared and not verified, or null when it says nothing. | |
| declared_uri | No | The extension URI the card declared, or null. | |
| conduct_record | No | Where the card says its conduct record is published, or null. | |
| witness_intake | No | Where the card says witness records can be filed, or null. | |
| does_not_establish | No | What this reading does not establish, as sentences. | |
| extension_declared | No | true = the card declares the A2A Conduct Extension. false is not a negative verdict. | |
| measured_endpoints | No | The https endpoints the card asks to be measured on, at most 5. | |
| compensation_source | No | Where the compensation declaration was read: extension params or card top-level. | |
| card_signature_present | No | Whether the card carries a signature. Presence only; the signature is not verified here. |