Six tools cover the whole lifecycle of an agent: find it, read it, change it, and check the change before a customer sees it.
Real prompts, not pseudo-code. Claude picks the tools itself.
| Tool | Needs | What it does |
|---|---|---|
list_bots | read | Every bot across every workspace you administer, with the workspace it belongs to. |
get_bot | read | One bot in full — instructions, model, settings. |
update_bot_instructions | write | Rewrite what the bot is told to do. Snapshotted, so you can roll back. |
update_bot_settings | write | Model, office hours, handoff, automations. |
test_bot | write | Ask the bot a question and read the answer, without touching a real conversation. |
get_overview | read | Conversation counts by stage, per bot, across every workspace. |
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.