MCP Integration

MCP (Model Context Protocol) allows your AI voice agents to access external tools and systems in real-time during calls. Agents can query databases, update CRMs, check calendars, and more—all while speaking with the customer.

What is MCP?

MCP is an open protocol that lets AI models interact with external tools. Instead of hard-coding integrations, you connect an MCP server, and your assistants automatically discover and use available tools. Example: Connect an MCP server for your CRM, and your assistant can:

Look up customer information by phone number
Check order status during the call
Update contact records after qualifying a lead

How MCP Works in EolasFlow

Connect MCP Server

You register an MCP server (your tools endpoint).

Enable on VoiceFlow

You enable MCP on a VoiceFlow and select your server.

Tool Discovery

When a call starts, EolasFlow connects to your MCP server and discovers available tools.

Agent Uses Tools

During the call, your AI assistant can call any discovered tool as needed.

Results Spoken

Tool results are processed by the AI and spoken to the customer.

Setting Up MCP

Step 1: Register an MCP Server

Navigate to Integrations

Go to Connections → MCP Servers.

Add New Server

Click Add Server and enter:

Name: A descriptive name (e.g., “CRM Tools”)
URL: Your MCP server’s SSE endpoint

Configure Authentication (Optional)

If your server requires authentication, add an API key. It’s sent as a Bearer token.

Preview Tools

Click Preview to discover available tools without saving.

Review Tools

See the list of tools your server provides with their descriptions and parameters.

Save Server

Click Save to register the server.

Step 2: Enable MCP on a VoiceFlow

Open VoiceFlow Settings

Go to VoiceFlows and click on your VoiceFlow.

Navigate to MCP Tab

Click the MCP tab in VoiceFlow settings.

Enable MCP

Toggle MCP On and select your registered server.

Configure Timeout (Optional)

Adjust the tool execution timeout if needed (default: 5 seconds).

Save Configuration

Click Save. Your agent now has access to MCP tools during calls.

MCP Server Requirements

Your MCP server must:

Support SSE (Server-Sent Events) transport
Implement the JSON-RPC 2.0 protocol
Handle these methods:
- initialize - Establish connection
- tools/list - Return available tools
- tools/call - Execute a tool

Tool Definition Format

Your server returns tools in this format:

{
  "tools": [
    {
      "name": "get_customer",
      "description": "Look up customer by phone number",
      "inputSchema": {
        "type": "object",
        "properties": {
          "phone": {
            "type": "string",
            "description": "Customer phone number"
          }
        },
        "required": ["phone"]
      }
    }
  ]
}

Tool Execution

When the AI calls a tool, your server receives:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_customer",
    "arguments": {
      "phone": "+15551234567"
    }
  },
  "id": 123
}

Your server responds with:

{
  "jsonrpc": "2.0",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Customer: John Smith, Status: Premium, Last Order: Jan 10"
      }
    ]
  },
  "id": 123
}

Tool Whitelisting

Optionally restrict which tools your assistant can access:

In MCP server settings, expand Advanced Options
Add tool names to the Tools Whitelist
Only listed tools will be available to agents

Leave the whitelist empty to allow access to all tools from the server.

Agent Integration

Your AI assistant automatically uses MCP tools when appropriate. To help the agent know when to use tools, update your assistant’s description:

You have access to these tools:
- get_customer: Use when you need customer information
- check_order_status: Use when customer asks about an order
- schedule_callback: Use to book follow-up calls

Always greet the customer, then use get_customer to look up their account.

The AI automatically speaks tool results to the customer in a natural way. You don’t need to script how results are presented.

Testing MCP

Test Server Connection

Go to Connections → MCP Servers
Click Test on your server
View discovered tools and verify they’re correct

Make a Test Call

Go to Conversations
Click Test Call
Select a VoiceFlow with MCP enabled
Call yourself and test tool usage

MCP Configuration Options

Setting	Description	Default
URL	Your MCP server’s SSE endpoint	Required
API Key	Authentication token (sent as Bearer)	Optional
Tools Whitelist	Restrict available tools	Empty (all tools)
Timeout	Max time for tool execution	5000ms

Best Practices

Fast Responses: Tools should respond within 5 seconds. Long operations cause awkward pauses in conversation.

Clear Descriptions: Write clear tool descriptions so the AI knows when to use each tool.

Handle Errors Gracefully: Return helpful error messages the AI can communicate to the customer.

Test Thoroughly: Make test calls to verify tools work correctly in real conversations.

Sensitive Data: Be careful with tools that return sensitive information. The AI may speak this to the customer.

Common Use Cases

Use Case	Tools to Implement
Customer Lookup	`get_customer_by_phone`
Order Status	`check_order_status`, `track_shipment`
Appointment Booking	`get_available_slots`, `book_appointment`
CRM Updates	`update_contact`, `add_note`
Knowledge Base	`search_faq`, `get_article`

Example: CRM Integration

A typical CRM MCP server might provide:

Tool	Description
`get_customer`	Look up customer by phone
`get_recent_orders`	List customer’s recent orders
`update_status`	Update customer status (lead → prospect)
`add_note`	Add note to customer record

During a call:

Call starts, agent greets customer
Agent calls get_customer to retrieve their info
Agent personalizes conversation based on customer data
Customer asks about an order, agent calls get_recent_orders
Call ends, agent calls add_note with call summary

Troubleshooting

Tools Not Discovered

Verify server URL is correct (must be SSE endpoint)
Check server is running and accessible
Test the server directly using Preview
Review server logs for connection issues

Tool Execution Failures

Check timeout settings (increase if tools are slow)
Review tool error messages in call logs
Verify tool parameters match the schema
Test tools individually using your MCP server’s interface

Agent Not Using Tools

Update agent description to explain when to use tools
Verify MCP is enabled on the VoiceFlow
Check that tool descriptions are clear
Make test calls to observe agent behavior

Build Your Own MCP Server

Don’t have an existing MCP server? Build your own using automation platforms like n8n, Zapier, or Make. This gives you the freedom to connect your AI assistants to any tool or data source.

n8n

Build MCP endpoints visually

Any API

Connect to any REST API

Your Database

Query your own data

With a custom MCP server you can:

Look up customer data from your CRM
Check inventory or order status
Query your internal databases
Access any API during calls
Build custom tools specific to your business

Automation Workflows Guide

Learn how to build custom MCP servers with n8n and other tools

Next Steps

Configure Webhooks

Send call events to external systems

Configure Assistants

Configure your AI assistant to use MCP tools

Getting Started

Build

Engage

Analyze

Connect

Manage

What is MCP?

How MCP Works in EolasFlow

Setting Up MCP

Step 1: Register an MCP Server

Step 2: Enable MCP on a VoiceFlow

MCP Server Requirements

Tool Definition Format

Tool Execution

Tool Whitelisting

Agent Integration

Testing MCP

Test Server Connection

Make a Test Call

MCP Configuration Options

Best Practices

Common Use Cases

Example: CRM Integration

Troubleshooting

Tools Not Discovered

Tool Execution Failures

Agent Not Using Tools

Build Your Own MCP Server

n8n

Any API

Your Database

Automation Workflows Guide

Next Steps

Configure Webhooks

Configure Assistants

​What is MCP?

​How MCP Works in EolasFlow

​Setting Up MCP

​Step 1: Register an MCP Server

​Step 2: Enable MCP on a VoiceFlow

​MCP Server Requirements

​Tool Definition Format

​Tool Execution

​Tool Whitelisting

​Agent Integration

​Testing MCP

​Test Server Connection

​Make a Test Call

​MCP Configuration Options

​Best Practices

​Common Use Cases

​Example: CRM Integration

​Troubleshooting

​Tools Not Discovered

​Tool Execution Failures

​Agent Not Using Tools

​Build Your Own MCP Server

n8n

Any API

Your Database

Automation Workflows Guide

​Next Steps

Configure Webhooks

Configure Assistants

What is MCP?

How MCP Works in EolasFlow

Setting Up MCP

Step 1: Register an MCP Server

Step 2: Enable MCP on a VoiceFlow

MCP Server Requirements

Tool Definition Format

Tool Execution

Tool Whitelisting

Agent Integration

Testing MCP

Test Server Connection

Make a Test Call

MCP Configuration Options

Best Practices

Common Use Cases

Example: CRM Integration

Troubleshooting

Tools Not Discovered

Tool Execution Failures

Agent Not Using Tools

Build Your Own MCP Server

Next Steps