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

# Limits and errors

What it cannot do, how to read the numbers, the limits, and what to do about errors.

## What it does not do

* Create, edit, publish or delete content.
* Recompute a chart or analytics for parameter values other than the published ones.
* Read content that is not published to Exploratory Server, such as projects that exist only in Exploratory Desktop. Use the separate [Desktop MCP](https://docs.exploratory.io/en/mcp/desktop) for those.

## Numbers and their conditions

* Numbers are the values as published.
* A chart published on its own returns only the first 100 rows of the data used to draw it. Do not add the rows up as a total.
* A viewer who changes parameters in the browser sees different results. MCP does not return those results.
* Each chart and analytics result states the conditions of its computation: the aggregation, the chart filters, context.parameters and context.data\_as\_of.
* query\_dataset returns dataset.version and dataset.updated\_at.

## Limits

| Item | Limit |
| - | - |
| query\_dataset: rows | Up to 1,000 rows (needs columns) |
| query\_dataset: aggregate | Up to 500 rows |
| dataframe\_preview, chart\_get\_data | Up to 100 rows per call |
| query\_dataset: queries | Up to 5 per call |
| chart\_query: queries | Up to 10 per call (the default; an on-premises server can change it) |
| Data items in a join | 2 to 5 |
| A metric alias | Starts with a letter or \_; ASCII letters, digits and \_ only. Japanese is not allowed |
| A dataset alias in a join | Lowercase, up to 16 characters |
| dataframe\_export | The link is valid for 15 minutes. One export at a time per user. The number of exports per hour is limited |
| A chart published on its own | The first 100 rows of the data used to draw it, not the values of the whole chart |

## Errors and what to do

A tool that fails returns a result with isError: true and a JSON body. The body has error\_code and message, and sometimes url and details. For a bad argument, details.field names the argument.

| error\_code | What to do |
| - | - |
| NOT\_FOUND | The content does not exist or you cannot view it. Open its URL in your browser and check whether the same account can view it. If not, ask the owner to check the sharing settings |
| CHANNEL\_DISABLED | The publisher turned off MCP access for this content. Ask the publisher to check the MCP access setting of the content |
| DATA\_EGRESS\_LIMIT | The publisher does not share the rows of this data. Use its charts, analytics or summary instead |
| PERSONALIZED\_CONTENT | The content shows different data to each viewer. Open its URL in the browser |
| CONTENT\_UPDATING | The content is being republished. Try again in a few seconds |
| UNSUPPORTED\_OPERATION | The content cannot be read this way (for example, data with no queryable source). Check which operations the content supports, and ask for a form it does support, such as its charts or summary |
| INVALID\_PARAMETER | Fix the argument named in details.field |
| RESULT\_TOO\_LARGE | The result is too large. Add filters, select fewer columns, or aggregate |
| SERVER\_BUSY | The server is busy, another export of yours is running, or you reached the hourly export limit. See below |

For SERVER\_BUSY:

* Try again in a few seconds.
* If it happens twice in a row, stop and try again later.
* For the hourly export limit, wait up to an hour.

query\_dataset reports a bad query differently. It returns error.code, error.message and error.field, with their own codes. For example:

* DATASET\_NOT\_FOUND
* ACCESS\_DENIED
* CHANNEL\_DISABLED
* DATASET\_ACCESS\_DENIED (joins)
* DATASET\_NOT\_QUERYABLE
* INVALID\_COLUMN
* INVALID\_FILTER
* AMBIGUOUS\_COLUMN
* JOIN\_TYPE\_MISMATCH
* QUERY\_LIMIT\_EXCEEDED
* QUERY\_TIMEOUT

When the query engine is busy, it returns RATE\_LIMIT\_EXCEEDED or QUERY\_ENGINE\_UNAVAILABLE. Try again in a few seconds. When result.has\_more is true, narrow the filters, aggregate, or use dataframe\_export.

dataframe\_export uses error\_code like the other tools. For a bad query, it returns INVALID\_PARAMETER. The query's own code is in details.code.

## Rate limit

If you send more than 120 requests in a minute, you get HTTP 429 with RATE\_LIMITED. Wait one minute.

If one address sends more than 30 refused API keys within 15 minutes (counted per IPv4 address, or per IPv6 /64 range), you get HTTP 429 with the message "Too many failed API key attempts. Try again later." A valid key is not counted. Fix the key and try again later.


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