All pages

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

ToolWhat it does
list_agentsYour agents, with every setting
get_agentOne agent's settings
create_agentA new agent — only a name is required
update_agentChange 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_chatTalk 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

ToolWhat it does
list_knowledgeDocuments the agent answers from, with their status
add_knowledgeTeach 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

ToolWhat it does
list_actionsThe API calls this agent can make, and which are on
create_actionLet 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

ToolWhat it does
list_contactsFilter by tag, group, externalId or phone
get_contactOne contact, with consent
upsert_contactCreate, or update the contact on that number
update_contactChange a contact by id
delete_contact †Erase a contact and their conversations and calls
list_contact_groupsEvery contact group with its size
create_contact_groupA new, empty group
rename_contact_groupRename a group; campaigns aimed at it keep reaching it
delete_contact_group †Delete a group; its contacts stay
add_to_contact_groupAdd up to 1,000 contacts to a group
remove_from_contact_groupTake contacts out of a group

Conversations

ToolWhat it does
list_conversationsEvery channel; filter by channel, status (e.g. escalated) and since
list_messagesA conversation's messages, without internal team notes
reply_to_conversation † ‡Send one WhatsApp message into a conversation
set_conversation_statusResolve, hand back to the agent, or take over
assign_conversationMake it a teammate's job, by email — they are notified
list_membersYour teammates, to assign to

WhatsApp

ToolWhat it does
list_templatesYour templates, and what a send needs: how many values, button values, whether a header picture is required
list_sequencesYour 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_workflowsThe 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

ToolWhat it does
place_call † ‡Have an agent ring one person, now or later
place_calls_batch † ‡Queue up to 200 calls
list_callsFilter by agent, status, reference, dates
get_callSummary, extracted details, full transcript, recording link
cancel_call † ‡Cancel a queued call, or hang up a live one
list_models, list_voices, list_phone_numbersWhat an agent can be set up with

Webhooks

ToolWhat it does
list_webhooksWhere 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_webhookSend a sample event and say whether it arrived
list_webhook_deliveriesThe last 50 deliveries — what your endpoint answered, and why one failed

Campaigns

ToolWhat it does
list_campaignsBroadcasts and calling campaigns with their results — sent, delivered, read, replied, failed
get_campaignOne campaign's results
pause_campaignStop 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

ToolWhat it does
get_usagePlan, replies this month against your allowance, balance, replies per day
get_agent_analyticsOne agent's conversations, leads, escalations, questions it could not answer, and top questions
get_call_summaryCall totals — answered, missed, minutes, cost — and a series
get_whatsapp_summaryWhatsApp 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.

AreaTools
WhatsApp templatesget_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 formslist_forms, get_form, create_form, update_form, publish_form, delete_form †
Sequencesget_sequence, create_sequence, update_sequence, add_sequence_step, activate_sequence † ‡, pause_sequence, delete_sequence †
Phone numberssearch_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
Callsget_call_transcript, get_call_analysis, get_post_call_settings, update_post_call_settings, set_call_follow_up † ‡ (the message after a call)
SMSget_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 toolsget_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 teamget_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
Voiceslist_voice_clones, get_voice_clone, update_voice_clone, delete_voice_clone †
Money and usageget_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:

ToolWhat it does
list_customersYour customer workspaces, newest first; filter by your own externalId, or deleted ones awaiting erasure
get_customerOne customer, with its counts and this month's spend
create_customerA new customer workspace, charged to your wallet
update_customerName, 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_customerBring 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

ToolWhat it does
get_byokWhether 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_voicesYour voice provider's voices, with a sample when the provider hosts one
set_agent_byok_modelRun one agent on a model your LLM key reaches
set_agent_byok_voiceGive 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.

PromptWhat it does
build_agentCreate an agent for your business, teach it from your website, and test it
connect_my_databaseLet an agent look things up in your own database through your API
weekly_reportUsage, calls, WhatsApp and each agent's results for the last 7 days, with what to fix
fix_unanswered_questionsFind what customers asked that the agent could not answer, and draft knowledge for it
triage_inboxSummarise conversations waiting for a person and propose what to do with each

A Read-only key is offered only weekly_report.