The shared inbox and the sales board. 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. |
get_pipeline | read | Your sales board — who is at which stage, what the open pipeline is worth, and whether the bot or a person moved them. |
list_opportunities | read | Leads the AI let slip, found twice a day: why, what they said, what to do and a message ready to send. |
update_opportunity | write | Mark a missed opportunity done or not worth it once the team has replied, called or made an offer. |
scan_opportunities | write | Read the latest chats for missed opportunities right now instead of waiting for the next scheduled scan. |
move_contact | write | Move someone to another stage or set what their deal is worth. Unlike the bot, you can move people backwards and close them. |
list_tags | read | Your tags, how many people carry each, and which ones keep the AI quiet. |
tag_contact | write | Tag the person in a chat, e.g. Client, or take the tag off. A tag can keep the AI quiet for them: no replies, no follow-ups. |
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.