neuratelai-mcp 0.1.1

Neuratel MCP Server — connect AI assistants to Neuratel Studio

neuratelai-mcp

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

27 hand-crafted tools. Every destructive operation carries an explicit cost warning.

Quick Start

NEURATEL_API_KEY=nk_live_... uvx neuratelai-mcp

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"],
      "env": {
        "NEURATEL_API_KEY": "nk_live_your_key_here"
      }
    }
  }
}

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

Claude Code

claude mcp add neuratel -- uvx neuratelai-mcp

Then set your key:

claude mcp add neuratel --env NEURATEL_API_KEY=nk_live_... -- uvx neuratelai-mcp

Cursor / Windsurf

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

{
  "mcpServers": {
    "neuratel": {
      "command": "uvx",
      "args": ["neuratelai-mcp"],
      "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	5	Create, inspect, update, delete agents
Calls	5	Place calls, read transcripts, monitor live, hang up
Campaigns	6	Full campaign lifecycle — create through stop
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

Requirements

Python 3.11+ · uv recommended · Full docs