> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# MCP server: large reads return results in pages

Five MCP server reads now return their results in pages. A large AI Agent configuration no longer arrives as one response that an assistant cannot read in full.

## Which reads are paged

These reads are paged by size:

* [`get_ada_configuration`](/mcp/tools/get-ada-configuration)
* [`get_test_cases`](/mcp/tools/get-test-cases), when it lists test cases
* [`get_test_runs`](/mcp/tools/get-test-runs), for a single run fetched by `test_run_id`
* [`list_entities`](/mcp/tools/list-entities) with `entity_type='variables'`
* [`list_entities`](/mcp/tools/list-entities), for a version 2 playbook fetched by `entity_id`

## How to page

Each paged response has `next_cursor` and `total_count`. If `next_cursor` is not `null`, the assistant passes it back as `cursor` to get the next page. An assistant reads every page before it answers a question about the whole set. `get_test_cases` and the `variables` list also accept `limit`. The `variables` list accepts `name_filter` and `scope`. With `group_by_last_run` set to `true`, `get_test_cases` now returns one list sorted by last run, newest first, with `last_run_at` on each case. It no longer groups the cases by date.