Read cached MCP response slice
cascade_read_responseRetrieve a chunk of a long MCP response using a cached handle. Continue reading from a given offset or specify a byte range to fetch targeted data.
Instructions
Retrieve a slice of a cached MCP response by handle (cascade_read_response).
When a Cascade tool response exceeds the MCP character budget, the server caches the complete payload and returns a handle in structuredContent._cache.handle plus a preview in the text block. Use cascade_read_response to fetch the rest — either the remainder in chunks, or a targeted byte range if you know the structure.
Args:
handle (string, required): The handle returned by a prior tool call's structuredContent._cache.handle (e.g. "h_550e8400-...").
offset (number, optional, default 0): Byte offset within the full rendered response. Use the originating call's bytes_returned as the next offset, or structuredContent._cache.next_offset when iterating.
length (number, optional, default 25000): Max characters to return in this slice. Capped at 25000.
Returns: { success: true, handle: "", bytes_total: , offset: , bytes_returned: , slice_text: "", has_more: , next_offset: <offset to use next, if has_more> } The same JSON object is returned in content[0].text and structuredContent; slice_text contains the response slice.
Examples:
Continue reading: { handle: "h_abc...", offset: 20000 }
Specific byte range: { handle: "h_abc...", offset: 50000, length: 10000 }
Don't use when: The originating response fit under the limit (no handle was minted).
Don't use when: The handle is older than 50 oversize responses back (LRU-evicted); re-run the originating tool.
Error Handling:
"Handle not found" — the handle was evicted (cache holds the last 50 oversize responses) or never existed. Re-run the originating tool. Responses are JSON text; structuredContent is authoritative when the response fits. Oversized responses return bounded _cache metadata for cascade_read_response. For cascade_read, read_mode controls preview versus raw Cascade payload shape.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| handle | No | REQUIRED: Response handle returned by a previous oversize tool call. Found in structuredContent._cache.handle (e.g. 'h_550e8400-e29b-41d4-a716-446655440000'). | |
| offset | No | Byte offset to start the slice. Default 0. Use the previous call's next_offset to continue iterating. | |
| length | No | Maximum characters to return in this slice. Default and max 25000. Smaller slices are fine; iterate via next_offset. |