Skip to main content

Local tools

Local tools are built-in tools provided by Moveo that your AI agent can invoke directly from guidelines. They let the agent trigger workflows, compose rich responses, execute code, and detect voicemails — without requiring external server configuration.

note

Local tools are different from MCP servers. MCP servers connect to external tool providers, while local tools are internal to Moveo and ready to use out of the box.

Available tools

ToolDescriptionChannel support
Trigger workflowHands off the conversation to a specific workflow. The workflow takes over the response — the AI agent does not respond separately.All channels
Compose rich responseLets the AI agent compose structured responses with buttons, carousels, images, and files.Chat, web widget, and messaging channels only. Not available on voice, email, or SMS.
Execute codeLets the AI agent run code for math calculations and complex operations.All channels
Voicemail detectionDetects voicemail systems and optionally leaves a message.Voice channels only

Enable or disable a tool

Navigate to your AI agent → WorkflowsMCP servers, then select the Local tools tab.

Local tools tab showing toggle switches for each tool

Each tool has a toggle switch. Activate a toggle to make that tool available to the AI agent.

warning

Disabling a tool that is referenced in your guidelines removes all its references automatically. Review your guidelines after disabling a tool that was central to the agent's behavior.

When you disable a tool that is already referenced in guidelines, a warning dialog appears:

  • The dialog explains that all tool references will be removed from guidelines
  • Select View guideline to review the affected guidelines before confirming
  • Select Disable to proceed, or Cancel to keep the tool enabled
Warning dialog when disabling a tool referenced in guidelines

Reference a tool in guidelines

You can reference local tools in any guideline editor — Goal, Overview, Features, Loyalty, Objections, or Custom Instructions.

Insert a tool reference

  1. Open a guideline editor
  2. Type @ to open the suggestion menu
  3. Select a tool from the list
@ suggestion menu showing available local tools

The tool appears as an inline badge in the editor (for example, @compose_rich_response or @execute_code).

Insert a trigger workflow reference

The Trigger workflow tool requires you to select a specific workflow:

  1. Type @ and select Trigger workflow
  2. A workflow picker opens automatically
  3. Select the target workflow from the list
Workflow picker showing available workflows

The badge displays as @trigger_workflow(workflow name), where the workflow name updates automatically if you rename the workflow.

tip

If the @ menu is empty, no tools are enabled. Select the link in the empty state prompt to go to the Local tools settings and enable them.

Runtime behavior

When the AI agent encounters a tool reference in guidelines during a conversation, it invokes the tool automatically.

Trigger workflow

The conversation hands off to the selected workflow. The workflow owns the response from that point — the AI agent does not receive a result back and does not respond separately.

Compose rich response

The AI agent composes a structured response with elements like text with buttons, carousels, images, or files. The response is sent directly to the user.

caution

This tool only works on channels that support rich payloads (chat, web widget, messaging). Enabling it has no effect on voice, email, or SMS channels.

Execute code

The AI agent runs code to perform complex operations such as math calculations. The result is used in the agent's response.

Voicemail detection

The AI agent detects whether a voicemail system has answered and can optionally leave a message.

caution

This tool only works on voice channels. Enabling it has no effect on other channels.

Delete a workflow referenced in guidelines

When you delete a workflow that is referenced by @trigger_workflow in guidelines, a warning appears:

  • The dialog explains that the tool reference will be removed from guidelines
  • Select View guideline to review the affected guidelines
  • On confirmation, all @trigger_workflow references pointing to that workflow are removed automatically

Troubleshooting

The @ menu shows no tools

No local tools are enabled. Go to your AI agent → WorkflowsMCP serversLocal tools tab and enable the tools you need.

Tool references disappeared from guidelines

Tool references are removed automatically when you disable a tool or delete a workflow that the tool points to. Re-enable the tool and re-insert the references.

Compose rich response has no effect

This tool only works on channels that support rich payloads (chat, web widget, messaging). It has no effect on voice, email, or SMS channels.

Voicemail detection has no effect

This tool only works on voice channels. It has no effect on chat, web, email, SMS, or messaging channels.


Next steps

  • MCP servers — connect external tools via the Model Context Protocol
  • Workflows — build conversation workflows that tools can trigger