JSON-RPC
Eintrag zuletzt aktualisiert am: 11.09.2026
JSON-
RPC ist ein schlankes Protokoll für
Remote Procedure Calls mit
JSON als
Datenformat: Ein Client ruft über eine Nachricht eine Funktion auf einem Server auf und erhält bei Bedarf eine Antwort. Die aktuelle Spezifikation ist
JSON-
RPC 2.0.
JSON-
RPC definiert nur Nachrichtenformat und Bedeutung der Felder, nicht den Transportweg. Es kann über
HTTP, WebSocket, Standard-Ein-/Ausgabe (STDIO) oder andere bidirektionale Kanäle laufen.
Im Unterschied zu
REST steht nicht eine Ressource wie /flights/4711 im Vordergrund, sondern ein
Methodenaufruf wie getFlightDetails.
Moderne KI-Protokolle wie
MCP,
ACP und
A2A basieren auf
JSON-
RPC 2.0 als Protokollgrundlage, ergänzen es aber um eigene
Methoden und Regeln, etwa initialize, tools/list und tools/call.
Beispiel JSON-RPCEine JSON-RPC-Anfrage enthält:
{
"jsonrpc": "2.0",
"method": "getFlightDetails",
"params": {
"flightNo": 4711
},
"id": 42
}
jsonrpc: Muss den Wert "2.0" haben.
Method: Name der aufzurufenden Methode.
Params: Optionale Argumente, entweder als Objekt (benannte Parameter) oder Array (positionale Parameter).
Id: Kennung zur Zuordnung von Antwort und Anfrage.
Die zugehörige Erfolgsmeldung lautet beispielsweise:
{
"jsonrpc": "2.0",
"result": {
"flightNo": 4711,
"destination": "Berlin"
},
"id": 42
}
Bei einem Fehler liefert der Server statt result ein error-Objekt:
{
"jsonrpc": "2.0",
"error": {
"code": -32601,
"message": "Method not found"
},
"id": 42
}
Standardisierte Fehlercodes sind unter anderem:
Code Bedeutung
-32700 : JSON konnte nicht geparst werden
-32600 : Ungültige Anfrage
-32601: Methode existiert nicht
-32602 : Ungültige Parameter
-32603 : Interner Serverfehler
Eine Notification ist ein Methodenaufruf ohne id. Der Server darf dafür keine Antwort senden:
{
"jsonrpc": "2.0",
"method": "progress",
"params": { "percent": 50 }
}