Skip to main content
Every refusal is the same shape, with the status that matches its code:
The message is a plain sentence a person can act on, and it often names the call to make first. Read it before you try anything else, and tell the person when it’s theirs to answer.

How to answer one

  1. Read code and message. The code says what kind of refusal it is; the message says what to do.
  2. Don’t ask again unchanged. A 400, 403, 404 or 409 answers the same until something changes: fix the request, or do what the message says first.
  3. Wait on a 429. Wait the seconds Retry-After gives, then carry on.
  4. Try a 500 once more after a minute. If it goes on, stop and say what you asked and when.
  5. Through the MCP server, a refusal is the tool’s answer, marked as an error, with the same sentence.