Limits & Scopes
Rate limits, scopes, and consent grants in detail.
Rate limits
Limits are counted per account, across every app and key it uses, not per key.
| Tools | Calls per minute, per tool |
|---|---|
| Reads | 60 |
| Writes: logging, profile, documents, devices, Inbox replies, Programs | 10 |
Money and appointments: purchases, bookings, confirm_action, confirm_post | 5 |
On top of that, all tools together are limited per hour. A call over a limit comes back as a tool error saying so; wait and retry.
Scopes
Every MCP tool needs one scope, such as health:read, log:write or purchases. An app connected by signing in holds the scopes you accepted on the consent screen; a key holds the scopes chosen when it was created, or all of them when none were chosen. The full list is in Permissions.
Give an agent the fewest scopes it needs. Wider isn't better.
Higher limits
For higher volumes, talk to sales.
Best practices
- One key per agent / environment — easier to rotate and revoke
- Read-only keys for analytics / dashboards
- Write keys only on the surfaces that need them
- Rotate keys every 90 days even when not compromised

