USAGE_LIMIT_REACHED

What it means. This account has used what its plan and spending limit allow this month.

What to do. Nothing was built and nothing was charged. It works again at the start of next month, or sooner if the owner moves to a bigger plan or raises the spending limit in the dashboard. No code change will help.

  • HTTP status: 403
  • Retryable after applying the fix: no

Every failure from the CLI or an MCP tool has this shape:

{
  "ok": false,
  "code": "USAGE_LIMIT_REACHED",
  "message": "This account has used what its plan and spending limit allow this month.",
  "fix": "Nothing was built and nothing was charged. It works again at the start of next month, or sooner if the owner moves to a bigger plan or raises the spending limit in the dashboard. No code change will help.",
  "file": "<where to edit, when known>",
  "retryable": false,
  "docs": "https://docs.uarpie.app/errors/USAGE_LIMIT_REACHED"
}

Apply fix (edit file when it is given), then run the same command again.