Document server-side pagination limit in README

The maximum effective page size for paginated tools is determined by
the Gitea server's [api].MAX_RESPONSE_ITEMS setting (default: 50).
Requesting a perPage value higher than this limit will be silently
capped by the server.

Fixes: https://gitea.com/gitea/gitea-mcp/issues/165
Co-Authored-By: Claude (claude-opus-4-6) <noreply@anthropic.com>
This commit is contained in:
silverwind
2026-03-26 08:06:32 +01:00
parent a5dd03c7f0
commit aa75d47ead
3 changed files with 11 additions and 2 deletions

View File

@@ -166,6 +166,9 @@ To configure the MCP server for Gitea, add the following to your MCP configurati
> You can provide your Gitea host and access token either as command-line arguments or environment variables.
> Command-line arguments have the highest priority
> [!NOTE]
> Many tools support `page` and `perPage` parameters for pagination. The maximum effective page size is determined by the Gitea server's `[api].MAX_RESPONSE_ITEMS` setting (default: **50**). Requesting a `perPage` value higher than this limit will be silently capped by the server.
Once everything is set up, try typing the following in your MCP-compatible chatbox:
```text