Internal MCP server
The internal MCP server provides built-in tools for call control and common bot actions. Configure an MCP server with the URL http://internal.callControl, then enable the tools you want to use in the stage.
The tools operate in the current conversation and stage context. The knowledge-base tools use the files available to the active stage.
Call control
| Function | Description | Parameters |
|---|---|---|
hangupCall() | Ends the current call. | None |
transferCall(destination, options?) | Transfers the call to a phone number, SIP URI, or supported destination. | destination: target; options: provider-specific transfer options |
takeMessage(maxSecs?) | Records a message from the caller after consent has been obtained. | maxSecs: maximum recording duration in seconds; default 180 |
acceptTransfer() | Accepts and bridges an incoming warm transfer. | None |
switchStage(stageName) | Switches the conversation to another configured stage. | stageName: stage name |
incSpeed() / decSpeed() | Increases or decreases the assistant’s speaking speed. | None |
incVolume() / decVolume() | Increases or decreases the assistant’s audio volume. | None |
Knowledge base
| Function | Description | Parameters |
|---|---|---|
kbList() | Lists the filenames enabled for the currently active stage, including files provided by an attached shared bot. | None |
kbLookup(sources, prompt) | Searches the selected knowledge-base files and returns matching context. | sources: filename or list of filenames; prompt: question or search query |
Messaging and integrations
| Function | Description | Parameters |
|---|---|---|
sendEmail(to, subject, message, attachments?, remoteAccountId?) | Sends an email from the current bot. | Recipient, subject, message, and optional attachments or configured email account |
sendSMS(to, text, from?) | Sends an SMS using the current business account. | Recipient, message text, and optional sender number |
webhook(url, data?, opt?) | Sends a request to a webhook URL. | URL, optional request data, and options such as method or headers |
The available tools must be enabled for the stage in the MCP server configuration before the model can call them.