Catalog / a2a-card-check
A2A Agent Card check
Checks an Agent2Agent (A2A) Agent Card before an agent calls or lists that agent, and says which endpoint to use.
Benched Security-tested against the seller traps of our Agent Benchmark Exam.
Buy $1.00What it does
Validates one A2A Agent Card (JSON text) against A2A protocol 0.3.0, or 0.2.6 (same AgentCard as 0.2.5). schema_valid follows the official a2a.json AgentCard of that tag exactly (required fields, types, security scheme union, apiKey in, OAuth flows; unknown members allowed as in the schema). valid is false exactly when a problem has severity error; each error has rule schema (type_mismatch, required_missing, enum_mismatch, const_mismatch, security_scheme_type_unknown, security_scheme_type_missing, invalid_json) or spec_must, a MUST the schema does not encode: preferred_transport_missing (0.3.0, spec 5.6.1), url_not_http (url or interface url not absolute http(s), spec 3.1), security_scheme_undefined and scopes_not_allowed (OpenAPI 3.0 Security Requirement), url_invalid (OAuth/OIDC URL not absolute http(s)), url_not_https on 0.3.0 authorizationCode URLs and oauth2MetadataUrl (TLS required), and for 0.3.0 signatures (RFC 7515 shape, never verified): signature_protected_invalid (not a base64url JSON object), signature_value_invalid (not base64url; empty allowed), signature_header_overlap (a name in both headers, 7.2.1), signature_alg_missing (alg in neither header, 4.1.1), signature_alg_invalid (alg not a string, or empty). Warnings and infos never change valid: url_not_https on url and interface urls (rule spec_must_in_production: spec 4.1 wants HTTPS in production, which a card does not show) and on other OAuth/OIDC URLs, transport_not_core (non-core or wrongly cased), main_interface_not_listed, mode_not_media_type, duplicate_skill_id, duplicate_key, no_skills, oauth2_no_flows, security_name_too_long (scheme or requirement names over 256 UTF-8 bytes, still checked; one per card), signature_unsecured (alg none), signature_not_checked (past 20 signatures, a protected header over 2,048 chars or an unprotected header over 100 members), protocol_version_mismatch, protocol_version_not_covered, protocol_version_inexact, field_not_in_version (0.3.0-only fields in a 0.2.6 check). spec auto reads protocolVersion: 0.3.0 or 0.3 gives 0.3.0, 0.2.5 or 0.2.6 gives 0.2.6, none gives 0.3.0 unless the card has the A2A 1.x supportedInterfaces layout; other versions (1.0, 0.2.4) are not covered: valid null. Each problem has a code, a JSON Pointer, a severity and a rule. The summary lists name, endpoints, the endpoint a client with the given transports picks (spec 5.6.3), capabilities, extensions, auth schemes, whole security requirement sets, modes and distinct signature algs with totals, and skills (paged). Cards past the limits given for json are refused (ok false).
- Example input
{"json":"{\"protocolVersion\":\"0.3.0\",\"name\":\"Recipe Agent\",\"description\":\"Finds recipes.\",\"url\":\"https://api.example.com/a2a/v1\",\"preferredTransport\":\"JSONRPC\",\"version\":\"1.0.0\",\"capabilities\":{\"streaming\":true},\"defaultInputModes\":[\"text/plain\"],\"defaultOutputModes\":[\"text/plain\"],\"securitySchemes\":{\"bearer\":{\"type\":\"http\",\"scheme\":\"Bearer\"}},\"security\":[{\"bearer\":[]}],\"skills\":[{\"id\":\"find-recipe\",\"name\":\"Find recipe\",\"description\":\"Finds a recipe.\",\"tags\":[\"cooking\"]}]}"}- Answer
{"ok":true,"result":{"valid":true,"schema_valid":true,"reason":null,"spec_checked":"0.3.0","protocol_version_declared":"0.3.0","errors":0,"warnings":0,"infos":0,"problems_total":0,"problems_offset":0,"problems":[],"problems_truncated":false,"summary":{"name":"Recipe Agent","description":"Finds recipes.","agent_version":"1.0.0","provider_organization":null,"protocol_version":"0.3.0","preferred_transport":"JSONRPC","endpoints":[{"url":"https://api.example.com/a2a/v1","transport":"JSONRPC","source":"url","index":null,"url_ok":true}],"endpoints_total":1,"call":{"url":"https://api.example.com/a2a/v1","url_truncated":false,"transport":"JSONRPC","source":"url","index":null,"rule":"preferred_transport"},"capabilities":{"streaming":true,"push_notifications":null,"state_transition_history":null},"extensions":[],"extensions_total":0,"required_extensions":0,"security_schemes":[{"name":"bearer","type":"http"}],"security_schemes_total":1,"auth_required":true,"auth_options":[["bearer"]],"auth_options_total":1,"auth_options_truncated":false,"supports_authenticated_extended_card":null,"signatures":{"count":0,"algs":[],"algs_total":0,"algs_truncated":false,"verified":false},"default_input_modes":["text/plain"],"default_input_modes_total":1,"default_input_modes_truncated":false,"default_output_modes":["text/plain"],"default_output_modes_total":1,"default_output_modes_truncated":false,"skills_total":1,"skills_offset":0,"skills":[{"index":0,"id":"find-recipe","name":"Find recipe","tags":["cooking"],"tags_total":1,"has_own_security":false}],"skills_truncated":false,"text_truncated":false},"standard":"A2A protocol 0.3.0: a2a.json AgentCard (tag v0.3.0) plus spec 3.1, 4.1, 5.5.5 and 5.6; OpenAPI 3.0 Security Requirement rules; RFC 7515 header shape (signatures not verified)"},"warnings":[]}- Try it free
- /try/a2a-card-check
Buy
Price $1.00, once. One buyer only: the first one owns the tool, we stop selling it and list your copy, and every paid call to it goes to your wallet. Comes with a licence: run it, change it and earn from it; the code itself is not passed on or resold.
- Pay with an x402 walletThe buy link is
https://forge.fizzl.eu/forge/packages/a2a-card-check?format=zip. It answers with a payment request (HTTP 402) that an x402 wallet pays in USDC on Base. From Claude, ChatGPT or Grok with the Fizzl Agent Wallet: ask “buy https://forge.fizzl.eu/forge/packages/a2a-card-check?format=zip”. From code:const pay = wrapFetchWithPayment(fetch, client); // see /llms.txt const zip = await pay("https://forge.fizzl.eu/forge/packages/a2a-card-check?format=zip"); - Start it with your walletUnzip,
npm install, thenPAY_TO=0xYourWallet PUBLIC_URL=https://your-host npm starton any Node host. - We list it for youYour copy tells us where it runs; we check it and add it to the x402 Trust Index and the Bazaar under your wallet.
Bought it, and something is wrong?
Paste the receipt you got with the purchase (the X-Forge-Receipt token; a bundle receipt works too) and say what is wrong. Free. We pick it up within the hour; a real fault is fixed, passes the same checks, and you download the new version free at /forge/packages/a2a-card-check/update with your receipt. No money back through this form.
Missing a tool?
Tell us in one sentence what it should do: what goes in, what comes out. Free, no wallet. Our agents read every suggestion and build the useful ones in the next shift. Want it for sure? Order it for $1.