A2A JSON-RPC vs gRPC vs REST: What Differs Between the Three Bindings
The three A2A protocol bindings (JSON-RPC, gRPC, HTTP+JSON/REST): what the specification keeps identical, what differs on the wire, and an inference-labelled guide to picking one.
- A2A v1.0 defines three protocol bindings, JSON-RPC, gRPC and HTTP+JSON/REST, and an agent that offers more than one of them must keep their behavior aligned under the specification.
- Equivalence in A2A means the same operations and capabilities, semantically equivalent results and consistent protocol-specific error mapping, so the specification requires the same operations and results across bindings while the wire format and the streaming exposure still differ.
- Real-world usage share across the A2A bindings could not be confirmed from any source found when the ChangeGamer corpus was verified in October 2026, because the specification mandates equivalence, not adoption reporting.
- A2A is not JSON-RPC only: an A2A agent may publish a gRPC or an HTTP+JSON/REST interface, and the HTTP+JSON binding uses the application/a2a+json media type.
- Which A2A binding to pick is, as inference, a question about the infrastructure you already operate, since the specification keeps the capabilities the same across all three.
The three A2A bindings are JSON-RPC, gRPC and HTTP+JSON/REST, and what separates them is mainly the wire format (inference from the equivalence rule). The A2A protocol reference (updated 27 October 2026) lists them; the pillar covers the protocol overall. Here the angle is narrower: what the specification holds constant, what moves, and how to choose. Authentication per binding is a separate topic (A2A authentication schemes) and is not covered.
A2A keeps the capability set constant: v1.0 obliges any agent that offers several bindings to keep them aligned. The MCP vs A2A reference attributes the rule to the specification's binding sections and splits it into three parts:
- the same operations and capabilities;
- semantically equivalent results;
- consistent protocol-specific error mapping.
Two limits apply. The rule is conditional: it constrains an agent that offers several bindings, and the reference does not say an agent must offer all three. And it is a mandate, not a measurement; the reference does not say how closely deployed agents honor it.
The MCP vs A2A comparison table lists A2A's message format as JSON-RPC 2.0, unqualified. Read it alongside its own transport row, which lists all three bindings, and with the equivalence rule above: that row describes the JSON-RPC binding and, as inference, is not a limit on A2A. As inference, a client that assumes every A2A agent speaks JSON-RPC would fail against an agent that publishes only gRPC.
The bindings differ in transport, in how operations are named, and in how streaming is exposed, and the reference records some of each. As of 2 November 2026, this is what the corpus supports:
| Binding | Transport and encoding | How an operation is named | Streaming |
|---|---|---|---|
| JSON-RPC | JSON-RPC 2.0 | Method names in PascalCase, such as SendMessage |
Server-Sent Events, per the reference |
| HTTP+JSON/REST | HTTP with application/a2a+json bodies |
Resource paths and verbs, such as POST /message:send |
The reference does not say |
| gRPC | Protocol Buffers v3 over HTTP/2 with TLS | Service A2AService (normative) |
The reference does not say |
The reference lists 7 of the 11 operations for JSON-RPC and for HTTP+JSON; the four push-notification config operations are not listed in either spelling set, and it gives no per-operation spellings for gRPC. Do not assume the full set is identical in every binding. Check the specification for the operation you need, and for any binding you plan to expose, confirm the exact spelling of each operation against the version named in your A2A-Version header before you generate client code from it.
HTTP+JSON/REST is the reference's single name for the third binding, whose operations are resource paths such as GET /tasks/{id}. This article writes "HTTP+JSON" for short and means the same binding; the reference does not explain the slash. A custom binding is also allowed; the reference does not describe how one is defined.
Two strings are worth hard-coding carefully: the A2A-Version header and the application/a2a+json media type. Clients send A2A-Version in the form Major.Minor, or as a request parameter of the same name, and servers answer VersionNotSupportedError for versions they do not support. An empty header value is interpreted as 0.3, so check that your client never sends one. Patch numbers are not negotiated.
The v1.0.1 patch (28 May 2026) prefers application/a2a+json in the HTTP binding. The reference does not say whether the header applies identically to gRPC, so verify that against the specification before relying on it.
For older material, the v0.3.0 release (30 July 2025) is the release whose JSON-RPC spellings older documentation shows as message/send and message/stream; migration is covered in the v0.3 to v1.0 migration.
Pick the binding your existing infrastructure already runs, because the specification keeps capabilities equal across all three. Every row below is inference, each with a one-line reason; none comes from the reference.
| Situation | Pick (inference) | Reason (inference) |
|---|---|---|
| You already run gRPC services and control both ends | gRPC | Reuses the stack and tooling you operate |
| Third parties call you through a public gateway | HTTP+JSON | Fits HTTP infrastructure that already inspects and routes requests |
| Your framework or SDK already speaks JSON-RPC, as MCP does | JSON-RPC | Reuses client code your team knows |
| You do not know your callers yet | One binding you can operate | Equivalence lets you add a second later when a real client needs it |
If you do publish two, test both against the same fixture. The equivalence rule is the specification's promise, and (inference) your implementation is the most likely place it can fail. Whichever you choose, list it in the Agent Card; the Agent Card design article covers the interface fields, and the task lifecycle article covers the operations themselves.
No. As of 2 November 2026, a grep for SendMessage, message:send, A2AService, grpc and agent-card across changegamer/src/pages, src/lib, src/layouts, src/components, worker/ and public/ returns zero matches. The site speaks MCP over JSON-RPC and implements no A2A endpoint, so the guidance above is reasoning from the reference, not from running a binding in production.
Frequently asked questions
- Is A2A only JSON-RPC?
- A2A is not JSON-RPC only: A2A v1.0 defines three bindings, JSON-RPC 2.0, gRPC and HTTP+JSON/REST, and also allows custom bindings. JSON-RPC is one way to reach the same operations, not the only one, according to the A2A reference in the ChangeGamer corpus.
- Do JSON-RPC, gRPC and REST give the same results in A2A?
- An A2A agent that publishes several bindings must return matching outcomes through each of them. The v1.0 specification states this as a requirement on operations, results and error mapping, and it is a rule in the specification, not a measurement of how deployed agents behave.
- Which A2A binding do most agents use?
- Which A2A binding most agents use could not be confirmed from any source found when the ChangeGamer corpus was verified in October 2026. The specification mandates behavioral equivalence, not adoption reporting, so treat any claim that one A2A binding dominates in production as unverified.
- What media type does the A2A HTTP+JSON binding use?
- The A2A HTTP+JSON binding uses application/a2a+json for its bodies, and the v1.0.1 patch released on 28 May 2026 prefers that media type, according to the A2A reference in the ChangeGamer corpus.
This guide is free and stays free. The reference corpus behind it — machine-readable contracts, verified primary sources, continuously refreshed — is the paid product: a €5 starter key unlocks every premium reference for one agent via API; a €25 corpus license delivers the full corpus as RAG / fine-tuning data with an explicit AI-use grant; the €150 enterprise license adds commercial redistribution rights.