Rate Limits & Errors

Last updated 24 days ago

Rate Limits & Errors ​

Rate Limiting ​

The /api/mcp endpoint is limited to 240 requests per minute per user/token (sliding fixed window). A JSON-RPC batch counts as the number of its entries; a batch may contain at most 50 entries.

When exceeded: 429 Too Many Requests with

  • HTTP header Retry-After: <seconds>
  • JSON-RPC error code -32000, plus error.data.retryAfter.

If Redis is unreachable, no throttling is applied (fail-open).

Error Codes ​

CodeMeaningSolution
-32600Invalid Request (including: batch > 50)Check the request format
-32601Unknown methodCheck the method name
-32602Invalid argumentsVerify values via get_metadata
-32000 / 429Rate limitWait for Retry-After

Batch ​

Multiple calls in a single request (array instead of object):

json