Skip to content

validation: Invalid input

The request cannot succeed as sent. Retrying the same call will fail the same way.

Results in this category have isError: true, start with [ouncemcp] Invalid input:, and carry _meta.ouncemcp.category = "validation" and retryable = false.

Code (_meta.ouncemcp.error) Cause Fix
invalid_input Arguments do not match the tool's input schema. The message lists up to three fields and how to fix each, without repeating the values sent. Fix the named fields and call again.
request_too_large The arguments are larger than Limits.max_request_bytes. Send less data, or raise the limit on the server.
request_too_deep The arguments are nested deeper than Limits.max_depth. Flatten the input.
invalid_cursor A pagination cursor was malformed, expired, modified, or issued for another tool, caller or set of filters. reason says which. Pass next_cursor back unchanged, or omit cursor to start over.
invalid_state A handle, approval or continuation token was malformed, expired, replayed, or issued to another caller or for another request (spec SEC-6). reason is not exposed to keep tokens opaque; the message says what to do. Start the operation again to get a new token.
result_too_large Even the smallest valid result is over the tool's result budget. reason is item_over_budget, min_items_over_budget or fixed_over_budget. Narrow the request, lower limit when the message suggests it, or use response_format=concise. Server authors: raise result_tokens or return smaller items.
upstream_rejected_input The upstream service answered 400 or 422. Check the arguments against the tool description.
idempotency_key_reused A client idempotency key was sent again with different arguments. Use a new key for a different request.
url_not_allowed The URL uses a scheme that is not allowed, names a metadata host, is not on the allowlist, or resolves to a loopback, private or link-local address. Use a public http or https address.
validation A handler raised InvalidInput without a code. Follow the message.

See proposal 0007 for how errors are classified.