Skip to main content
Every error is an RFC 9457 problem document with the content type application/problem+json. Branch on code. Do not parse detail.

Shape

string
A URL that ends in the error code, or in the status when there is no code.
string
A short name for the status: Bad request, Unauthorized, Not enough credits, Forbidden, Not found, Conflict, Request too large, Unprocessable, Too many requests, Service unavailable, Timed out, Server error.
number
The HTTP status.
string
The stable, machine-readable code. Present on every error listed below. It can be missing on an error with no specific cause, such as an unknown path.
string
What went wrong and what to do, in plain words.
string
The ID of this request. Quote it when you report a problem. The same value is in the X-Request-Id response header of every response.
Some codes add fields: A 401 also carries a WWW-Authenticate header when sign-in is available.

Error codes

Client-side codes

The MCP server and the CLI refuse some calls on your machine before anything is sent. These carry "sent": false and are never charged. The MCP server and the CLI print errors as error, status, message, fix and request_id, where error is the code above.

Results that are not errors

A 200 answer can still say that less was done than you asked. These are fields in a successful answer, not error codes. You are charged only for what was delivered, and cost.charged_credits says how much.

stopped_early

find and discover set stopped_early when the search stopped at one of Agentic ID’s own limits on paid sources. The summary says the same in a sentence. Nothing is charged for what was not delivered.

Other partial results