MCP tools/list pagination (nextCursor) not followed — tools silently truncated
Resolved 💬 3 comments Opened Apr 14, 2026 by cdapprich-bt Closed Apr 14, 2026
Summary
Claude Code does not follow nextCursor pagination when calling tools/list on MCP servers. Only the first page of tools is fetched; the nextCursor in the response is silently ignored. Tools beyond the first page are completely invisible and uncallable.
Reproduction
- Connect Claude Code to an MCP server (HTTP transport) that exposes more tools than fit in a single
tools/listresponse page - Manually verify the server's full tool count by following
nextCursorpagination viacurl(or MCP Inspector) - Start a fresh Claude Code session and count the tools it registers from that server
Result: Claude Code only registers tools from the first page. It sends a single tools/list request, receives tools + a nextCursor, and never sends a follow-up request. All tools on subsequent pages are silently dropped with no warning.
Expected Behavior
Per the MCP Specification:
Clients SHOULD support both paginated and non-paginated flows for all list endpoints.
Claude Code should follow the cursor until nextCursor is null:
cursor = None
all_tools = []
while True:
response = tools/list(cursor)
all_tools.extend(response.tools)
if not response.nextCursor:
break
cursor = response.nextCursor
Impact
- Silent data loss: Users see a subset of tools with no warning that more exist
- Breaks MCP gateways: Gateways aggregating tools from multiple backend servers commonly paginate — this is a standard enterprise pattern
- No client-side workaround: Users cannot configure Claude Code to fetch more tools; the only workaround is modifying the server to disable pagination, which isn't always possible
Environment
- Claude Code CLI (latest)
- Windows 11
- MCP server connected via HTTP transport
Prior Issues
- #24785 — Detailed repro with AWS Bedrock AgentCore Gateway, closed by stale bot as "not planned," now locked
- #8237 — Feature request with screenshots, self-closed by author, now locked
- #3141 — Resources pagination, auto-closed for inactivity, now locked
None of these were resolved. The bug persists as of April 2026.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗