Neuratel AI — MCP Server

PyPI Python Docs

Official MCP Server for Neuratel Studio — control your voice AI platform through natural language from Claude, Cursor, Windsurf, and any MCP-compatible assistant.

46 hand-crafted tools across 11 domains. Every destructive operation carries an explicit cost warning.

Quick Start

NEURATEL_API_KEY=nk_live_... uvx neuratelai-mcp@latest

Or install permanently:

pip install neuratelai-mcp

Claude Desktop Setup

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "neuratel": {
      "command": "uvx",
      "args": ["neuratelai-mcp@latest"],
      "env": {
        "NEURATEL_API_KEY": "nk_live_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. You'll see neuratel in the tools panel with 46 tools available.

Claude Code

claude mcp add neuratel -e NEURATEL_API_KEY=nk_live_... -- uvx neuratelai-mcp@latest

Cursor / Windsurf

Add to ~/.cursor/mcp.json (Cursor) or Codeium MCP config (Windsurf):

{
  "mcpServers": {
    "neuratel": {
      "command": "uvx",
      "args": ["neuratelai-mcp@latest"],
      "env": {
        "NEURATEL_API_KEY": "nk_live_your_key_here"
      }
    }
  }
}

HTTP / SSE Transport

For remote deployment or web-based clients:

NEURATEL_API_KEY=nk_live_... neuratelai-mcp --transport http --port 8000

Connect to http://your-host:8000/mcp.

Environment Variables

Variable	Required	Default
`NEURATEL_API_KEY`	Yes	—
`NEURATEL_BASE_URL`	No	`https://api.neuratel.ai/v1`

Tools

Domain	Count	What you can do
Agents	8	Create, list, inspect, update, delete, duplicate agents; list templates; get required variables
Calls	5	Place calls, list/get calls, monitor live sessions, hang up
Campaigns	6	Full campaign lifecycle — create, start, pause, stop
Conversations	8	Unified inbox — list, get, send messages, timeline, analytics, variables
DNC	6	Check, list, add, delete entries; get/update settings
Numbers	3	List numbers, assign and unassign agents
Knowledge Base	4	Add content from text or URL, attach to agent
Billing	2	Check balance, view usage
Webhooks	2	Create and list event subscriptions
Analytics	1	Combined voice + chat dashboard KPIs
Variables	1	System variables catalog for dynamic_variables validation

Requirements

Python 3.11+ · uv recommended

Neuratel MCP Server