Reference
Rate limits and quotas
Exact request, size, and expiry limits for anonymous, free-key, Pro, and Enterprise usage of the Pastepile API and MCP server.
1 min read · Updated
Limits are enforced by the REST API, so they apply identically to the MCP server, the CLI, and raw HTTP. These numbers are pinned by unit tests against the enforcing code, so this table cannot silently drift from reality.
Limits by plan
| Anonymous | Free key | Pro key | Enterprise | |
|---|---|---|---|---|
| Requests per minute | 30 | 30 | 120 | 600 |
| Paste creations per day | 500 | 500 | 2,000 | 10,000 |
| Max paste size | 2 MB | 2 MB | 25 MB | 100 MB |
| Expiry options | All, including never | Up to 1mo (see below) | All, including never | All, including never |
The never-expiry policy, precisely
- Anonymous saves (web app or keyless API) keep every expiry option, including
never. Persistence is never paywalled for anonymous use. - Free keys: a defaulted
neverfalls back to1mo, and the result says so inexpiry_note. An explicitnevererrors with an actionable message instead of being silently downgraded. - Pro and Enterprise keys:
neverworks as written, which is what makes permanent AI memory permanent.
Handling 429s
Rate-limited responses include Retry-After (seconds) and X-RateLimit-* headers. The error text is model-visible, so a well-behaved assistant waits and retries on its own; if you see sustained 429s, one API key per assistant keeps budgets independent.
Related documentation
AuthenticationThe Pastepile MCP server works anonymously, and an API key turns it into a private memory layer with per-key isolation and higher limits.Error referenceEvery error the Pastepile MCP server can surface: model-visible tool errors, JSON-RPC protocol faults, and the underlying REST statuses.pastepile_saveSave text, code, or notes to Pastepile and get back a stable, shareable URL plus a one-time edit key. The write path of durable AI memory.