Rate Limits & Fehler

Rate Limiting

Der /api/mcp-Endpunkt begrenzt auf 240 Requests pro Minute pro Benutzer/Token (gleitendes Fixed-Window). Ein JSON-RPC-Batch zählt mit der Anzahl seiner Einträge; ein Batch darf max. 50 Einträge haben.

Bei Überschreitung: 429 Too Many Requests mit

• HTTP-Header Retry-After: <Sekunden>
• JSON-RPC-Fehler code -32000, plus error.data.retryAfter.

Ist Redis nicht erreichbar, wird nicht gedrosselt (fail-open).

Fehlercodes

Code	Bedeutung	Lösung
-32600	Invalid Request (auch: Batch > 50)	Request-Form prüfen
-32601	Methode unbekannt	Methodenname prüfen
-32602	Ungültige Argumente	Werte via get_metadata prüfen
-32000 / 429	Rate-Limit	Retry-After abwarten

Batch

Mehrere Aufrufe in einem Request (Array statt Objekt):

[
  {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_me","arguments":{}}},
  {"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_my_open_items","arguments":{"compact":true}}}
]