The AI says a tool is disabled (TOOL_DISABLED, TOOL_NOT_YET_ENABLED) | The feature is not available for this account right now | Ask "Which features can my account use?" (get_mcp_policy). Not routing around it silently is the intended behavior. |
Not enough credits (INSUFFICIENT_CREDIT) | Balance lower than the expected cost | Check the balance, top up, or reduce count/options |
Spending limit reached (SPENDING_LIMIT_EXCEEDED) | Per-request / daily / monthly MCP limit | See limits with get_mcp_policy. Jobs are not split to bypass a limit. |
Sign-in expired (AUTH_REQUIRED, TOKEN_EXPIRED, AUTH_INVALID) | MCP connection login expired | Reconnect NEXAGEN in your AI app's connector settings |
Permission denied (SCOPE_DENIED) | Permission not granted when connecting | Reconnect and allow the permission |
| Upload not possible | The app cannot run an HTTP PUT outside MCP | Upload in the NEXAGEN web app and pick it from your library, or use an app with a terminal (Claude Code, Cursor, Codex) |
Upload slot error (UPLOAD_INVALID) | Slot expired or wrong type/size (png, jpeg, webp, gif, mp4, webm; max 100 MB) | Start a new upload slot |
Option error (INVALID_CAPABILITY) | The engine does not support that duration/resolution/aspect/reference | Choose from the supported values the AI shows |
| Generation takes long | The job is still processing | Ask "check the status of job ..." with the job id the AI gave you. Do not resubmit. |
Polling too fast (POLL_TOO_FAST) | Status checked faster than the server allows | Skills respect the interval; check again shortly |
Busy (RATE_LIMITED, QUEUE_BUSY, CONCURRENCY_LIMIT) | Load peak | Retry after the indicated time; for paid requests check first whether a job was created |
| Skill not working | Wrong install location/format | See the guides: Claude, Cursor, Codex, ChatGPT, Other |