Tools
Every tool the Katexs MCP server offers, and what each one does.
Your assistant sees these tools with full descriptions and argument lists; this page is the map. Tools marked † need your approval — see Safety.
Which tools appear depends on the key: a Read-only key sees only the tools that look; a Build key sees everything except sending, calling and the WhatsApp tools that reach a person (marked ‡ below); a Full access key sees all of them.
Ids are prefixed by what they are: ag_ agent, act_ action, conv_
conversation, cust_ contact, doc_ document, wh_ webhook; calls are out_
(placed) or sch_ (queued). Lists are newest first and take limit (up to 100)
and cursor.
Agents
| Tool | What it does |
|---|---|
list_agents | Your agents, with every setting |
get_agent | One agent's settings |
create_agent | A new agent — only a name is required |
update_agent | Change instructions, greeting, model, language, voice, widget, the details it collects. The voice object takes answersCalls, voice, language, recordCalls, recordDoNotCall, maxCallSeconds, ringSeconds, unavailableMessage, surfaces and every call setting on the Voice page: thinking, thinkingLines, thinkingDelayMs, thinkingRepeatMs, thinkingAtTurnEnd, turnDetection, turnSilenceSeconds, interruptWords, neverInterrupt, holdShortSpeech, greetingUninterruptible, openingWaitsForCaller, ambience, ambienceVolume, speakingSpeed, endCallOnFinish, nudgeAfterSeconds, nudges, nudgePhrase, endAfterSilenceSeconds, endPhrases and callInstructions (ranges and defaults are in Voice). create_agent takes the same voice object. Use these exact names: a field the tool does not list is ignored. The who-is-calling lookup is not set here: it sends your callers' details to a web address, so you set it yourself on the agent's Actions page, or over the REST API |
test_chat | Talk to the agent as a customer and read its reply and the tools it used — nobody is contacted. See Test chat |
delete_agent † | Delete an agent and everything under it. Refused while the agent is on a live call |
Connecting the agent to WhatsApp, a phone number or your website is still done in the console.
Knowledge
| Tool | What it does |
|---|---|
list_knowledge | Documents the agent answers from, with their status |
add_knowledge | Teach it from a web page or pasted text |
delete_knowledge † | Remove a document |
Note
Knowledge is stored with us. For data that must stay in your database, use an action instead — see Keep your data in your database.
Actions — your own API
| Tool | What it does |
|---|---|
list_actions | The API calls this agent can make, and which are on |
create_action | Let the agent call one of your HTTPS endpoints. Created off |
test_action † | Call it once, for real, exactly as the agent would |
update_action † | Change its address, arguments or headers |
enable_action † | Switch it on — from then on anybody talking to the agent can trigger it — or off |
delete_action † | Remove it and its saved credential |
Contacts
| Tool | What it does |
|---|---|
list_contacts | Filter by tag, group, externalId or phone |
get_contact | One contact, with consent |
upsert_contact | Create, or update the contact on that number |
update_contact | Change a contact by id |
delete_contact † | Erase a contact and their conversations and calls |
list_contact_groups | Every contact group with its size |
create_contact_group | A new, empty group |
rename_contact_group | Rename a group; campaigns aimed at it keep reaching it |
delete_contact_group † | Delete a group; its contacts stay |
add_to_contact_group | Add up to 1,000 contacts to a group |
remove_from_contact_group | Take contacts out of a group |
Conversations
| Tool | What it does |
|---|---|
list_conversations | Every channel; filter by channel, status (e.g. escalated) and since |
list_messages | A conversation's messages, without internal team notes |
reply_to_conversation † ‡ | Send one WhatsApp message into a conversation |
set_conversation_status | Resolve, hand back to the agent, or take over |
assign_conversation | Make it a teammate's job, by email — they are notified |
list_members | Your teammates, to assign to |
| Tool | What it does |
|---|---|
list_templates | Your templates, and what a send needs: how many values, button values, whether a header picture is required |
list_sequences | Your sequences and their ids |
send_whatsapp_template † ‡ | Send an approved template to one person |
send_code † ‡ | Send a one-time code |
record_event † ‡ | Report that something happened (e.g. order.shipped) — can start or stop sequences |
enrol_in_sequence † ‡ | Start a sequence for one contact |
list_workflows | The workspace's workflows and their ids, and what starts each |
start_workflow_run † ‡ | Start a workflow for one contact — it may call and message them; a new number becomes a contact |
send_workflow_event † ‡ | Tell your workflows something happened to a contact (a payment, a booking); runs waiting for it move on |
Calls
| Tool | What it does |
|---|---|
place_call † ‡ | Have an agent ring one person, now or later |
place_calls_batch † ‡ | Queue up to 200 calls |
list_calls | Filter by agent, status, reference, dates |
get_call | Summary, extracted details, full transcript, recording link |
cancel_call † ‡ | Cancel a queued call, or hang up a live one |
list_models, list_voices, list_phone_numbers | What an agent can be set up with |
Webhooks
| Tool | What it does |
|---|---|
list_webhooks | Where events go, and whether delivery is healthy |
create_webhook † | Send an agent's events to your endpoint. The signing secret is shown once |
update_webhook † | Change the address or events, or switch it back on |
delete_webhook † | Stop sending |
test_webhook | Send a sample event and say whether it arrived |
list_webhook_deliveries | The last 50 deliveries — what your endpoint answered, and why one failed |
Campaigns
| Tool | What it does |
|---|---|
list_campaigns | Broadcasts and calling campaigns with their results — sent, delivered, read, replied, failed |
get_campaign | One campaign's results |
pause_campaign | Stop a sending campaign from sending more |
resume_campaign † ‡ | Start a paused campaign sending again |
cancel_campaign † | Stop a campaign for good |
create_campaign ‡ | Build a broadcast or calling campaign as a draft — audience, template, blanks — with the console's checks. Nothing is sent |
launch_campaign † ‡ | Start a draft: messages or calls to everyone in its audience, charged from your balance |
Your assistant creates the draft, tells you how many people it reaches, and launches only after you approve. Scheduling a start time is done in the console.
Usage and analytics
| Tool | What it does |
|---|---|
get_usage | Plan, replies this month against your allowance, balance, replies per day |
get_agent_analytics | One agent's conversations, leads, escalations, questions it could not answer, and top questions |
get_call_summary | Call totals — answered, missed, minutes, cost — and a series |
get_whatsapp_summary | WhatsApp sent, delivered, read, failed and received, and what they cost by category, for recent days or a date range |
The same numbers the console shows. All four work with a Read-only key. See Usage and analytics.
The rest of the console
Everything else the console does is a tool too, one per API operation, with the API reference's own description — so your assistant reads the same rules you do.
| Area | Tools |
|---|---|
| WhatsApp templates | get_template, create_template, update_template, set_template_agent_send † ‡ (whether an agent may send a template in a call; full key), submit_template, delete_template †, and the same for one-time-code templates (…_code_template) |
| WhatsApp forms | list_forms, get_form, create_form, update_form, publish_form, delete_form † |
| Sequences | get_sequence, create_sequence, update_sequence, add_sequence_step, activate_sequence † ‡, pause_sequence, delete_sequence † |
| Phone numbers | search_available_numbers, list_available_cities, get_phone_number, rent_phone_number † ‡, update_phone_number, release_phone_number † ‡, move_phone_number † ‡ (to another of a developer's workspaces), import_phone_number, list_carrier_accounts |
| Calls | get_call_transcript, get_call_analysis, get_post_call_settings, update_post_call_settings, set_call_follow_up † ‡ (the message after a call) |
| SMS | get_sms_provider, list_sms_templates, add_sms_template, update_sms_template, delete_sms_template †, send_test_sms † ‡ — all but the first two need a Full access key |
| An agent's tools | get_action, list_builtin_tools, update_builtin_tools † ‡, list_tool_servers, get_tool_server, connect_tool_server †, sync_tool_server, update_tool_server_tool, disconnect_tool_server †, list_connections, get_connection, list_connection_options, configure_connection, disconnect_account †, get_agent_channels, disconnect_telegram † |
| Workspace and team | get_workspace, update_workspace, get_member, update_member_role † ‡, remove_member †, list_invitations, get_invitation, invite_member † ‡, revoke_invitation †, projects, teams and their members and projects, notification switches, saved replies |
| Voices | list_voice_clones, get_voice_clone, update_voice_clone, delete_voice_clone † |
| Money and usage | get_dashboard, get_daily_usage, list_call_log, list_wallet_ledger, list_invoices, get_customers_usage |
Which key sees which tool follows the API exactly: a tool appears only if your key may make that request.
Done in the console, never by your assistant — anything that would put a secret in its conversation: connecting an account with a key or token (Cal.com, CRMs, helpdesks, carriers), a Telegram bot's token, a tool server that needs a token, the keys for bring your own keys, and your SMS provider's keys. Also a call's recording (it is audio), cloning a voice (it needs a recording) and scheduling a campaign's start time.
Customers — for developers
If you build your own product on Katexs, your customers are workspaces under yours. Manage them from your own connection:
| Tool | What it does |
|---|---|
list_customers | Your customer workspaces, newest first; filter by your own externalId, or deleted ones awaiting erasure |
get_customer | One customer, with its counts and this month's spend |
create_customer | A new customer workspace, charged to your wallet |
update_customer | Name, your externalId, timezone, its cap on your call lines, metadata |
delete_customer † | Stop its work, revoke its keys, and erase it after 30 days |
restore_customer | Bring a deleted customer back before its erase date |
Creating, changing, deleting and restoring a customer need a Full access
key. To work inside one customer, add a second server entry with the header
X-Workspace: org_… — every tool there acts in that customer. See
Customers.
Your customers' API keys are created in the console, not by your assistant, so no key ever appears in its conversation.
Bring your own keys
| Tool | What it does |
|---|---|
get_byok | Whether the workspace runs on its own keys (all three, its voice and language model, only its voice, or only its language model: default scope all, llm_voice, voice or llm; each agent may choose its own through update_agent's byok), and which providers — never the keys |
list_byok_voices | Your voice provider's voices, with a sample when the provider hosts one |
set_agent_byok_model | Run one agent on a model your LLM key reaches |
set_agent_byok_voice | Give one agent a voice from your provider, and on Cartesia set its speed, volume, emotion, model and pronunciation dictionary |
Adding provider keys and switching bring-your-own-keys on or off are done in the console, under Settings → Your keys. See Bring your own keys.
Guides
read_guide gives your assistant two built-in how-tos: own-database and
dashboards. Ask it to read the relevant one before building an integration.
Prompts
Ready-made commands your client lists — in Claude Code, type / to see them.
Each is a worked plan with the points where you approve written in.
| Prompt | What it does |
|---|---|
build_agent | Create an agent for your business, teach it from your website, and test it |
connect_my_database | Let an agent look things up in your own database through your API |
weekly_report | Usage, calls, WhatsApp and each agent's results for the last 7 days, with what to fix |
fix_unanswered_questions | Find what customers asked that the agent could not answer, and draft knowledge for it |
triage_inbox | Summarise conversations waiting for a person and propose what to do with each |
A Read-only key is offered only weekly_report.
