> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-mcp/tools-reference.md).

# Tools Reference

Every tool the Dapta MCP gives Claude: 139 tools grouped by area, with the title Claude sees and whether each one reads or writes your data.

Tools are the concrete actions Claude can take in your Dapta workspace. You never need to call one by name: you ask in plain language and Claude picks the tools, usually by following a [guide](/dapta-mcp/key-concepts.md). This page is the full list, for when you want to know exactly what is available.

There are **139 tools**: 112 only read, 8 add new data, and 19 change or remove existing data.

{% hint style="info" %}
**Writes come in `preview_*` / `commit_*` pairs.** The preview only reads: it shows exactly what will change and returns a single-use token. The commit applies the change after you say yes. Three tools act without a preview: `create_voice_agent` creates a new agent (Claude confirms the details with you first), `discard_text_agent_draft` drops an unpublished draft, and `chat_with_text_agent` runs a test conversation.
{% endhint %}

The workspace is always the one tied to your API key, or the one you chose after signing in. Tools marked **Reaches outside Dapta** can trigger something beyond your workspace data, such as running a flow, queuing calls, or changing an agent that answers real people.

***

## Voice agents: read and configure

7 tools.

| Tool                          | Title                            | What it does to your data                                       |
| ----------------------------- | -------------------------------- | --------------------------------------------------------------- |
| `commit_update_voice_agent`   | Update voice agent               | Writes: changes or removes existing data. Reaches outside Dapta |
| `create_voice_agent`          | Create voice agent               | Writes: adds new data. Reaches outside Dapta                    |
| `get_agent`                   | Get voice agent                  | Reads                                                           |
| `get_agent_complete_analysis` | Analyze voice agent              | Reads                                                           |
| `get_agent_post_call_schema`  | Get voice agent post-call schema | Reads                                                           |
| `list_agents`                 | List voice agents                | Reads                                                           |
| `preview_update_voice_agent`  | Update voice agent (preview)     | Reads                                                           |

## Voice call analytics

13 tools.

| Tool                             | Title                                  | What it does to your data |
| -------------------------------- | -------------------------------------- | ------------------------- |
| `export_calls`                   | Export calls                           | Reads                     |
| `get_agent_call_statistics`      | Get call statistics by agent           | Reads                     |
| `get_agent_call_volume_check`    | Check agent call volume                | Reads                     |
| `get_call`                       | Get call                               | Reads                     |
| `get_call_analytics`             | Get call analytics                     | Reads                     |
| `get_hourly_call_distribution`   | Get hourly call distribution           | Reads                     |
| `get_weekday_call_distribution`  | Get weekday call distribution          | Reads                     |
| `list_call_examples_by_category` | List example calls by category         | Reads                     |
| `list_calls`                     | List calls                             | Reads                     |
| `list_calls_with_audio`          | List calls with audio                  | Reads                     |
| `search_calls_by_phone`          | Search calls by phone                  | Reads                     |
| `temporal_heatmap`               | Get call heatmap                       | Reads                     |
| `temporal_hourly_by_org`         | Get workspace hourly call distribution | Reads                     |

## Voice agent variables and qualified leads

6 tools.

| Tool                                  | Title                         | What it does to your data |
| ------------------------------------- | ----------------------------- | ------------------------- |
| `aggregate_variable_results`          | Aggregate variable results    | Reads                     |
| `analyze_variable_usage`              | Analyze variable usage        | Reads                     |
| `discover_agent_qualification_schema` | Discover qualification schema | Reads                     |
| `discover_variables_from_calls`       | Discover variables from calls | Reads                     |
| `find_input_variables`                | Find input variables          | Reads                     |
| `find_qualified_leads`                | Find qualified leads          | Reads                     |

## Voice call feedback

4 tools.

| Tool                     | Title                          | What it does to your data |
| ------------------------ | ------------------------------ | ------------------------- |
| `get_comment_sentiment`  | Get feedback comment sentiment | Reads                     |
| `get_feedback_summary`   | Get feedback summary           | Reads                     |
| `get_feedback_trends`    | Get feedback trends            | Reads                     |
| `list_negative_feedback` | List negative feedback         | Reads                     |

## Voice sequences (outbound calling lists)

12 tools.

| Tool                               | Title                                   | What it does to your data                                       |
| ---------------------------------- | --------------------------------------- | --------------------------------------------------------------- |
| `commit_attach_sequence_contacts`  | Add contacts to sequence                | Writes: changes or removes existing data. Reaches outside Dapta |
| `commit_create_sequence`           | Create sequence                         | Writes: adds new data                                           |
| `commit_remove_sequence_contacts`  | Remove contacts from sequence           | Writes: changes or removes existing data                        |
| `commit_update_sequence_rules`     | Update sequence rules                   | Writes: changes or removes existing data. Reaches outside Dapta |
| `get_sequence`                     | Get sequence                            | Reads                                                           |
| `get_sequence_contact_attempts`    | Get sequence contact attempts           | Reads                                                           |
| `list_sequence_contacts`           | List sequence contacts                  | Reads                                                           |
| `list_sequences`                   | List sequences                          | Reads                                                           |
| `preview_attach_sequence_contacts` | Add contacts to sequence (preview)      | Reads                                                           |
| `preview_create_sequence`          | Create sequence (preview)               | Reads                                                           |
| `preview_remove_sequence_contacts` | Remove contacts from sequence (preview) | Reads                                                           |
| `preview_update_sequence_rules`    | Update sequence rules (preview)         | Reads                                                           |

## Text and WhatsApp agents

24 tools.

| Tool                                    | Title                                        | What it does to your data                                       |
| --------------------------------------- | -------------------------------------------- | --------------------------------------------------------------- |
| `chat_with_text_agent`                  | Test chat with text agent                    | Writes: changes or removes existing data. Reaches outside Dapta |
| `commit_create_text_agent`              | Create text agent                            | Writes: adds new data. Reaches outside Dapta                    |
| `commit_delete_text_agent`              | Delete text agent                            | Writes: changes or removes existing data. Reaches outside Dapta |
| `commit_publish_text_agent`             | Publish text agent draft                     | Writes: changes or removes existing data. Reaches outside Dapta |
| `commit_rollback_text_agent`            | Roll back text agent                         | Writes: changes or removes existing data. Reaches outside Dapta |
| `commit_update_text_agent`              | Update text agent                            | Writes: changes or removes existing data. Reaches outside Dapta |
| `commit_update_text_agent_context`      | Update text agent identity context           | Writes: changes or removes existing data                        |
| `discard_text_agent_draft`              | Discard text agent draft                     | Writes: changes or removes existing data                        |
| `generate_text_agent_example_questions` | Generate text agent example questions        | Writes: adds new data                                           |
| `get_conversation`                      | Get text conversation                        | Reads                                                           |
| `get_text_agent_conversations`          | Get text agent conversations                 | Reads                                                           |
| `get_text_agent_details`                | Get text agent                               | Reads                                                           |
| `get_text_agent_history`                | Get text agent history                       | Reads                                                           |
| `get_workspace_whatsapp_lines`          | List WhatsApp lines                          | Reads                                                           |
| `list_all_text_agents`                  | List text agents                             | Reads                                                           |
| `list_conversations`                    | List text conversations                      | Reads                                                           |
| `preview_create_text_agent`             | Create text agent (preview)                  | Reads                                                           |
| `preview_delete_text_agent`             | Delete text agent (preview)                  | Reads                                                           |
| `preview_publish_text_agent`            | Publish text agent draft (preview)           | Reads                                                           |
| `preview_rollback_text_agent`           | Roll back text agent (preview)               | Reads                                                           |
| `preview_update_text_agent`             | Update text agent (preview)                  | Reads                                                           |
| `preview_update_text_agent_context`     | Update text agent identity context (preview) | Reads                                                           |
| `search_text_agent`                     | Search text agents                           | Reads                                                           |
| `top_agents_by_messages`                | Rank text agents by messages                 | Reads                                                           |

## Flow Studio automations

35 tools.

| Tool                         | Title                        | What it does to your data                                       |
| ---------------------------- | ---------------------------- | --------------------------------------------------------------- |
| `commit_archive_flow`        | Archive flow                 | Writes: changes or removes existing data                        |
| `commit_create_flow`         | Create flow                  | Writes: adds new data                                           |
| `commit_create_flow_folder`  | Create flow folder           | Writes: adds new data                                           |
| `commit_execute_flow`        | Run flow                     | Writes: changes or removes existing data. Reaches outside Dapta |
| `commit_patch_flow`          | Patch flow                   | Writes: changes or removes existing data                        |
| `commit_rollback_flow`       | Roll back flow               | Writes: changes or removes existing data                        |
| `commit_update_flow`         | Update flow                  | Writes: changes or removes existing data                        |
| `diff_flow_versions`         | Compare flow versions        | Reads                                                           |
| `get_flow_details`           | Get flow                     | Reads                                                           |
| `get_flow_execution_detail`  | Get flow run detail          | Reads                                                           |
| `get_flow_execution_logs`    | List flow runs               | Reads                                                           |
| `get_flow_execution_stats`   | Get flow run statistics      | Reads                                                           |
| `get_flow_graph`             | Get flow graph               | Reads                                                           |
| `get_flow_input_schema`      | Get flow input schema        | Reads                                                           |
| `get_flow_node`              | Get flow node                | Reads                                                           |
| `get_flow_template_by_id`    | Get flow template            | Reads                                                           |
| `get_flow_version`           | Get flow version             | Reads                                                           |
| `get_flow_versions`          | List flow versions           | Reads                                                           |
| `get_flow_webhook_url`       | Get flow webhook URL         | Reads                                                           |
| `get_node_template_by_id`    | Get node template            | Reads                                                           |
| `get_scheduled_task`         | Get flow schedule            | Reads                                                           |
| `get_workspace_flows`        | List flows                   | Reads                                                           |
| `get_workspace_integrations` | List workspace integrations  | Reads                                                           |
| `preview_archive_flow`       | Archive flow (preview)       | Reads                                                           |
| `preview_create_flow`        | Create flow (preview)        | Reads                                                           |
| `preview_create_flow_folder` | Create flow folder (preview) | Reads                                                           |
| `preview_execute_flow`       | Run flow (preview)           | Reads                                                           |
| `preview_patch_flow`         | Patch flow (preview)         | Reads                                                           |
| `preview_rollback_flow`      | Roll back flow (preview)     | Reads                                                           |
| `preview_update_flow`        | Update flow (preview)        | Reads                                                           |
| `search_agents_referencing`  | Find what references a flow  | Reads                                                           |
| `search_flow_templates`      | Search flow templates        | Reads                                                           |
| `search_flows`               | Search flows by content      | Reads                                                           |
| `search_node_templates`      | Search node templates        | Reads                                                           |
| `validate_flow_structure`    | Validate flow structure      | Reads                                                           |

## Dapta databases

14 tools.

| Tool                            | Title                             | What it does to your data                |
| ------------------------------- | --------------------------------- | ---------------------------------------- |
| `commit_create_dapta_database`  | Create Dapta database             | Writes: adds new data                    |
| `commit_create_dapta_table`     | Create Dapta table                | Writes: adds new data                    |
| `commit_delete_dapta_rows`      | Delete Dapta table rows           | Writes: changes or removes existing data |
| `commit_insert_dapta_rows`      | Add rows to Dapta table           | Writes: changes or removes existing data |
| `commit_update_dapta_rows`      | Update Dapta table rows           | Writes: changes or removes existing data |
| `describe_dapta_table`          | Describe Dapta table              | Reads                                    |
| `list_dapta_database_tables`    | List Dapta tables                 | Reads                                    |
| `list_dapta_databases`          | List Dapta databases              | Reads                                    |
| `preview_create_dapta_database` | Create Dapta database (preview)   | Reads                                    |
| `preview_create_dapta_table`    | Create Dapta table (preview)      | Reads                                    |
| `preview_delete_dapta_rows`     | Delete Dapta table rows (preview) | Reads                                    |
| `preview_insert_dapta_rows`     | Add rows to Dapta table (preview) | Reads                                    |
| `preview_update_dapta_rows`     | Update Dapta table rows (preview) | Reads                                    |
| `query_dapta_table_rows`        | Read Dapta table rows             | Reads                                    |

## Workspace inventory

4 tools.

| Tool                      | Title                   | What it does to your data |
| ------------------------- | ----------------------- | ------------------------- |
| `get_brain`               | Get knowledge base      | Reads                     |
| `list_brains`             | List knowledge bases    | Reads                     |
| `list_phone_numbers`      | List phone numbers      | Reads                     |
| `list_whatsapp_templates` | List WhatsApp templates | Reads                     |

## Sales meetings

7 tools.

| Tool                             | Title                             | What it does to your data |
| -------------------------------- | --------------------------------- | ------------------------- |
| `get_current_workspace_meetings` | List recent meetings              | Reads                     |
| `get_meeting_by_bot_id`          | Get meeting                       | Reads                     |
| `get_meeting_statistics`         | Get meeting statistics            | Reads                     |
| `get_organization_calendars`     | List meeting calendars            | Reads                     |
| `get_organization_meetings`      | List meetings                     | Reads                     |
| `get_scheduled_bots`             | List scheduled meeting recordings | Reads                     |
| `search_meetings_by_title`       | Search meetings by title          | Reads                     |

## Identity and billing

5 tools.

| Tool                            | Title               | What it does to your data |
| ------------------------------- | ------------------- | ------------------------- |
| `get_my_balance`                | Get credit balance  | Reads                     |
| `get_my_subscription`           | Get subscription    | Reads                     |
| `get_workspace_company_context` | Get company context | Reads                     |
| `list_my_workspaces`            | List my workspaces  | Reads                     |
| `whoami`                        | Who am I            | Reads                     |

## Dapta documentation and guides

6 tools.

| Tool                     | Title                    | What it does to your data |
| ------------------------ | ------------------------ | ------------------------- |
| `docs_get_page`          | Get Dapta docs page      | Reads                     |
| `docs_get_section_pages` | List Dapta docs pages    | Reads                     |
| `docs_list_sections`     | List Dapta docs sections | Reads                     |
| `docs_search`            | Search Dapta docs        | Reads                     |
| `docs_search_code`       | Search Dapta docs code   | Reads                     |
| `get_guidance`           | Get workflow guidance    | Reads                     |

## Data model

2 tools.

| Tool              | Title           | What it does to your data |
| ----------------- | --------------- | ------------------------- |
| `describe_entity` | Describe entity | Reads                     |
| `list_entities`   | List entities   | Reads                     |

***

## Related

{% content-ref url="/pages/68GXxevzYgw8Dgv8Kbzv" %}
[What Claude Can Do](/dapta-mcp/skills.md)
{% endcontent-ref %}

{% content-ref url="/pages/7Nwd3yZ8uoxBnjaqiVC6" %}
[Safety & Security](/dapta-mcp/safety-and-security.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dapta.ai/dapta-mcp/tools-reference.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
