Skip to main content
Glama

Neuron MCP Server

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

npm version License: MIT

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

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:

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 (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

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

Free to start — no credit card required.

License

MIT

Available Tools

195 tools
neuron_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 PoolA
Read-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 MarketplaceB
Read-only

Browse available campaigns that you can join and earn from

Inputs: page, limit.

neuron_campaign_participantsList Campaign ParticipantsA
Read-only

List participants of a campaign you own

Inputs: id (required).

neuron_cancel_subscriptionCancel SubscriptionA
Destructive

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 ConversationC
DestructiveIdempotent

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 BroadcastA
Destructive

Delete a broadcast. This action cannot be undone.

Inputs: id (required).

neuron_delete_campaignDelete CampaignB
Destructive

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 ContactA
Destructive

Permanently delete a contact. This action cannot be undone.

Inputs: id (required).

neuron_delete_contact_listDelete Contact ListA
Destructive

Delete a contact list. System lists (like 'Do Not Contact') cannot be deleted.

Inputs: idOrSlug (required).

neuron_delete_kb_entryDelete Knowledge Base EntryA
DestructiveIdempotent

Permanently delete a specific entry from a knowledge base.

Inputs: kbId (required), entryId (required).

neuron_delete_knowledge_baseDelete Knowledge BaseA
DestructiveIdempotent

Permanently delete a knowledge base and all its associated entries and documents.

Inputs: id (required).

neuron_delete_messageDelete MessageA
Destructive

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 WebhookA
Destructive

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 ContactsB
Read-only

Export all contacts from the system

Inputs: no named parameters.

neuron_find_contact_lists_for_contactFind Contact Lists for ContactA
Read-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 AnalyticsA
Read-only

Get delivery analytics and breakdown for an ad request.

Inputs: adRequestId (required).

neuron_get_bank_accountGet Bank AccountA
Read-only

Get the saved bank account for payouts

Inputs: no named parameters.

neuron_get_billingGet Billing InfoA
Read-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 BroadcastB
Read-only

Get detailed information about a specific broadcast by ID

Inputs: id (required).

neuron_get_broadcast_recipientsGet Broadcast RecipientsA
Read-only

Get the list of recipients for a specific broadcast with delivery status

Inputs: id (required), page, limit, status.

neuron_get_campaignGet CampaignB
Read-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 EventsB
Read-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 ContactA
Read-only

Get detailed information about a specific contact by ID

Inputs: id (required).

neuron_get_contact_listGet Contact ListA
Read-only

Get a contact list by ID or slug, including member count

Inputs: idOrSlug (required).

neuron_get_contact_list_membersGet Contact List MembersA
Read-only

List members of a contact list with search and pagination

Inputs: idOrSlug (required), page, limit, search.

neuron_get_conversationGet ConversationB
Read-onlyIdempotent

Retrieve detailed information about a specific conversation by its ID

Inputs: id (required).

neuron_get_eligible_contactsGet Eligible ContactsA
Read-only

Get contacts eligible for receiving a campaign message (respects dedup and mutual contact rules)

Inputs: id (required).

neuron_get_group_participantsGet Group ParticipantsB
Read-only

Get the list of participants in a specific WhatsApp group on a channel

Inputs: id (required), groupJid (required).

neuron_get_knowledge_baseGet Knowledge BaseA
Read-onlyIdempotent

Retrieve detailed information about a specific knowledge base by its ID.

Inputs: id (required).

neuron_get_messagesGet Conversation MessagesB
Read-onlyIdempotent

Retrieve messages from a specific conversation with optional pagination

Inputs: id (required), limit, cursor.

neuron_get_newsletterGet NewsletterA
Read-only

Get details of a specific WhatsApp Channel newsletter

Inputs: id (required).

neuron_get_organizationGet OrganizationA
Read-only

Get details of a specific organization by ID

Inputs: orgId (required).

neuron_get_outbound_webhook_logsGet Outbound Webhook LogsA
Read-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 ProfileA
Read-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 KnowledgeB
Idempotent

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 RequestsB
Read-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 LogsA
Read-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 BroadcastsA
Read-only

List all broadcasts with optional filtering by status and pagination

Inputs: page, limit, status.

neuron_list_builtin_toolsList Built-in ToolsA
Read-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 CampaignsB
Read-only

List your organization's campaigns with optional status filter

Inputs: page, limit, status.

neuron_list_channel_groupsList Channel GroupsA
Read-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 ListsA
Read-only

List all contact lists with optional search, type filter, and pagination

Inputs: page, type, limit, search.

neuron_list_contactsList ContactsB
Read-only

List contacts with optional filtering by search term, tag, and pagination

Inputs: tag, page, limit, search.

neuron_list_conversationsList ConversationsA
Read-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 InvitationsA
Read-only

List all pending invitations for the organization

Inputs: orgId (required).

neuron_list_kb_botsList Knowledge Base BotsA
Read-onlyIdempotent

Retrieve all bots that are connected to or using a specific knowledge base.

Inputs: id (required).

neuron_list_kb_entriesList Knowledge Base EntriesA
Read-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 BasesA
Read-onlyIdempotent

Retrieve all knowledge bases accessible to the current user.

Inputs: no named parameters.

neuron_list_membersList Organization MembersA
Read-only

Get a list of all members in the organization

Inputs: orgId (required).

neuron_list_newslettersList NewslettersA
Read-only

List all WhatsApp Channel newsletters for the organization. Optionally filter by WhatsApp session channel ID.

Inputs: page, limit, channelId.

neuron_list_organizationsList OrganizationsA
Read-only

List all organizations the authenticated user belongs to

Inputs: no named parameters.

neuron_list_outbound_webhooksList Outbound WebhooksA
Read-only

List all outbound webhooks configured for a specific bot

Inputs: botId (required).

neuron_list_payoutsList PayoutsC
Read-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 ContactsA
Read-only

List contacts from the WhatsApp account connected to this channel

Inputs: id (required), q.

neuron_loginLogin to NeuronA

Authenticate with Neuron. Three modes:

  1. No args: Opens a browser URL for secure authorization (recommended — no credentials shared with AI)

  2. token: Paste an MCP token from the Neuron dashboard

  3. 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 ParticipationsC
Read-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 ConversationA
Idempotent

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 ListA
Destructive

Remove contacts from a list by their contact IDs

Inputs: idOrSlug (required), contactIds (required).

neuron_remove_memberRemove Organization MemberB
Destructive

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 InvitationA
Destructive

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 ContactsA
Read-only

Search contacts by a query string across name, phone, and email fields

Inputs: q (required).

neuron_search_knowledgeSearch KnowledgeA
Read-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 ContactsA
Read-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 CampaignB
Destructive

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 KnowledgeA
Idempotent

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 ConversationA
Idempotent

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_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 EntryA
Idempotent

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 BaseA
Idempotent

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 AccountA
Read-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 BalanceA
Read-only

Check your organization's wallet balance

Inputs: no named parameters.

neuron_wallet_transactionsWallet TransactionsB
Read-only

List wallet transaction history with optional type filter

Inputs: page, type, limit.

neuron_whoamiCheck Current AccountA
Read-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

    B3.3/5.0

    Scored across 195 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness5/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables 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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that connects AI agents to WhatsApp using the multi-device API, enabling messaging, group management, and more as a regular user.
      7 npm
      1
      MIT