Designing MCP paginated tools so agents don't treat one page as the full dataset

Normal_Succotash_520 · reddit · 2026-09-16

A Reddit discussion on response design for paginated search tools exposed via MCP: when a user asks for all overdue invoices and the tool returns 50 matches plus a nextcursor, a summary can sound reasonable while silently missing the rest; returning everything floods the context.

One proposed design: return items + nextcursor + an explicit complete: false, with a separate aggregation tool for totals; alternatively the client could block a final "all invoices" answer while a cursor remains, at the cost of tighter client-tool coupling.

Questions for practitioners: is a clear response schema enough, or must completion be enforced outside the model — especially for queries too large to finish within the call budget without passing off partial results as exhaustive?

Original post →

More from coding & agent

coding & agent channel →