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 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
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.
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.
- 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
