Errors and limits

Code	Meaning	What to do
`UNAUTHORIZED`	Authentication is missing or invalid.	Reconnect OAuth or replace the API key.
`INVALID_REQUEST`	The operation, path values, query values, body, or mutation confirmation is invalid.	Inspect the capability again and correct the request.
`REQUEST_TOO_LARGE`	The MCP request body exceeds the service limit.	Remove unnecessary arguments or reduce the body.
`RATE_LIMITED`	The credential or service exceeded its short-term request limit.	Wait and retry with backoff.
`CONCURRENCY_LIMITED`	Too many requests are running at once.	Wait for an active request to finish.
`INSUFFICIENT_CREDITS`	No active credits remain.	Check Usage and contact Superdata support.
`DUPLICATE_REQUEST`	The same metered protocol request is pending or already completed.	Wait for the first response; do not submit duplicates.
`REQUEST_TIMEOUT`	Intelligence execution exceeded its deadline.	Reduce the scope or response size and retry.
`UPSTREAM_RATE_LIMITED`	The intelligence provider returned HTTP 429.	Wait and retry with backoff.
`UPSTREAM_REQUEST_FAILED`	The intelligence provider rejected or failed the operation.	Check the optional upstream status, then correct or retry the request.
`INTERNAL_ERROR`	An unexpected safe server error occurred.	Retry once, then contact support.

Limits

Capability query: up to 500 characters
Capability search results: 1–50; defaults to 15
Execution response limit: 1,024–1,000,000 bytes; defaults to 250,000
Path values: strings or numbers
Query values: strings, numbers, booleans, null, or arrays of scalar values
Requests are subject to credential rate, global rate, concurrency, body-size, provider, and execution-deadline controls

Exact operational thresholds can change to protect service reliability.