Copy page

Setup

MCP Server Setup

1. Get your API key

Create an API key at app.neuratel.ai/api-keys. Keys start with nk_live_.

---

2. Install

The recommended approach is zero-install via uvx — no package to maintain, always runs the latest version:

Code
# Verify it works before configuring any client
NEURATEL_API_KEY=nk_live_your_key uvx neuratelai-mcp@latest --help

Or install permanently:

Code
pip install neuratelai-mcp
# or
uv tool install neuratelai-mcp

---

3. Configure your AI client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Restart Claude Desktop. You should see neuratel in the MCP tools panel with 46 tools available.

Claude Code

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

Or add to .mcp.json in your project root, or ~/.claude/mcp.json for global access:

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

Cursor

Edit ~/.cursor/mcp.json:

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

Windsurf

Add to your Codeium MCP configuration (Settings → MCP):

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

---

HTTP transport

For web-based clients, remote deployment, or when you need a persistent server:

Code
# Streamable HTTP (recommended for remote)
NEURATEL_API_KEY=nk_live_... neuratelai-mcp --transport http --port 8000

# SSE (for clients that require it)
NEURATEL_API_KEY=nk_live_... neuratelai-mcp --transport sse --port 8000

# Bind to all interfaces for remote access
NEURATEL_API_KEY=nk_live_... neuratelai-mcp --transport http --host 0.0.0.0 --port 8000

Connect your client to http://your-host:8000/mcp (streamable-http) or http://your-host:8000/sse.

---

Environment variables

Variable	Required	Default	Description
NEURATEL_API_KEY	Yes	—	Your API key (nk_live_...)
NEURATEL_BASE_URL	No	https://api.neuratel.ai/v1	Override the API base URL

---

Troubleshooting

Tools don't appear in Claude Desktop

• Restart Claude Desktop after editing the config — it does not hot-reload
• Validate the config file is valid JSON (no trailing commas, no comments)
• Test the server directly: NEURATEL_API_KEY=nk_live_... uvx neuratelai-mcp@latest

"NEURATEL_API_KEY environment variable is required" error

• The API key must be set in the env block of your MCP config, not just in your shell environment
• Confirm the key starts with nk_live_

Tools return 401 or 403 errors

• Verify the API key is active at app.neuratel.ai/api-keys
• Some operations (e.g. make_call) require the agents:call scope — check your key's permissions

"Command not found: uvx" on Windows

• Install uv from astral.sh/uv
• Or use pip install neuratelai-mcp and change "command": "neuratelai-mcp" with no args