Errors

Errors are RFC 9457 problem details, served as application/problem+json. Branch on code, which is stable within a version. Show detail to people; it is written for them.

{
  "type": "https://docs.acquestor.com/problems/deal_access_off",
  "title": "Not allowed",
  "status": 403,
  "code": "deal_access_off",
  "detail": "Outside AI access is off for your deals. Turn it on for one deal on acquestor.com and pick this client.",
  "instance": "…"
}

Every error response carries Acquestor-Credits-Charged: 0. An error never charges.

On the MCP server, an error comes back as a tool result with isError: true. Its text is detail, plus "Nothing ran and nothing was charged." on a 402, and the problem object is in structuredContent. A call missing a required argument fails the tool's input schema before it runs, and the error names the field:

"missing_input: The call needs capex_reserve; Acquestor never fills a required input with a default it can't source. Missing: capex_reserve. Retrying the same call unchanged will fail the same way. Request ID req_90b048ce0c7a4c60b6dffbf242a06f4b."

Codes#