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

Code	Meaning	Solution
-32600	Invalid Request (including: batch > 50)	Check the request format
-32601	Unknown method	Check the method name
-32602	Invalid arguments	Verify values via get_metadata
-32000 / 429	Rate limit	Wait for Retry-After

Batch

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

[
  {"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}}}
]