/docs/errors

Errors and limits.

Every failed tool call returns a result with isError: true and a JSON body: code, message and, for some codes, data. Each code tells your agent what to do next.

Error codes

CodeStatusMeansWhat to do
NOT_FOUND404Mind map not found.The map doesn't exist or belongs to someone else. Call list_mindmaps to find the right id.
FORBIDDEN_SCOPE403This token is missing a required scope.The token is missing data.requiredScope. Reconnect and approve that scope. A session requirement is available only in the web app.
VALIDATION400Input is invalid.Fix each entry in data.issues (a path and a message), then retry.
VERSION_CONFLICT409The map changed since you read it. Call get_mindmap and retry.The map changed since you read it. Call get_mindmap, apply your change to the new tree and pass the new version.
LIMIT_EXCEEDED422A limit was exceeded.data.limit names the limit and data.max its value. Split the work into smaller calls or remove nodes.
RATE_LIMITED429Too many requests. Wait a minute and retry.Wait a minute, then retry the same call.
Tool result
{
  "isError": true,
  "content": [
    {
      "type": "text",
      "text": "{\"code\":\"VERSION_CONFLICT\",\"message\":\"The map changed since you read it. Call get_mindmap and retry.\",\"data\":{\"currentVersion\":5}}"
    }
  ]
}

RATE_LIMITED can also arrive before any tool runs, as HTTP 429 with a JSON-RPC error whose data.code is RATE_LIMITED. The limit applies to each connected agent separately.

Limits

LimitMaximum
Mind maps per account200
Nodes per map, including the root2,000
Levels per map, including the root64
Characters in a node's text280
Characters in a node's note4,000
Operations in one edit_mindmap call500
Characters in a map title280