Astra MCP Tool Catalogue — current payload, usage and account requirements.
A single WATI MCP connection can also expose Astra tools when your account has linked Astra access. Astra-authorized connections have their own granted capabilities. The names below describe the released tool surface; they are not a promise that every account/profile exposes every name.
Start and load a tool group
Use list_skills to inspect available groups, then activate_skill with the group's name. Refresh tools/list (or use the returned tool definitions if your client supports them) before calling a newly loaded tool. deactivate_skill unloads a group for the session. Where exposed, call_skill_tool dispatches to a selected tool; its side effects are those of the underlying tool.
mcp_auth is an account-connection helper on some profiles; prefer the hosted OAuth connection flow. error_reporting reports tooling problems; do not include customer content or secrets. Group activation changes the session's loaded tools, not the product's agent configuration.
Core Astra tools
| Tool | Key required inputs in the published schema | Effect |
|---|---|---|
list_agents | Inspect session schema | Read |
get_agent | agent_id | Read |
create_agent | name, knowledge_base_id | Writes or runs a preview; confirm inputs |
update_agent | agent_id | Writes or runs a preview; confirm inputs |
update_agent_instruction | agent_id, expected_instruction_revision | Writes or runs a preview; confirm inputs |
list_agent_actions | agent_id | Read |
publish_agent | agent_id | Publishes the draft agent |
list_knowledge_documents | dataset_id or knowledge_base_id | Read |
list_annotations | agent_id | Read |
create_annotation | agent_id, title, answer | Writes or runs a preview; confirm inputs |
retrieve_knowledge | agent_id, query | Read |
create_knowledge_base | name | Writes or runs a preview; confirm inputs |
send_test_message | agent_id, message | Runs a preview chat; retain returned conversation_id and reuse the same user_id/conversation_id for follow-up turns |
Tools available by group
| Group | Tool names | Purpose and effects |
|---|---|---|
branding | get_brandkit, fetch_brandkit, create_brandkit, update_brandkit, delete_brandkit | Reads or changes brand assets; deleting a brandkit is destructive. |
conversations | list_conversations, get_conversation, get_conversation_messages, get_conversations_batch, get_conversation_contact, get_contacts_and_leads, get_contact, get_contact_conversations, get_conversation_params, upsert_conversation_params, delete_conversation_params, create_contact, delete_contact, export_contacts | Reads Astra conversations/contacts, writes contact or parameter data, and exports contacts. delete_contact erases related Astra chat text/PII; Astra identifiers differ from WATI identifiers. |
agent_setup | get_runtime_config, clone_agent, delete_agent, update_agent_attributes, set_agent_enabled, list_actions, get_action | Changes agent configuration; publishing activates a draft. Deletion and enabled-state changes have operational impact. |
knowledge_management | get_annotation, update_annotation, delete_annotation, batch_delete_annotations, create_knowledge_document, delete_knowledge_document, import_knowledge_from_url, import_knowledge_from_website, get_import_status | Reads, imports, edits or deletes knowledge. Imports can be asynchronous; retain and check the import job. |
analytics | get_analytics, get_lead_distribution | Reads agent analytics. Use the date/timezone fields in the actual tool schema. |
testing | plan_test_suite, prepare_eval_context, create_test_suite, launch_run, get_run_summary, get_testing_capabilities, get_test_suite, get_test_suite_progress, list_test_suites, delete_test_suite, list_cases, get_case, patch_case, delete_case, batch_delete_cases, create_run, execute_run, evaluate_run, get_run, get_run_result, list_runs, delete_run, recompute_freshness, list_stale_cases, prune_stale_cases, rerun_run, get_run_comparison | Plans/reads tests, persists suites/runs, executes evaluations and deletes test data. These tools are not uniformly read-only. |
templates | list_templates, list_template_categories, get_template | Reads prebuilt Astra agent templates; these are not WhatsApp message templates. |
webhooks | list_webhooks, create_webhook, update_webhook, delete_webhook | Reads or changes Astra webhook subscriptions; these are distinct from wati_* subscriptions. |
integrations | get_integration_platforms, list_integration_templates, list_agent_integrations, get_configured_integration, create_integration, delete_integration, create_integration_auth, wait_integration_auth, get_integration_auth, delete_integration_auth, refresh_integration_auth, create_connection, get_mcp_credentials, get_wati_settings, register_agent_integrations, deregister_agent_integrations, execute_integration_action, get_slack_channels, get_hubspot_properties, get_salesforce_fields, get_google_sheets_spreadsheets, get_google_sheets_worksheets, perplexity_search | Discovers/connects integrations and can execute third-party actions. Actions can send messages or modify external data; inspect the action and connection first. Keep credential outputs out of prompts, logs and examples. |
voice_agent | list_voice_agents, get_voice_agent, get_voice_agent_by_text_agent, get_default_tenant_voice_agents, quick_create_voice_agent, update_voice_agent, delete_voice_agent, publish_voice_agent, get_voice_agent_count, check_voice_agent_exists | Creates/updates/deletes voice agents; publishing activates a draft. |
voice_calls | new_voice_call, web_new_voice_call, test_new_voice_call, terminate_voice_call, test_terminate_voice_call, initiate_outbound_call, get_webrtc_config, asr_transcribe | Can start or terminate real/test calls. Read/transcription helpers do not themselves place a call; confirm the selected tool before execution. |
voice_clone | upload_user_voice, submit_voice_clone, list_minimax_voices, get_minimax_voice, update_minimax_voice, search_voice_library, search_collected_voices | Uploads or creates voice assets and changes saved voice definitions; library searches are separate read operations. |
skill_management | list_skill_defs, get_skill, update_skill, delete_skill, generate_skill, clone_skill_template, list_skill_history, get_skill_history_version, restore_skill_version, list_agent_skills, attach_skill, detach_skill | Changes saved Astra sub-agent skills and agent bindings; this differs from loading an MCP tool group for one session. |
fetch_brandkit needs identifier or description even when no top-level input is marked required. get_conversations_batch accepts at most 20 conversation IDs. Use the actual session input schema for all combinations, defaults and constraints; do not supply hidden connection credentials as tool arguments.
agent_creation_guide and debugging_guide are context-only groups; loading them does not add an executable tool by that name. Tool activation does not bypass workspace/resource permissions, linked-account requirements, quotas or underlying connection access.
Two contact deletions on the same connection
delete_contact targets an Astra contact UUID and erases related chat text and personal data; anonymized metadata can remain. wati_delete_contact targets a WATI contact/target and follows WATI's soft-deletion flow, without physically erasing all associated personal data. Confirm the target system, workspace and exact contact identifier before either operation. Do not infer the target system from the prefix alone or reuse a WATI identifier as an Astra contact UUID.
See WATI MCP for OAuth/regions and the WATI catalogue. This catalogue documents released registration and explicit activation conditions; the authenticated session's tools/list determines the names actually available to that connection.