MCPA2A.dev / Errors
A2A v1.0.1 Validation & Task Error Reference
Diagnose Agent Card schema rejections, canonicalization drift, and peer-agent task errors.
Common Validation & Runtime Errors
| Code | Category | Cause | Resolution |
|---|---|---|---|
A2A-CARD-01 | Schema | Missing required top-level field (name, url, version, skills) | Populate all mandatory v1.0.1 fields and re-run validator. |
A2A-CARD-02 | Security | Non-HTTPS url endpoint in production card | Serve A2A endpoint over TLS 1.3 with HSTS enabled. |
JCS-DRIFT-01 | Integrity | Digest mismatch between publisher and verifier | Canonicalize via RFC 8785 (sorted UTF-16 keys, zero whitespace) before SHA-256 hashing. |
-32001 | Task API | TaskNotFoundError — unknown or expired task ID | Return deterministic 404/task-expired error; avoid leaking cross-tenant IDs. |
-32004 | Task API | UnsupportedOperationError — streaming/push requested when false | Respect capabilities.streaming and capabilities.pushNotifications flags. |
Interoperability Cluster
Validate upstream MCP 2026-07-28 tool manifests on modelcontextpro.dev →