Errors and fixes
What the notices the MCP returns mean, and what to do about each.
When something can't be done, the tool answers with a code and a message. The chatbot explains it in plain words; this table is for when you want the details.
Plan and permissions#
| Code | What happened | What to do |
|---|---|---|
plan_limit_reached | Your plan reached its maximum of agents, tools, MCP servers, knowledge, or suites | Archive what you don't use or change plans. The notice says which plan would fit |
insufficient_scope | Your plan only allows looking things up from the chatbot | Move to a plan with full access |
credits_exhausted | There are no credits left to run the evaluation | Top up credits in the console |
entitlements_unavailable | Your plan couldn't be read right now | Try again in a few minutes |
rate_limited | Too many requests in a row | Wait a few seconds |
Agents and versions#
| Code | What happened | What to do |
|---|---|---|
invalid_agent_draft | The draft has errors and can't be saved | Ask for validate_agent_draft to see each error |
draft_unchanged | The draft equals the latest version | No need to save: that version already exists |
draft_revision_conflict | Someone saved the draft at the same time | Ask for the change again |
quality_gate_not_met | The version didn't pass the quality gate's suite | Run the evaluation and fix what failed |
agent_not_found | The agent doesn't exist in this workspace | Check that you connected the right workspace |
Components#
| Code | What happened | What to do |
|---|---|---|
mcp_connection_failed | The MCP server couldn't be reached | Check the URL and that the server is online |
mcp_not_tested | The connection was never tested | Ask for test_mcp_connection |
outbound_host_blocked | The address points to a private network | Use a public address |
invalid_eval_suite | The suite uses equals and some cases have no expected answer | Add the expected answers or use another evaluator |
document_not_reviewed | A converted document is waiting for review | Review it in the console and index again |
The connection#
| Symptom | What happened | What to do |
|---|---|---|
| The chatbot asks to connect again | It was disconnected in Settings → Chatbots, you stopped being an admin, or it went 30 days unused | Connect and approve again |
| "You need to be an admin" | Your role is manager or viewer | Ask an admin to connect it or to give you the role |
| "This request is no longer valid" | More than 10 minutes passed or it was already answered | Start connecting again from the chatbot |