Token Limits for `list-items`

[marcohamersma]

I'd like to be able to query list-items with file: queries, but I'm running into the maximum token issues for Claude Code with no way of limiting the response.

Error: MCP tool "list-items" response (56511 tokens) exceeds 
     maximum allowed tokens (25000). Please use pagination, filtering, 
     or limit parameters to reduce the response size.

I noticed there was some recent work to limit the token count for the item-details query, so it would be great to have a functionality to limit the amount of details for list-items as well. One can always use get-item-details to get more info on an occurrence.

This is what I'm hoping for

• A way of limiting the detail of the results so token limits are respected
• a Limit parameter to limit amount of search results
• ideally, also a sort parameter

Thanks for this useful tool, and I hope you can integrate some or all of this feedback.

Best,
Marco

[brianr]

Thank you for the issue, @marcohamersma , will look into options to solve this.

[philippemoro]

I encountered the same issue and, after some investigation, found that explicitly sending a limit parameter in the requests to this endpoint resolves the problem. You can also reduce the limit value and use pagination if you’d like to decrease the response size even further.

I’ve opened a pull request with the proposed fix here: #56