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

# Pagination and large results

> Page Meridian results without accidental continuation or oversized agent responses.

## Context Query mode

For broad historical requests, use `responseShape="evidence_only"` and request `includeDataUrl`. Context can keep large datasets outside the agent's context window while returning bounded evidence and a durable data reference.

If a query becomes an asynchronous job, poll the returned `jobId`. Do not submit the original query again.

## Custom bars

`custom_bars` accepts:

```text theme={null}
limit: 1 to 10,000 rows
cursor: integer offset encoded as a string
```

The MCP method defaults `return_next_cursor` to false so a request such as `limit: 5` remains exactly one five-row page. Set it to true only when the caller explicitly wants pagination information.

`custom_bars_catalog` supports up to 5,000 entries per page.

## Safe historical access

* Request only the columns needed for the calculation.
* Split very broad histories into deterministic time windows.
* Preserve the exchange, product, resolution, and interval in every output artifact.
* Do not automatically follow cursors from an LLM unless the user requested all pages.