Nine tools for the shared inbox. The important sequence is take_over → send_reply → hand_to_ai: without the first call the AI will answer over the top of you.
Real prompts, not pseudo-code. Claude picks the tools itself.
| Tool | Needs | What it does |
|---|---|---|
list_conversations | read | The shared inbox. Filter by bot, stage or channel. |
get_conversation | read | Every message in order, plus the lead details captured on the thread. |
send_reply | write | Reply as a human. Never metered and never counted against your plan. |
take_over | write | Stop the AI on a thread so a person can answer. |
hand_to_ai | write | Give the thread back; the AI resumes answering. |
set_conversation_status | write | Move a thread between open, pending and closed. |
list_signups | read | Captured leads — anyone who gave a name, email or phone to a bot. |
get_signup | read | One lead in full. |
update_signup | write | Edit a lead record or add a note. |
read works with any key. write is refused unless the key allows it — the server checks before the tool runs, so a read-only key genuinely cannot change anything.
Worth knowing before you wire it into something that matters.