413
Do not retryPayload too large — The request body itself exceeded the size the endpoint accepts.
Response body
{ "error": { "code": "payload_too_large", … } }
Should you retry?
No — the same request will fail the same way. Fix it first.
What it means
Read endpoints take query-string parameters, so this is rare outside batch-style requests with a large body.
Common causes
- A request body built programmatically that grew unexpectedly large.
- Too many values packed into a single parameter instead of paging.
How to fix it
Split the request into smaller pieces. This will not succeed by retrying unchanged.
Endpoints that return this
Read from the OpenAPI specification, so this list cannot claim an endpoint returns a status the contract does not list.
| Method | Endpoint | What it does |
|---|---|---|
| POST | /mcp | MCP server (JSON-RPC 2.0) |