Neuron MCP Server

WhatsApp automation platform with 120+ MCP tools for AI-powered chatbots, broadcasts, campaigns, and more.

What is Neuron?

Neuron is an AI-powered WhatsApp automation platform. This MCP server exposes 120+ tools that let AI coding assistants — Claude Code, Cursor, Windsurf, and other MCP-compatible clients — manage your entire WhatsApp business programmatically.

Build chatbots, send broadcasts, manage contacts, create campaigns, publish newsletters, and more — all through natural language with your AI assistant.

Quick Start

Option 1: Remote Server (Recommended — zero install)

Add to your MCP client config:

{
  "mcpServers": {
    "neuron": {
      "type": "url",
      "url": "https://mcp.neuron.ng/mcp"
    }
  }
}

No installation required. Works immediately with any MCP client that supports Streamable HTTP.

Option 2: Local Server (via npm)

Run directly with npx:

npx neuron-mcp-server

Or install globally:

npm install -g neuron-mcp-server

Claude Code config (~/.claude/mcp.json):

{
  "mcpServers": {
    "neuron": {
      "command": "npx",
      "args": ["-y", "neuron-mcp-server"]
    }
  }
}

Authentication

Three ways to authenticate:

1. Browser Login (Recommended)

Call neuron_login() with no arguments. The server returns a URL — open it in your browser to authorize securely. No credentials are shared with the AI.

2. MCP Token

Generate a token from your Neuron dashboard (Settings > MCP Tokens), then:

neuron_login({ token: "your-mcp-token" })

3. Environment Variable

Set NEURON_AUTH_TOKEN for unattended/CI use:

NEURON_AUTH_TOKEN=your-token npx neuron-mcp-server

Available Tools (120+)

Category	Tools	Description
Authentication	8	Login, register, org switching, profile management
Bot Management	7	Create and manage AI chatbots with configurable LLM models
Conversations	11	Message management, human takeover, send WhatsApp messages
Knowledge Bases	14	Upload documents, semantic search, sync, ingest content
Contacts	12	CRUD operations, import/export, semantic search, sync
Contact Lists	11	Segmentation, merge, membership management
Channels	17	WhatsApp connections, QR pairing, session management
Broadcasts	7	Bulk messaging to contact lists
Campaigns	14	Sponsored campaigns, marketplace, funding
Newsletters	8	WhatsApp Channel/newsletter management
Webhooks	8	Inbound and outbound webhook management
Custom Tools	6	HTTP API tools for bots with secret injection
Blog	6	Content publishing
Organizations	7	Team management, audit logs, member invitations
Billing & Wallet	12	Subscriptions, wallet, payouts, bank accounts
Marketplace	8	Publish and install bots and contact lists
Reflections	4	Self-learning bot improvement suggestions
Media & AI	2	Upload media, AI text rewriting

Environment Variables

Variable	Description	Default
NEURON_API_URL	API base URL	https://api.neuron.ng/api/v1
NEURON_AUTH_TOKEN	Pre-set auth token	—
MCP_TRANSPORT	Transport mode: stdio or http	stdio
PORT	HTTP server port (when using http transport)	3001

IDE Setup

Claude Code

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "neuron": {
      "command": "npx",
      "args": ["-y", "neuron-mcp-server"]
    }
  }
}

Or use the remote server:

{
  "mcpServers": {
    "neuron": {
      "type": "url",
      "url": "https://mcp.neuron.ng/mcp"
    }
  }
}

Cursor

Settings > MCP Servers > Add Streamable HTTP

URL: https://mcp.neuron.ng/mcp

Windsurf

Settings > AI > MCP Servers > Add

Use either the remote URL or local npx command.

Development

git clone https://github.com/conquext/neuron-mcp-server.git
cd neuron-mcp-server
npm install
npm run dev

Links

• Website: neuron.ng
• Documentation: neuron.ng/docs
• MCP Server Docs: neuron.ng/docs/mcp-server
• npm: npmjs.com/package/neuron-mcp-server

Free to start — no credit card required.

License

MIT