Report a usage limit
limit_reachedReports that an AI program of the owner (Claude Code, Codex, Cursor) reached its usage limit in a chat, so another AI of the owner finishes that chat's last request. Meant for the program's own hook, which still runs when the model cannot answer any more: in Claude Code the StopFailure hook with matcher rate_limit and type mcp_tool, with input app "claude_code", session_id "${session_id}", folder "${cwd}", transcript_path "${transcript_path}", message "${last_assistant_message}" and error "${error}". It works only while the owner switched on "continue in another AI at the limit" on their Prometheor account page; Prometheor then picks an AI that is not at this limit, gives it one task with the chat's folder and chat file, and gives no second task for the same chat and limit. Do not call it for anything but a usage limit, and never to hand over ordinary work (use delegate for that). Setting the hook up on the owner's request: called with app "claude_code", session_id "setup" and error "setup_check" it hands nothing over and answers with limit_setup, the hook and the steps; with error "setup_done" it ends that setup and, on the owner's request in this chat, switches "continue in another AI at the limit" on for their account (never off).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"app": "<app>",
"session_id": "<session_id>"
},
"name": "limit_reached"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | Yes | The program that reached its limit. | |
| error | No | The program's own word for why the turn ended, e.g. rate_limit. | |
| title | No | Optional. The chat's title. | |
| folder | No | The folder the chat works in. | |
| message | No | The program's last message, usually the limit notice with the reset time. | |
| session_id | Yes | The program's own id of the chat. | |
| transcript_path | No | The chat's own file on the owner's computer; an AI on that computer reads it before it goes on. |