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

# MCP limits and errors

> Row caps, result page sizes, rate limits and the error codes OrbiSearch MCP tools return.

## Limits

| Limit | Value |
| - | - |
| Rows per bulk job | 1 to 1,000. For larger lists, use the dashboard or the [API](https://orbisearch.com/docs/guides/bulk-verification.md). |
| Rows per results page | Up to 100. A page can come back shorter if its rows are large; follow `next_offset`. |
| Rate limits | The same per-account limits as the API, shared between your API keys and your connected apps. |

## Errors

A tool that fails returns an error result with a `code` and a plain-language `message`. Rate-limit errors also carry `retry_after_s`.

| Code | Meaning | Charged |
| - | - | - |
| `insufficient_credits` | Not enough credits for the call or job | No |
| `rate_limited` | Too many requests at once | No |
| `daily_quota_exceeded` | The free spam check's daily limit is used up | No |
| `monthly_quota_exceeded` | The unlimited plan's monthly search limit is used up | No |
| `bulk_searches_limited` | The unlimited plan's daily bulk search limit is used up | No |
| `subscription_inactive` | The app is set to use an unlimited plan that is not active | No |
| `invalid_input` | An input is missing or not valid; the message names the field | No |
| `too_many_rows` | A bulk job has more than 1,000 rows | No |
| `job_not_found` | No bulk job with that ID on your account | No |
| `job_not_ready` | The job's results are not ready yet | No |
| `timeout` | The validation, email search or enrichment took too long and was stopped | No |
| `temporarily_unavailable` | A temporary problem stopped the validation, email search or enrichment | No |
| `service_unavailable` | The tool is unavailable right now | No |
| `internal_error` | Something went wrong on our side | Not guaranteed |

If your sign-in has expired, the app is asked to sign in again instead of getting a tool error.


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