| Symptom | Cause | Resolution |
|---|---|---|
401 / unauthorized | Missing, revoked, or misconfigured master key | Re-create your ak_... key in the console and re-run setup — see Authentication |
| Out-of-credits error | Monthly allowance exhausted and overage unavailable (e.g. overage disabled or its limit reached) | Upgrade your plan or adjust overage settings in the console — see Subscription & Billing |
| Unknown tool / fuzzy suggestions | Tool name typo or guessed name | Re-run find_tools or read the suggestions from describe_tool |
| Missing / invalid params | Skipped the describe step | Always describe_tool before executing |
| Provider unavailable | Upstream outage | AgentKey auto-fails-over where possible; otherwise retry — see Auto Failover |
When in doubt, run the free
account tool to confirm
both your balance and upstream health.Exact error codes and response envelopes are confirmed in the
console.