Skip to main content
Every tool on the Allocait MCP server returns errors in one format:
The message is written for the agent and usually ends with the next step: a tool to call, or something to ask the user. What the agent tells the user is up to the agent. Every tool error carries one of the 19 codes below. The same codes come back from the REST API, and ChatGPT and Codex get them too: see ChatGPT errors.

​
Find your code

ACCESS_CHECK_FAILED and the rate limit are not among the 19 tool error codes. They happen before a tool runs.

​
Fields in the result

The tool result also carries structured fields that an agent can branch on:

​
What to do in general

​
If you’re the agent

  • Tell the user in plain words what went wrong; the message text is written for you.
  • For PRICES_INCOMPLETE, ask the user for the prices of exactly the symbols named, or use a price source they trust, then call again. With neither, say there is no result. Don’t guess at what’s missing.
  • For CONFIRMATION_REQUIRED, confirm with the user before you resend with remove or confirm_name.
  • For RULES_INVALID, fix every issue listed before retrying: a partial fix still fails.
  • For a rate limit, wait the Retry-After interval, then retry the same call.
  • For check_trades, treat any error as no result: say so, and don’t work out the answer by hand.
  • For INTERNAL_ERROR, retry once. For a connected app’s 401, connect again. For ACCESS_CHECK_FAILED, retry.
  • For anything else, treat it as a stop: don’t retry the same call unchanged.
  • Send send_feedback only when the user asks, and leave holdings and account data out of it.

​
If you’re the user

  • If a call needs Read and change access, change it for an app in Settings > Apps or for an API key in Settings > API keys. If the result says “This account’s agent access is read-only.”, changing it doesn’t help. See Access levels.
  • If a connected app stops working with a 401, remove the Allocait connector in Claude and add it again.
  • If a tool or its description behaves in a way these pages don’t explain, ask Claude to report it with send_feedback and topic: tools. To report how a whole task went, ask for topic: early_access. See Send feedback and Support.

REST API errors

The same codes over HTTP.

MCP tools

Every tool at a glance.