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

# Errors and limits

> Public MCP error codes, likely causes, and safe recovery steps.

| Code                        | Meaning                                                           | What to do                                             |
| --------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------ |
| `UNAUTHORIZED`              | Authentication is missing or invalid.                             | Reconnect OAuth or replace the API key.                |
| `INVALID_INPUT`             | Tool arguments do not match the schema.                           | Correct the filters and retry.                         |
| `INVALID_CURSOR`            | The cursor is malformed, expired, or used with different filters. | Restart the search or restore the original filters.    |
| `REQUEST_TOO_LARGE`         | The MCP request body is too large.                                | Remove unnecessary context or arguments.               |
| `RATE_LIMITED`              | The credential or service exceeded its short-term request limit.  | Wait and retry with backoff.                           |
| `CONCURRENCY_LIMITED`       | Too many searches are running at once.                            | Wait for an active request to finish.                  |
| `INSUFFICIENT_CREDITS`      | No active credits remain.                                         | Check Usage and contact Superdata support.             |
| `REQUEST_IN_PROGRESS`       | The same metered request is already pending or complete.          | Wait for the first response; do not submit duplicates. |
| `PROVIDER_TIMEOUT`          | The search exceeded its deadline.                                 | Narrow the filters and retry.                          |
| `PROVIDER_UNAVAILABLE`      | Superdata could not complete provider work.                       | Retry shortly; contact support if it persists.         |
| `PROVIDER_BUDGET_EXHAUSTED` | A service-level safety budget has been reached.                   | Retry later.                                           |
| `INTERNAL_ERROR`            | An unexpected safe server error occurred.                         | Retry once, then contact support.                      |

## Limits

* Result limit: 1–50 per page
* Filter terms: up to 10 values per list
* Filter text: up to 120 characters per term
* Cursor: up to 512 characters
* Requests are subject to credential rate, global rate, concurrency, body-size,
  provider-budget, and execution-deadline controls

Exact operational thresholds can change to protect service reliability.