DocsDevelopers
Rate limits
Requests per minute per key or connected app, and the RateLimit headers.
Each API key can make 120 requests every 60 seconds. Calls to the MCP server with the same key count against the same window; an app connected with OAuth has a window of its own.
Headers#
Every answer tells you where you stand:
| Header | Meaning |
|---|---|
RateLimit-Limit | Requests allowed in the window. |
RateLimit-Remaining | Requests left in the current window. |
RateLimit-Reset | Seconds until the window resets. |
Retry-After | On a 429 only: seconds to wait before retrying. |
When you hit the limit#
The answer is 429 with the code rate_limited. Wait for Retry-After seconds and retry. Spread batch work out rather than retrying in a tight loop.