Everything the Agent Card spec does not say out loud.

Practical A2A guides, reviewed against release 1.0.1, with a comparison of MCP revision 2026-07-28.

Generate an Agent CardValidate one you have

Featured Guide

Security

Signed Agent Cards: preventing poisoning with JWS

Protect A2A v1.0 Agent Cards from tampering and impersonation using JWS signatures in the signatures array, complete with a verified signing example.

11 min read

All Guides & Technical Explainers

Architecture

Unified agent architectures: A2A and MCP under the AAIF

Discover how MCP and A2A now sit under the Linux Foundation's AAIF as a dual-layer architecture, pairing tool access with cross-framework agent discovery.

10 min read
Ecosystem

A2A x402 extension: pay-per-call monetisation for AI agents

Learn how the A2A x402 extension lets agents declare payment support in Agent Cards and charge for skills with on-chain stablecoin payments.

9 min read
Comparison

A2A vs MCP: what changed in 2026

Compare A2A 1.0.1 and MCP 2026-07-28: discovery, stateless requests, task extensions, version negotiation, and Agent Card publishing.

5 min read
How-to

How to create an agent-card.json file for A2A v1.0

Create an agent-card.json (agent.json) file for A2A v1.0: required Agent Card fields, well-known discovery URLs, response headers, and common mistakes.

11 min read
Integration

Publishing an Agent Card from ADK, LangGraph, or CrewAI

Learn how to publish an A2A Agent Card from Google ADK, LangGraph, CrewAI, or Semantic Kernel by mapping framework concepts to standard discovery fields.

10 min read
Troubleshooting

Agent Card validation errors explained, one by one

Diagnose every A2A v1.0 Agent Card validation error and warning, understand what triggers it, and apply the exact fix in validator check order.

12 min read
Protocol

What A2A v1.0 changed in the Agent Card

Learn how A2A v1.0 changes Agent Cards, from supportedInterfaces and securityRequirements to removed fields, with practical v0.3 migration examples.

9 min read