MCPA2A.dev / Errors
DIAGNOSTICS · A2A ERROR CODES

A2A v1.0.1 Validation & Task Error Reference

Diagnose Agent Card schema rejections, canonicalization drift, and peer-agent task errors.

Common Validation & Runtime Errors

CodeCategoryCauseResolution
A2A-CARD-01SchemaMissing required top-level field (name, url, version, skills)Populate all mandatory v1.0.1 fields and re-run validator.
A2A-CARD-02SecurityNon-HTTPS url endpoint in production cardServe A2A endpoint over TLS 1.3 with HSTS enabled.
JCS-DRIFT-01IntegrityDigest mismatch between publisher and verifierCanonicalize via RFC 8785 (sorted UTF-16 keys, zero whitespace) before SHA-256 hashing.
-32001Task APITaskNotFoundError — unknown or expired task IDReturn deterministic 404/task-expired error; avoid leaking cross-tenant IDs.
-32004Task APIUnsupportedOperationError — streaming/push requested when falseRespect capabilities.streaming and capabilities.pushNotifications flags.

Interoperability Cluster

Validate upstream MCP 2026-07-28 tool manifests on modelcontextpro.dev →