Copy page

Core Concepts

Integrations

Neuratel uses the Model Context Protocol (MCP) to connect external tools and services to your AI agents. Register an MCP server, and Neuratel automatically discovers its tools — your agents can then call those tools during live conversations.

What is MCP?

MCP (Model Context Protocol) is an open standard for connecting external tools to AI systems. An MCP server exposes a set of tools (functions) that an AI agent can call. Examples:

• A CRM server that exposes lookup_customer, create_ticket, update_record
• A calendar server that exposes check_availability, book_appointment
• A database server that exposes query_inventory, get_order_status

How It Works During a Call

1. The call connects and the agent delivers its greeting.
2. In the background (no latency impact on the greeting), the platform loads the agent's configured MCP tools.
3. When the agent determines it needs to call a tool, it invokes the MCP server.
4. The server processes the request and returns data.
5. The agent incorporates the response into its conversation naturally.

Tool loading happens asynchronously after the greeting, so there is no added latency to the initial response.

Security

MCP servers are called over HTTPS. You can configure:

• Authentication headers — API keys, bearer tokens, or custom headers sent with every request to the MCP server
• Timeout — Maximum time to wait for a tool response (default: 30 seconds)

Credentials are stored using encrypted storage and are never exposed after creation.

Creating an Integration

Register an MCP server with Neuratel:

Code
curl -X POST https://api.neuratel.ai/v1/integrations/mcp \
  -H "Authorization: Bearer nk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "CRM Integration",
    "description": "Salesforce CRM tools for customer lookup and ticket creation",
    "server_url": "https://mcp.example.com/crm",
    "headers": {
      "Authorization": "Bearer crm_api_key_here",
      "X-Workspace-ID": "ws_123"
    },
    "timeout_seconds": 15
  }'

On creation, Neuratel connects to the server, discovers available tools, and stores the tool definitions.

Listing Discovered Tools

After registering an MCP server, view the tools it exposes:

Code
curl https://api.neuratel.ai/v1/integrations/mcp/{integration_id}/tools \
  -H "Authorization: Bearer nk_live_your_api_key"

Code
{
  "tools": [
    {
      "name": "lookup_customer",
      "description": "Look up a customer by phone number or email",
      "parameters": {
        "type": "object",
        "properties": {
          "phone": { "type": "string" },
          "email": { "type": "string" }
        }
      }
    },
    {
      "name": "create_ticket",
      "description": "Create a support ticket in the CRM",
      "parameters": {
        "type": "object",
        "properties": {
          "subject": { "type": "string" },
          "description": { "type": "string" },
          "priority": { "type": "string", "enum": ["low", "medium", "high"] }
        },
        "required": ["subject"]
      }
    }
  ]
}

Refreshing Tools

If the MCP server adds new tools or updates existing ones, refresh the cached definitions:

Code
curl -X POST https://api.neuratel.ai/v1/integrations/mcp/{integration_id}/refresh \
  -H "Authorization: Bearer nk_live_your_api_key"

Testing a Tool

Execute a tool manually to verify it works before assigning the integration to an agent:

Code
curl -X POST https://api.neuratel.ai/v1/integrations/mcp/{integration_id}/execute \
  -H "Authorization: Bearer nk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_name": "lookup_customer",
    "arguments": {
      "phone": "+14155551234"
    }
  }'

Assigning to an Agent

Include the integration ID in the agent's tools.mcp_servers list:

Code
curl -X PUT https://api.neuratel.ai/v1/agents/{agent_id} \
  -H "Authorization: Bearer nk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "config": {
      "tools": {
        "mcp_servers": ["integration-id-1", "integration-id-2"]
      }
    }
  }'

The agent will now have access to all tools from the specified MCP servers during calls.

Full Example

Step 1: Create the Integration

Code
curl -X POST https://api.neuratel.ai/v1/integrations/mcp \
  -H "Authorization: Bearer nk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Order System",
    "server_url": "https://mcp.example.com/orders",
    "headers": {
      "Authorization": "Bearer order_api_key"
    }
  }'

Step 2: Verify Tools

Code
curl https://api.neuratel.ai/v1/integrations/mcp/{integration_id}/tools \
  -H "Authorization: Bearer nk_live_your_api_key"

Step 3: Update Agent to Use It

Code
curl -X PUT https://api.neuratel.ai/v1/agents/{agent_id} \
  -H "Authorization: Bearer nk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "config": {
      "tools": {
        "mcp_servers": ["{integration_id}"]
      }
    }
  }'

Key Operations

Operation	Method	Endpoint
Create integration	POST	/v1/integrations/mcp
List integrations	GET	/v1/integrations/mcp
Get integration	GET	/v1/integrations/mcp/{id}
Update integration	PUT	/v1/integrations/mcp/{id}
Delete integration	DELETE	/v1/integrations/mcp/{id}
List tools	GET	/v1/integrations/mcp/{id}/tools
Refresh tools	POST	/v1/integrations/mcp/{id}/refresh
Execute tool	POST	/v1/integrations/mcp/{id}/execute