Neuron MCP Server
Neuron MCP Server lets AI assistants manage a full WhatsApp business automation platform end-to-end via 300+ MCP tools.
Authenticate & manage accounts – register, login with browser/token, switch organizations, manage profile
Build AI chatbots – create, configure, pause, resume, and delete bots with custom prompts and LLM settings
Handle conversations & messaging – send/receive WhatsApp messages, compose messages, edit/delete, take over or release conversations, close chats
Manage channels & WhatsApp sessions – connect Meta Cloud API or Baileys channels, QR/pair-code, start/stop sessions, list groups and contacts
Manage contacts & lists – CRUD, import/export, segment, merge, sync contacts and contact lists
Run broadcasts, campaigns & list campaigns – bulk messaging, sponsored campaigns, marketplace/funding, paced per-run sends
Create knowledge bases – upload documents, add entries, semantic search, sync, ingest content, attach to bots
Use custom tools & webhooks – define HTTP tools, add secrets, create inbound webhooks, inspect logs
Automate with flows, tasks & scheduling – event-driven flows, scheduled bot tasks and messages
Manage groups, newsletters, media & AI – group administration, WhatsApp channels/newsletters, media upload, AI rewriting
Marketplace & pool – browse, publish, install, fork/subscribe bots, tools, knowledge bases, and reflections
Monitor and improve – bot analytics, self-learning reflections, approve/reject improvements, audit logs
Administer organization, billing, and team – org details, WhatsApp credentials, team invites, subscriptions, wallet, payouts
Provides tools for WhatsApp automation including chatbots, broadcasts, campaigns, contact management, newsletters, and more through the Neuron platform.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Neuron MCP Server send broadcast to my VIP list saying 'Exclusive offer just for you!'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Neuron MCP Server
WhatsApp automation platform with 300+ 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 300+ 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.
Related MCP server: MCP WhatsApp
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-serverOr install globally:
npm install -g neuron-mcp-serverClaude 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-serverAvailable Tools (300+)
Category | Tools | Description |
Authentication | 9 | Login, register, org switching, token refresh |
Bot Management | 11 | Create and manage AI chatbots with configurable LLM models |
Conversations & Messaging | 20 | Message management, human takeover, send WhatsApp messages, polls |
Approvals | 5 | Human-in-the-loop approve/reject over WhatsApp |
Channels & Sessions | 19 | WhatsApp connections, QR/pair-code, session management |
Social Channels | 11 | Post to X, Instagram, Facebook, LinkedIn, TikTok |
Broadcasts | 7 | Bulk messaging to contact lists |
Campaigns | 16 | Sponsored campaigns, marketplace, funding |
List Campaigns | 8 | Paced, per-run messaging to list members |
Contacts | 12 | CRUD, import/export, semantic search, sync |
Contact Lists | 11 | Segmentation, merge, membership management |
Leads | 7 | Multi-source lead capture, pool, convert |
Knowledge Bases | 14 | Upload documents, semantic search, sync, ingest content |
Newsletters | 9 | WhatsApp Channel/newsletter management |
Products & Sales | 17 | Sell products, checkout, orders, delivery, memberships |
Flows | 11 | Event-driven automation flows and runs |
Tasks & Scheduling | 12 | Scheduled autonomous bot tasks and messages |
Personas | 9 | Build and apply voice personas |
Group Management | 11 | Create groups, manage members, settings |
Webhooks | 10 | Inbound and outbound webhook management |
Custom Tools | 10 | HTTP API tools for bots with secret injection |
Bot API | 8 | Bot-scoped API keys, chat and messaging |
Marketplace & Pool | 23 | Publish and install bots, tools, and contact lists |
Blog | 6 | Content publishing |
Organizations & Audit | 11 | Team management, audit logs, member invitations |
Billing & Wallet | 12 | Subscriptions, wallet, payouts, bank accounts |
Profile & Privacy | 10 | Profile name/status/picture, privacy settings |
Reflections | 4 | Self-learning bot improvement suggestions |
Media & AI | 2 | Upload media, AI text rewriting |
Environment Variables
Variable | Description | Default |
| API base URL |
|
| Pre-set auth token | — |
| Transport mode: |
|
| HTTP server port (when using |
|
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 devLinks
Website: neuron.ng
Documentation: neuron.ng/docs
MCP Server Docs: neuron.ng/docs/mcp-server
Free to start — no credit card required.
License
Available Tools
195 toolsneuron_add_bot_channelAdd Bot ChannelB
Connect an additional WhatsApp channel to a bot as a secondary number
Inputs: botId (required), channelId (required).
neuron_add_to_contact_listAdd to Contact ListA
Add contacts to a list by contact ID or phone number. Phone numbers without existing contacts are auto-created as minimal contacts.
Inputs: entries (required), idOrSlug (required).
neuron_add_tool_secretAdd Tool SecretA
Add or update a secret (API key, token, etc.) for a tool integration
Inputs: id (required), key (required), value (required).
neuron_approve_reflectionApprove ReflectionA
Approve a bot reflection to incorporate it into the bot's learning and behavior
Inputs: id (required).
neuron_assign_bot_to_channelAssign Bot to ChannelB
Assign a bot to handle messages on a specific WhatsApp channel
Inputs: id (required), botId (required).
neuron_attach_knowledge_baseAttach Knowledge BaseA
Attach a knowledge base to a bot to enhance its responses with specific domain knowledge. Optional priority determines retrieval order.
Inputs: id (required), knowledgeBaseId (required), priority.
neuron_audio_contactExtract Contact from AudioA
Transcribe an audio recording and extract contact information (name, phone, email, notes, tags). Auto-saves the contact. Provide base64-encoded audio data.
Inputs: audioBase64 (required), audioFormat.
neuron_bot_api_chatBot API ChatC
Send a chat message to the bot API as a contact and receive an AI-generated response. Requires a valid API key with 'nrn_' prefix.
Inputs: apiKey (required), message (required), contactPhone (required), contactName.
neuron_bot_api_get_botBot API Get BotB
Retrieve information about the bot associated with the provided API key including its configuration and status.
Inputs: apiKey (required).
neuron_bot_api_get_messagesBot API Get MessagesB
Retrieve message history for a specific conversation with pagination support. Requires a valid API key.
Inputs: apiKey (required), conversationId (required), limit, before.
neuron_bot_api_list_conversationsBot API List ConversationsA
Retrieve a list of conversations managed by the bot. Supports filtering by status and pagination. Requires a valid API key.
Inputs: apiKey (required), page, limit, status.
neuron_bot_api_sendBot API SendB
Send an outbound message through the bot API to a specified phone number. Supports text and media messages. Requires a valid API key.
Inputs: to (required), apiKey (required), message (required), mediaUrl, +2 more.
neuron_browse_list_poolBrowse List PoolARead-only
Browse verified contact lists available in the marketplace pool. Filter by category or region.
Inputs: page, limit, region, search, +1 more.
neuron_browse_poolBrowse PoolC
Browse the marketplace/pool to discover shared bots, tools, knowledge bases, and reflections. Supports filtering and search.
Inputs: page, tags, type, limit, +3 more.
neuron_bulk_toggle_builtin_toolsBulk Toggle Built-in ToolsA
Enable or disable multiple built-in tools at once for a bot. Pass an array of { toolId, enabled } settings.
Inputs: botId (required), settings (required).
neuron_campaign_marketplaceBrowse Campaign MarketplaceBRead-only
Browse available campaigns that you can join and earn from
Inputs: page, limit.
neuron_campaign_participantsList Campaign ParticipantsARead-only
List participants of a campaign you own
Inputs: id (required).
neuron_cancel_subscriptionCancel SubscriptionADestructive
Cancel the current active subscription. The subscription will remain active until the end of the billing period.
Inputs: no named parameters.
neuron_checkoutCheckout SubscriptionA
Start a checkout session for a subscription plan. Returns a checkout URL or confirmation.
Inputs: plan (required).
neuron_close_conversationClose ConversationCDestructiveIdempotent
Close an active conversation, marking it as completed
Inputs: id (required).
neuron_compose_messageCompose MessageC
Compose and send a new message to a phone number, starting a new conversation if one does not exist
Inputs: to (required), text (required), channelId (required), mediaUrl, +2 more.
neuron_create_ad_requestCreate Ad RequestC
Create an ad request to distribute a message to contacts in pool lists matching target demographics.
Inputs: budget (required), message (required), targetGoal (required), targetDemographics (required), +2 more.
neuron_create_api_keyCreate API KeyA
Generate a new API key for a bot to enable programmatic access. The key will have an 'nrn_' prefix and can optionally expire at a specified date.
Inputs: name (required), botId (required), expiresAt.
neuron_create_blog_postCreate Blog PostC
Create a new blog post (draft or published)
Inputs: title (required), content (required), authorType (required), tags, +6 more.
neuron_create_botCreate BotC
Create a new bot with specified configuration including name, system prompt, and optional parameters like model, temperature, and phone number.
Inputs: name (required), systemPrompt (required), llmModel, maxTokens, +7 more.
neuron_create_broadcastCreate BroadcastB
Create a new broadcast message. Provide recipients directly OR use recipientSources to resolve from contact lists. Channel is auto-resolved if not specified.
Inputs: name (required), message (required), mediaUrl, channelId, +3 more.
neuron_create_campaignCreate CampaignB
Create a new draft campaign. Requires Pro or Business plan.
Inputs: title (required), message (required), deadline (required), totalBudget (required), +4 more.
neuron_create_channelCreate ChannelA
Create a new WhatsApp channel. Supports Meta Cloud API or Baileys (direct WhatsApp) integration.
Inputs: name (required), type (required), phoneNumber, metaAccessToken, +1 more.
neuron_create_contactCreate ContactA
Create a new contact. If notes are provided, they are saved as a structured note entry with source tracking.
Inputs: name (required), phone (required), tags, email, +1 more.
neuron_create_contact_listCreate Contact ListA
Create a new contact list. Slug is auto-generated from name if not provided. For dynamic lists, provide criteria with rules and/or aiPrompt.
Inputs: name (required), slug, type, criteria, +2 more.
neuron_create_kb_entryCreate Knowledge Base EntryB
Add a new entry (note, document, or information piece) to a knowledge base.
Inputs: id (required), title (required), content (required), folder, +2 more.
neuron_create_knowledge_baseCreate Knowledge BaseB
Create a new knowledge base to store and organize information, documents, and entries.
Inputs: name (required), description, rootInstruction.
neuron_create_newsletterCreate NewsletterB
Create a new WhatsApp Channel (newsletter) for one-way broadcast updates. Requires a connected Baileys session.
Inputs: name (required), channelId (required), description.
neuron_create_outbound_webhookCreate Outbound WebhookA
Create a new outbound webhook that fires HTTP requests when bot events occur. Events: message.created, message.assistant, conversation.created, conversation.escalated, conversation.closed, bot.paused, bot.resumed.
Inputs: url (required), name (required), botId (required), eventTypes (required), +1 more.
neuron_create_toolCreate ToolC
Create a new tool integration for a bot to call external HTTP APIs and webhooks
Inputs: name (required), type (required), botId (required), config (required), +4 more.
neuron_create_webhookCreate WebhookA
Create a new inbound webhook that triggers bot actions when called
Inputs: name (required), botId (required), slug, isActive, +2 more.
neuron_delete_blog_postDelete Blog PostC
Delete a blog post
Inputs: id (required).
neuron_delete_botDelete BotA
Permanently delete a bot and all its associated data. This action cannot be undone.
Inputs: id (required).
neuron_delete_broadcastDelete BroadcastADestructive
Delete a broadcast. This action cannot be undone.
Inputs: id (required).
neuron_delete_campaignDelete CampaignBDestructive
Delete a draft campaign
Inputs: id (required).
neuron_delete_channelDelete ChannelA
Delete a WhatsApp channel from the system. This action cannot be undone.
Inputs: id (required).
neuron_delete_contactDelete ContactADestructive
Permanently delete a contact. This action cannot be undone.
Inputs: id (required).
neuron_delete_contact_listDelete Contact ListADestructive
Delete a contact list. System lists (like 'Do Not Contact') cannot be deleted.
Inputs: idOrSlug (required).
neuron_delete_kb_entryDelete Knowledge Base EntryADestructiveIdempotent
Permanently delete a specific entry from a knowledge base.
Inputs: kbId (required), entryId (required).
neuron_delete_knowledge_baseDelete Knowledge BaseADestructiveIdempotent
Permanently delete a knowledge base and all its associated entries and documents.
Inputs: id (required).
neuron_delete_messageDelete MessageADestructive
Delete a specific message from a conversation. This action cannot be undone.
Inputs: id (required), msgId (required).
neuron_delete_newsletterDelete NewsletterA
Delete a WhatsApp Channel newsletter. This action cannot be undone.
Inputs: id (required).
neuron_delete_outbound_webhookDelete Outbound WebhookADestructive
Delete an outbound webhook
Inputs: id (required).
neuron_delete_toolDelete ToolB
Delete a tool integration from a bot
Inputs: id (required).
neuron_delete_webhookDelete WebhookA
Delete an inbound webhook from a bot
Inputs: id (required).
neuron_detach_knowledge_baseDetach Knowledge BaseA
Remove a knowledge base from a bot. The bot will no longer use this knowledge base for responses.
Inputs: id (required), kbId (required).
neuron_edit_messageEdit MessageA
Edit the content of a previously sent message in a conversation
Inputs: id (required), msgId (required), content (required).
neuron_export_contactsExport ContactsBRead-only
Export all contacts from the system
Inputs: no named parameters.
neuron_find_contact_lists_for_contactFind Contact Lists for ContactARead-only
Find which contact lists a specific contact belongs to
Inputs: contactId (required).
neuron_fund_campaignFund CampaignB
Fund an approved campaign from your wallet balance
Inputs: id (required).
neuron_fund_walletFund WalletA
Initialize wallet funding via Paystack. Returns a checkout URL to complete payment.
Inputs: email (required), amount (required).
neuron_get_ad_request_analyticsGet Ad Request AnalyticsARead-only
Get delivery analytics and breakdown for an ad request.
Inputs: adRequestId (required).
neuron_get_bank_accountGet Bank AccountARead-only
Get the saved bank account for payouts
Inputs: no named parameters.
neuron_get_billingGet Billing InfoARead-only
Get the current billing information, subscription status, and usage details for the organization
Inputs: no named parameters.
neuron_get_blog_postGet Blog PostB
Get a blog post by slug
Inputs: slug (required).
neuron_get_botGet BotA
Retrieve detailed information about a specific bot by ID including its configuration, status, and associated resources.
Inputs: id (required).
neuron_get_bot_analyticsGet Bot AnalyticsA
Retrieve analytics and usage statistics for a specific bot including message counts, response times, and conversation metrics.
Inputs: id (required).
neuron_get_broadcastGet BroadcastBRead-only
Get detailed information about a specific broadcast by ID
Inputs: id (required).
neuron_get_broadcast_recipientsGet Broadcast RecipientsARead-only
Get the list of recipients for a specific broadcast with delivery status
Inputs: id (required), page, limit, status.
neuron_get_campaignGet CampaignBRead-only
Get detailed information about a specific campaign
Inputs: id (required).
neuron_get_channelGet ChannelC
Get detailed information about a specific WhatsApp channel
Inputs: id (required).
neuron_get_channel_eventsGet Channel EventsBRead-only
Get the event log for a channel (connection events, message events, errors, etc.)
Inputs: id (required), page, limit.
neuron_get_channel_qrGet Channel QR CodeB
Get the QR code for pairing a Baileys channel with WhatsApp. Scan with WhatsApp mobile app.
Inputs: id (required).
neuron_get_channel_statusGet Channel StatusB
Get the current session status of a WhatsApp channel (connected, disconnected, etc.)
Inputs: id (required).
neuron_get_contactGet ContactARead-only
Get detailed information about a specific contact by ID
Inputs: id (required).
neuron_get_contact_listGet Contact ListARead-only
Get a contact list by ID or slug, including member count
Inputs: idOrSlug (required).
neuron_get_contact_list_membersGet Contact List MembersARead-only
List members of a contact list with search and pagination
Inputs: idOrSlug (required), page, limit, search.
neuron_get_conversationGet ConversationBRead-onlyIdempotent
Retrieve detailed information about a specific conversation by its ID
Inputs: id (required).
neuron_get_eligible_contactsGet Eligible ContactsARead-only
Get contacts eligible for receiving a campaign message (respects dedup and mutual contact rules)
Inputs: id (required).
neuron_get_group_participantsGet Group ParticipantsBRead-only
Get the list of participants in a specific WhatsApp group on a channel
Inputs: id (required), groupJid (required).
neuron_get_knowledge_baseGet Knowledge BaseARead-onlyIdempotent
Retrieve detailed information about a specific knowledge base by its ID.
Inputs: id (required).
neuron_get_messagesGet Conversation MessagesBRead-onlyIdempotent
Retrieve messages from a specific conversation with optional pagination
Inputs: id (required), limit, cursor.
neuron_get_newsletterGet NewsletterARead-only
Get details of a specific WhatsApp Channel newsletter
Inputs: id (required).
neuron_get_organizationGet OrganizationARead-only
Get details of a specific organization by ID
Inputs: orgId (required).
neuron_get_outbound_webhook_logsGet Outbound Webhook LogsARead-only
Retrieve delivery logs for an outbound webhook to monitor and debug event delivery
Inputs: id (required), page, limit.
neuron_get_pool_itemGet Pool ItemB
Get detailed information about a specific item in the marketplace/pool
Inputs: id (required).
neuron_get_profileGet User ProfileARead-only
Get the authenticated user's profile information
Inputs: no named parameters.
neuron_get_webhook_logsGet Webhook LogsA
Retrieve execution logs for a webhook to monitor activity and debug issues
Inputs: id (required), page, limit.
neuron_import_contactsImport ContactsB
Import multiple contacts at once. Provide an array of contact objects.
Inputs: contacts (required).
neuron_ingest_knowledgeIngest KnowledgeBIdempotent
Ingest content into a knowledge base. Supports deduplication via externalId and optional LLM processing (summarize, extract_facts, or custom instruction).
Inputs: title (required), content (required), knowledgeBaseId (required), folder, +4 more.
neuron_install_from_poolInstall from PoolA
Install a resource from the marketplace/pool. Choose 'fork' to create an independent copy or 'subscribe' to receive updates.
Inputs: id (required), mode.
neuron_invite_memberInvite Organization MemberB
Invite a new member to the organization with email, name, and optional role
Inputs: name (required), email (required), orgId (required), role, +1 more.
neuron_join_campaignJoin CampaignB
Join a campaign from the marketplace to earn rewards by sending messages
Inputs: id (required), channelId (required).
neuron_list_ad_requestsList Ad RequestsBRead-only
List your ad requests with optional status filter.
Inputs: page, limit, status.
neuron_list_api_keysList API KeysA
Retrieve all API keys associated with a specific bot including their names, creation dates, expiration dates, and revocation status.
Inputs: botId (required).
neuron_list_audit_logsList Audit LogsARead-only
Retrieve audit logs with optional filtering by page, limit, action, and resource type
Inputs: page, limit, action, resourceType.
neuron_list_blog_postsList Blog PostsC
List blog posts with filters
Inputs: tag, page, limit, status, +2 more.
neuron_list_bot_channelsList Bot ChannelsA
List all WhatsApp channels connected to a bot, including primary and secondary connections
Inputs: botId (required).
neuron_list_bot_knowledge_basesList Bot Knowledge BasesA
Retrieve all knowledge bases attached to a specific bot along with their priorities and metadata.
Inputs: id (required).
neuron_list_botsList BotsA
Retrieve a list of all bots in the system with their configurations and status.
Inputs: no named parameters.
neuron_list_broadcastsList BroadcastsARead-only
List all broadcasts with optional filtering by status and pagination
Inputs: page, limit, status.
neuron_list_builtin_toolsList Built-in ToolsARead-only
List all built-in tools with their enabled/disabled status for a specific bot. Built-in tools include WhatsApp actions (send messages, delete messages, post status), utility functions (web search, QR codes, weather), scheduling, knowledge base search, and more.
Inputs: botId (required).
neuron_list_campaignsList CampaignsBRead-only
List your organization's campaigns with optional status filter
Inputs: page, limit, status.
neuron_list_channel_groupsList Channel GroupsARead-only
List all WhatsApp groups that the channel is participating in
Inputs: id (required).
neuron_list_channelsList ChannelsA
List all WhatsApp channels configured in the Neuron system
Inputs: no named parameters.
neuron_list_contact_listsList Contact ListsARead-only
List all contact lists with optional search, type filter, and pagination
Inputs: page, type, limit, search.
neuron_list_contactsList ContactsBRead-only
List contacts with optional filtering by search term, tag, and pagination
Inputs: tag, page, limit, search.
neuron_list_conversationsList ConversationsARead-onlyIdempotent
Retrieve a list of conversations for a specific bot with optional filtering by status and pagination
Inputs: botId (required), limit, cursor, status.
neuron_list_installedList Installed ItemsB
List all items you have installed from the marketplace/pool
Inputs: no named parameters.
neuron_list_invitationsList InvitationsARead-only
List all pending invitations for the organization
Inputs: orgId (required).
neuron_list_kb_botsList Knowledge Base BotsARead-onlyIdempotent
Retrieve all bots that are connected to or using a specific knowledge base.
Inputs: id (required).
neuron_list_kb_entriesList Knowledge Base EntriesARead-onlyIdempotent
Retrieve entries from a knowledge base with optional filtering and pagination.
Inputs: id (required), page, limit, folder, +1 more.
neuron_list_knowledge_basesList Knowledge BasesARead-onlyIdempotent
Retrieve all knowledge bases accessible to the current user.
Inputs: no named parameters.
neuron_list_membersList Organization MembersARead-only
Get a list of all members in the organization
Inputs: orgId (required).
neuron_list_newslettersList NewslettersARead-only
List all WhatsApp Channel newsletters for the organization. Optionally filter by WhatsApp session channel ID.
Inputs: page, limit, channelId.
neuron_list_organizationsList OrganizationsARead-only
List all organizations the authenticated user belongs to
Inputs: no named parameters.
neuron_list_outbound_webhooksList Outbound WebhooksARead-only
List all outbound webhooks configured for a specific bot
Inputs: botId (required).
neuron_list_payoutsList PayoutsCRead-only
List payout history
Inputs: page, limit.
neuron_list_publishedList My Published ItemsB
List all items you have published to the marketplace/pool
Inputs: no named parameters.
neuron_list_reflectionsList ReflectionsA
List self-learning reflections generated by a bot, optionally filtered by status
Inputs: botId (required), status.
neuron_list_toolsList ToolsB
List all tool integrations for a specific bot
Inputs: botId (required).
neuron_list_webhooksList WebhooksA
List all inbound webhooks configured for a specific bot
Inputs: botId (required).
neuron_list_whatsapp_contactsList WhatsApp ContactsARead-only
List contacts from the WhatsApp account connected to this channel
Inputs: id (required), q.
neuron_loginLogin to NeuronA
Authenticate with Neuron. Three modes:
No args: Opens a browser URL for secure authorization (recommended — no credentials shared with AI)
token: Paste an MCP token from the Neuron dashboard
email+password: Legacy login (credentials visible to AI)
Inputs: no named parameters.
neuron_logoutLogoutA
Clear the current auth token locally. Does NOT revoke server-side MCP tokens — revoke from the Neuron dashboard (Settings > MCP Tokens) for full invalidation.
Inputs: no named parameters.
neuron_merge_contact_listsMerge Contact ListsA
Create a new list by merging multiple source lists. Window merge creates a virtual union; materialized merge creates a static copy.
Inputs: name (required), mergeType (required), sourceListIds (required), slug.
neuron_my_participationsMy Campaign ParticipationsCRead-only
List campaigns you have joined as a participant
Inputs: page, limit.
neuron_pause_botPause BotB
Pause a bot's operations temporarily. The bot will stop responding to messages until resumed.
Inputs: id (required).
neuron_pause_campaignPause CampaignB
Pause an active campaign
Inputs: id (required).
neuron_populate_contactsPopulate ContactsB
Populate contacts with additional data from connected channels
Inputs: no named parameters.
neuron_post_to_newsletterPost to NewsletterA
Post a message (text, image, video, or document) to a WhatsApp Channel newsletter. All subscribers will receive the message. Provide at least one of text or mediaUrl.
Inputs: id (required), text, mediaUrl, messageType.
neuron_publish_blog_postPublish Blog PostC
Publish a draft post
Inputs: id (required).
neuron_publish_to_poolPublish to PoolB
Publish a bot, tool, knowledge base, or reflection to the marketplace/pool for others to discover and use
Inputs: title (required), resourceId (required), resourceType (required), tags, +2 more.
neuron_pull_pool_updatePull Pool UpdateA
Pull the latest updates for a subscribed pool resource. Only applies to items installed with 'subscribe' mode.
Inputs: installId (required).
neuron_refresh_contact_listRefresh Contact ListA
Trigger a refresh of a dynamic contact list. Re-evaluates criteria rules and/or AI prompt, materializes updated members.
Inputs: idOrSlug (required).
neuron_refresh_newsletterRefresh NewsletterA
Re-fetch metadata (name, description, subscriber count) for a WhatsApp Channel newsletter from WhatsApp
Inputs: id (required).
neuron_refresh_tokenRefresh Access TokenA
Refresh the access token using a refresh token. Automatically sets the new access token.
Inputs: refreshToken (required).
neuron_registerRegister New UserB
Register a new user account with name, email, password, and organization name
Inputs: name (required), email (required), orgName (required), password (required).
neuron_reject_reflectionReject ReflectionA
Reject a bot reflection to prevent it from being incorporated into the bot's behavior
Inputs: id (required).
neuron_release_conversationRelease ConversationAIdempotent
Release a conversation back to the bot, returning control from a human agent
Inputs: id (required).
neuron_remove_bot_channelRemove Bot ChannelB
Disconnect a WhatsApp channel from a bot
Inputs: botId (required), channelId (required).
neuron_remove_from_contact_listRemove from Contact ListADestructive
Remove contacts from a list by their contact IDs
Inputs: idOrSlug (required), contactIds (required).
neuron_remove_memberRemove Organization MemberBDestructive
Remove a member from the organization
Inputs: orgId (required), userId (required).
neuron_remove_tool_secretRemove Tool SecretB
Remove a secret from a tool integration
Inputs: id (required), key (required).
neuron_request_pair_codeRequest Pair CodeB
Request a pairing code for a Baileys channel instead of using QR code. Useful for linking with a phone number.
Inputs: id (required), phoneNumber (required).
neuron_request_payoutRequest PayoutB
Request a payout from your wallet to your saved bank account
Inputs: amount (required).
neuron_resume_botResume BotA
Resume a paused bot's operations. The bot will start responding to messages again.
Inputs: id (required).
neuron_resume_campaignResume CampaignC
Resume a paused campaign
Inputs: id (required).
neuron_revoke_api_keyRevoke API KeyA
Revoke an API key to immediately invalidate it and prevent further use. This action cannot be undone.
Inputs: botId (required), keyId (required).
neuron_revoke_invitationRevoke InvitationADestructive
Revoke a pending invitation so it can no longer be accepted
Inputs: orgId (required), invitationId (required).
neuron_rewrite_textRewrite TextB
Use AI to rewrite or transform text based on an optional instruction (e.g., make it more formal, translate, summarize)
Inputs: text (required), instruction.
neuron_save_bank_accountSave Bank AccountB
Save a verified bank account for payouts
Inputs: bankCode (required), bankName (required), accountName (required), accountNumber (required).
neuron_search_contactsSearch ContactsARead-only
Search contacts by a query string across name, phone, and email fields
Inputs: q (required).
neuron_search_knowledgeSearch KnowledgeARead-onlyIdempotent
Perform semantic search across all entries and documents in a knowledge base to find relevant information.
Inputs: q (required), id (required), limit.
neuron_semantic_search_contactsSemantic Search ContactsARead-only
Search contacts using natural language AI-powered semantic search. Finds contacts based on the meaning of their notes — skills, services, schedules, preferences, etc. Returns ranked results with relevance scores and AI-generated match reasons.
Inputs: query (required), limit.
neuron_send_broadcastSend BroadcastA
Send a broadcast to all its recipients. The broadcast must be in draft status.
Inputs: id (required).
neuron_send_campaign_messageSend Campaign MessagesC
Send the campaign message to selected eligible contacts
Inputs: id (required), contactIds (required).
neuron_send_messageSend MessageC
Send a message to a specific conversation
Inputs: id (required), content (required), mediaUrl, messageType.
neuron_send_whatsappSend WhatsApp MessageA
Send a WhatsApp message to a phone number or group. Auto-resolves which WhatsApp channel to use (org default channel > first connected channel). Optionally attach media.
Inputs: to (required), text (required), mediaUrl, channelId, +2 more.
neuron_set_default_channelSet Default WhatsApp ChannelA
Set the default WhatsApp channel for the organization. Used by neuron_send_whatsapp for auto-resolving which channel to send through. Pass null to clear.
Inputs: orgId (required), channelId (required).
neuron_start_channel_sessionStart Channel SessionA
Start a Baileys (direct WhatsApp) session for the channel. Generates QR code for pairing.
Inputs: id (required).
neuron_stop_campaignStop CampaignBDestructive
Stop an active campaign and refund remaining budget to wallet
Inputs: id (required).
neuron_stop_channel_sessionStop Channel SessionA
Stop the active Baileys session for the channel and disconnect from WhatsApp
Inputs: id (required).
neuron_submit_campaignSubmit Campaign for ReviewA
Submit a draft campaign for admin review
Inputs: id (required).
neuron_submit_to_list_poolSubmit List to PoolC
Submit a contact list to the marketplace pool for advertisers to use.
Inputs: listId (required), category (required), channelId (required), pricePerDelivery (required), +2 more.
neuron_switch_orgSwitch OrganizationA
Switch to a different organization. Returns a new access token and automatically sets it.
Inputs: orgId (required).
neuron_sync_knowledgeSync KnowledgeAIdempotent
Trigger a synchronization operation to refresh embeddings, reindex content, or update the knowledge base state.
Inputs: id (required).
neuron_sync_newslettersSync NewslettersB
Sync/import WhatsApp Channels from a connected WhatsApp session into Neuron. This discovers channels created outside Neuron.
Inputs: channelId (required).
neuron_sync_reflectionsSync ReflectionsA
Synchronize and update the bot's knowledge base with all approved reflections
Inputs: botId (required).
neuron_sync_whatsapp_contactsSync WhatsApp ContactsB
Synchronize contacts from connected WhatsApp channels into the contacts database
Inputs: no named parameters.
neuron_takeover_conversationTakeover ConversationAIdempotent
Take over a conversation, transferring control from the bot to a human agent
Inputs: id (required).
neuron_test_toolTest ToolB
Test a tool integration with sample arguments to verify it works correctly
Inputs: id (required), args (required).
neuron_toggle_builtin_toolToggle Built-in ToolA
Enable or disable a specific built-in tool for a bot. Example tool IDs: delete_message, post_to_channel, post_status, web_search, send_direct_message, react_to_message, set_reminder, create_poll, etc.
Inputs: botId (required), toolId (required), enabled (required).
neuron_toggle_featuredToggle Featured StatusA
Toggle the featured status of a pool item. Featured items appear prominently in the marketplace. (Admin operation)
Inputs: id (required).
neuron_unassign_bot_from_channelUnassign Bot from ChannelB
Remove the bot assignment from a WhatsApp channel
Inputs: id (required).
neuron_unpublish_from_poolUnpublish from PoolA
Remove a published item from the marketplace/pool. This action cannot be undone.
Inputs: id (required).
neuron_update_blog_postUpdate Blog PostC
Update an existing blog post
Inputs: id (required), title, status, content, +5 more.
neuron_update_botUpdate BotB
Update an existing bot's configuration including name, system prompt, model parameters, and phone number association.
Inputs: id (required), name, llmModel, maxTokens, +8 more.
neuron_update_broadcastUpdate BroadcastA
Update an existing broadcast's details (before sending)
Inputs: id (required), name, message, mediaUrl, +1 more.
neuron_update_campaignUpdate CampaignB
Update a draft or rejected campaign
Inputs: id (required), title, message, deadline, +5 more.
neuron_update_channelUpdate ChannelC
Update configuration details of an existing WhatsApp channel
Inputs: id (required), name, phoneNumber, metaAccessToken, +1 more.
neuron_update_contactUpdate ContactA
Update an existing contact. If notes are provided, they are added as a new structured note entry (does not overwrite existing notes).
Inputs: id (required), name, tags, email, +2 more.
neuron_update_contact_listUpdate Contact ListC
Update a contact list's name, slug, description, criteria, or refresh schedule
Inputs: idOrSlug (required), name, slug, criteria, +2 more.
neuron_update_kb_entryUpdate Knowledge Base EntryAIdempotent
Update the content, title, folder, or source of an existing knowledge base entry.
Inputs: kbId (required), entryId (required), title, folder, +3 more.
neuron_update_knowledge_baseUpdate Knowledge BaseAIdempotent
Update the properties of an existing knowledge base such as name, description, or root instruction.
Inputs: id (required), name, description, rootInstruction.
neuron_update_memberUpdate Member PermissionsC
Update a member's permissions such as conversation access
Inputs: orgId (required), userId (required), canViewConversations (required).
neuron_update_newsletterUpdate NewsletterB
Update the name or description of a WhatsApp Channel newsletter
Inputs: id (required), name, description.
neuron_update_organizationUpdate OrganizationC
Update organization details such as name
Inputs: orgId (required), name.
neuron_update_outbound_webhookUpdate Outbound WebhookC
Update an existing outbound webhook configuration
Inputs: id (required), url, name, eventTypes, +1 more.
neuron_update_pool_itemUpdate Pool ItemA
Update the metadata of a pool item you have published (title, description, category, tags)
Inputs: id (required), tags, title, category, +1 more.
neuron_update_toolUpdate ToolC
Update an existing tool integration configuration
Inputs: id (required), name, config, authType, +3 more.
neuron_update_webhookUpdate WebhookB
Update an existing webhook configuration
Inputs: id (required), name, isActive, eventType, +1 more.
neuron_update_whatsapp_credentialsUpdate WhatsApp CredentialsB
Update WhatsApp Business API credentials for the organization
Inputs: orgId (required), whatsappAccessToken (required), whatsappPhoneNumberId (required), whatsappBusinessAccountId (required).
neuron_upload_documentUpload DocumentA
Upload a text document to a knowledge base. The document will be automatically chunked and indexed for semantic search.
Inputs: id (required), content (required), filename (required), folder.
neuron_upload_mediaUpload MediaB
Upload a media file (image, document, audio, video) by providing its base64-encoded content. Returns a URL that can be used in messages and broadcasts.
Inputs: base64 (required), filename (required), mimetype (required).
neuron_verify_bank_accountVerify Bank AccountARead-only
Verify a Nigerian bank account number via Paystack
Inputs: bankCode (required), accountNumber (required).
neuron_verify_wallet_fundingVerify Wallet FundingA
Verify a wallet funding transaction by Paystack reference
Inputs: reference (required).
neuron_wallet_balanceWallet BalanceARead-only
Check your organization's wallet balance
Inputs: no named parameters.
neuron_wallet_transactionsWallet TransactionsBRead-only
List wallet transaction history with optional type filter
Inputs: page, type, limit.
neuron_whoamiCheck Current AccountARead-only
Check which Neuron account is currently logged in, including user name, email, role, and organization.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 195 tools
Most tools have distinctly described purposes, but the sheer number (195) creates many similar-sounding tools (e.g., multiple message-sending tools, multiple search tools). Detailed descriptions help an agent differentiate, but the volume still risks misselection.
All tools follow a consistent 'neuron_verb_noun' pattern using snake_case. Verbs like create, delete, update, get, list are used predictably. Naming is uniform and easy to understand.
With 195 tools, the server is extremely heavy. While the domain is broad, this number far exceeds the typical well-scoped range (3-15). It would be difficult for an agent to navigate and select the right tool without extensive context.
The tool set is remarkably comprehensive, covering CRUD for all major resources (bots, channels, contacts, conversations, knowledge bases, etc.), plus billing, marketplace, analytics, webhooks, and more. There are no obvious gaps given the platform's scope.
Maintenance
Related MCP Connectors
Run WhatsApp Business campaigns from any AI assistant: contacts, segments, and broadcasts.
WhatsMCP connects Claude and other MCP-compatible AI agents directly to WhatsApp. Send and receive text, images, documents, and voice notes; manage groups (create, add/remove members, promote admins); look up contacts and profiles; follow channels; and read call and message history — all through a standard MCP interface. For voice use cases, WhatsMCP offers SIP-based calling plans (inbound-only, or full inbound/outbound) so AI voice agents can answer and place WhatsApp calls, plus low-latency WebSocket integrations with voice agent providers like ElevenLabs. Multiple WhatsApp accounts can be paired and managed per workspace, with webhook support for real-time inbound message delivery to your own infrastructure.
Send WhatsApp messages and templates, manage chats, contacts, broadcasts and AI agents.
WhatsApp Business inbox for AI apps: read and answer chats, run campaigns, deploy automations.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables WhatsApp automation through MCP protocol, allowing users to manage sessions, send messages, handle groups/communities, and access contacts through natural language interactions with AI agents.5 npm-
- AlicenseBqualityBmaintenanceEnables sending messages, images, documents and more on WhatsApp directly from any MCP-compatible AI, with tools for chat management, groups, and webhooks.371MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that connects AI agents to WhatsApp using the multi-device API, enabling messaging, group management, and more as a regular user.7 npm1MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to manage e-commerce operations (products, carts, clients) through WhatsApp via Chatwoot, using MCP tools for inventory, cart, and customer management.1-