/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
| Code | Status | Means | What to do |
|---|---|---|---|
NOT_FOUND | 404 | Mind map not found. | The map doesn't exist or belongs to someone else. Call list_mindmaps to find the right id. |
FORBIDDEN_SCOPE | 403 | This 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. |
VALIDATION | 400 | Input is invalid. | Fix each entry in data.issues (a path and a message), then retry. |
VERSION_CONFLICT | 409 | The 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_EXCEEDED | 422 | A limit was exceeded. | data.limit names the limit and data.max its value. Split the work into smaller calls or remove nodes. |
RATE_LIMITED | 429 | Too many requests. Wait a minute and retry. | Wait a minute, then retry the same call. |
{
"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
| Limit | Maximum |
|---|---|
| Mind maps per account | 200 |
| Nodes per map, including the root | 2,000 |
| Levels per map, including the root | 64 |
| Characters in a node's text | 280 |
| Characters in a node's note | 4,000 |
Operations in one edit_mindmap call | 500 |
| Characters in a map title | 280 |