> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rippit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate limits

> The request limits on the Rippit MCP server and the Bulk API, what a caller sees when it reaches one, and how to retry.

Limits are per user on the MCP server and per workspace on the Bulk API. A request over a limit is rejected before it runs, so retrying it later is always safe.

## MCP server

| Limit | Value |
| - | - |
| Requests | 60 a second per user |

MCP results carry no HTTP headers, so a tool call over the limit comes back as an error result instead. Its text says the call was rate limited with status `429`. Wait a second and call the tool again.

Tools that start long-running work, such as `enrich_worksheet`, return a job id right away. Read the job's status with its status tool every few seconds instead of in a tight loop.

## Bulk API

These are the free tier limits, counted per workspace.

| Limit | Free tier |
| - | - |
| Uploads | 10 a minute, 100 an hour, 100 a day |
| Uploads in total | 10,000 |
| Upload file size | 128 MB |
| Exports | 20 an hour, 100 a day |
| Export volume | 10 GB an hour |

Only uploads that were completed count toward the upload limits. One upload carries a whole file, so 100 uploads a day is up to 12.8 GB.

Need more? Contact your Rippit point of contact, or ask in the [Rippit Community](https://docs.rippit.com/community), and we can raise them for your workspace.

### When you reach a limit

The request returns `429` with a `Retry-After` header that gives the number of seconds to wait:

```http theme={null}
HTTP/1.1 429 Too Many Requests
Retry-After: 60

{"detail": "Upload limit reached: max_minute = 10"}
```

`Retry-After` is the only rate limit header the Bulk API sends. There are no `X-RateLimit-*` headers, so a script cannot read how much of a limit is left before it reaches it. The total upload limit does not reset, so its `429` has no `Retry-After`; ask us to raise it.

```python theme={null}
import time, requests

def call(method, url, **kwargs):
    while True:
        r = requests.request(method, url, **kwargs)
        if r.status_code != 429 or "Retry-After" not in r.headers:
            return r
        time.sleep(int(r.headers["Retry-After"]))
```

A `429` is returned before anything is written, so retrying after one never duplicates data. See [Idempotency and retries](https://docs.rippit.com/api-reference/idempotency.md).

## Other limits

* [Pipeline rules and limits](https://docs.rippit.com/pipelines/reference.md#limits) covers test samples, agent runs, and search results.
* [Errors](https://docs.rippit.com/api-reference/errors.md) lists every status the MCP server and the Bulk API return.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.