MCP tool calls count against the first three limits too. The
send_invoice tool uses the 10-per-hour bucket for confirmed sends; its preview call (no confirmation_token) only counts as an ordinary request. Over the 300-per-minute MCP limit, /mcp answers 429 with Retry-After. With OAuth, “API key” means the connected app.
Every authenticated response includes these headers for the key’s bucket:
Handle a 429
Over a limit, you get429 rate_limited with a Retry-After header in seconds. Wait that long, then retry with the same Idempotency-Key.
Retry-After is 60 seconds or less. For longer waits they raise RateLimitError with retryAfter (Node.js) or retry_after (Python).
Stay under the limits
- Use
limit=100on list endpoints. - Use webhooks or the
GET /invoices?status=...filters instead of polling single invoices. - Spread large email batches over several hours.