Add System Tools for built-in actions or connect MCP servers to give your Assistant access to external tools.
Setting up MCP servers
The API paths below are relative to https://newprd.reecall.io/data_next.
MCP (Model Context Protocol) servers provide your Assistant with external tool capabilities. Each MCP server exposes a set of tools that the Assistant can invoke during conversations.
Register each MCP server with its URL and request headers, then attach it to an Assistant.
Configure each System Tool separately and attach it directly to an Assistant. Reecall provides the tool definitions that specify the available actions and their configuration.
Understanding the tool architecture
Tools consist of two parts:
A ToolDefinition is a Reecall-provided template that defines the tool's schema and configuration.
A Tool is an instance you create from that definition, with configuration for a specific Assistant.
Fetch available tool definitions
Code
GET /ai/toolDefinitions
The configuration field is a JSON Schema that defines the expected configuration for the tool. This configuration influences the Assistant's behavior when invoking the tool during a conversation.
Response:
Code
[ { "id": "d4e5f6a7-b8c9-0123-def0-123456789abc", "name": "end_conversation", "description": "End the conversation gracefully when appropriate. Call this function when the user explicitly says goodbye or wants to end the call.", "configuration": { "type": "object", "properties": { "closingMessage": { "type": "string", "description": "Optional custom closing message to say before ending the conversation" } }, "additionalProperties": false }, "createdAt": "2024-01-01T00:00:00.000Z", "updatedAt": "2024-01-01T00:00:00.000Z" }, { "id": "another-definition-id", "name": "another_tool", "description": "Another available tool" }]
The end_conversation tool speaks closingMessage, when provided, before ending the call.
Create a tool for your Assistant
Create a Tool with the assistantId to attach it to and the definitionId returned by GET /ai/toolDefinitions. Set configuration according to that definition's schema.
Code
POST /ai/toolsContent-Type: application/jsonAuthorization: Bearer <your-api-token>{ "assistantId": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "definitionId": "d4e5f6a7-b8c9-0123-def0-123456789abc", "configuration": { "closingMessage": "Thank you for calling! Have a great day!" }, "descriptionOverride": "End the call politely when the customer is done", "disableInterruptions": true}
Response:
Code
{ "id": "e5f6a7b8-c9d0-1234-ef01-23456789abcd", "assistantId": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "definitionId": "d4e5f6a7-b8c9-0123-def0-123456789abc", "definition": { "id": "d4e5f6a7-b8c9-0123-def0-123456789abc", "name": "end_conversation", "description": "End the conversation gracefully when appropriate." }, "configuration": { "closingMessage": "Thank you for calling! Have a great day!" }, "descriptionOverride": "End the call politely when the customer is done", "disableInterruptions": true, "createdAt": "2024-01-15T10:30:00.000Z", "updatedAt": "2024-01-15T10:30:00.000Z"}
Tool configuration options
Field
Required
Description
assistantId
Yes
The Assistant to attach this tool to
definitionId
Yes
The tool definition template to use
configuration
No
Tool-specific properties based on the definition's configuration
descriptionOverride
No
Replaces the default description shown to the LLM. Change it when you need different instructions for when to call the tool.
disableInterruptions
No
Stored on the Tool, but currently not applied by the voice runtime. Use VAD Settings for Assistant-level interruption control
Delete a tool
Delete the Tool instance to remove it from its Assistant.
Filter Tools by assistantId to list those attached to an Assistant:
Code
GET /ai/tools?where={"assistantId":"f47ac10b-58cc-4372-a567-0e02b2c3d479"}
Response:
Code
[ { "id": "e5f6a7b8-c9d0-1234-ef01-23456789abcd", "assistantId": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "definitionId": "d4e5f6a7-b8c9-0123-def0-123456789abc", "definition": { "id": "d4e5f6a7-b8c9-0123-def0-123456789abc", "name": "end_conversation", "description": "End the conversation gracefully when appropriate." }, "configuration": { "closingMessage": "Thank you for calling! Have a great day!" }, "descriptionOverride": "End the call politely when the customer is done", "disableInterruptions": true, "createdAt": "2024-01-15T10:30:00.000Z", "updatedAt": "2024-01-15T10:30:00.000Z" }]