Neuron MCP Server

io.github.conquext/neuron

answering

Neuron is answering right now. Last checked 9 min ago. 37 installs a week from npm. It exposes 246 tools.

AI-powered WhatsApp chatbot platform with 196 tools for bots, campaigns, and contacts.

The linked repository no longer exists on GitHub — it was deleted or made private.

Installs per day peak 29 · avg 7 · -16% w/w

a month agotoday

Uptime history 40 hours of history

40 hours agonow

100.0%

Uptime 24h

91 of 91 checks

246

Tools

read from the server

309 ms

Response time

average over 24h

Installs / week

npm and PyPI

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 9 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add neuron --transport http https://mcp.neuron.ng/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

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

~/.codex/config.toml

[mcp_servers.neuron]
url = "https://mcp.neuron.ng/mcp"

.cursor/mcp.json

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

.vscode/mcp.json

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

Available tools 246

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

neuron

neuron_add_bot_channel

Connect an additional WhatsApp channel to a bot as a secondary number. The bot will respond to messages on this channel.

neuron_add_to_contact_list

Add one or more contacts to a list by contact ID or phone number. Phone numbers without existing contacts are auto-created as minimal contact records.

neuron_add_tool_secret

Store or update a secret credential (API key, token, etc.) for a custom tool integration. Secrets are encrypted at rest.

neuron_approve_reflection

Approve a bot-generated reflection to incorporate the learned insight into the bot's future behavior and responses.

neuron_assign_bot_to_channel

Assign a bot to handle incoming messages on a specific WhatsApp channel. Replaces any previously assigned bot.

neuron_assign_bot_to_social_channel

Assign a bot to handle interactions on a specific social media channel. The bot will be able to use the channel's credentials for social media actions.

neuron_attach_knowledge_base

Attach a knowledge base to a bot to enhance its responses with domain-specific knowledge. Optional priority determines retrieval order when multiple knowledge bases are attached.

neuron_audio_contact

Transcribe an audio recording and extract contact information (name, phone, email, notes, tags). Automatically saves the extracted contact to the organization's address book.

neuron_block_contact

Block a WhatsApp contact. Blocked contacts cannot message the bot or see its profile.

neuron_bot_api_chat

Send a message to a bot via the API and receive a streaming or complete AI-generated response. Requires a valid API key with 'nrn_' prefix.

neuron_bot_api_get_bot

Retrieve configuration and status information about the bot associated with the provided API key.

neuron_bot_api_get_messages

Retrieve message history for a specific conversation with cursor-based pagination. Requires a valid API key.

neuron_bot_api_list_conversations

Retrieve a paginated list of conversations managed by the bot. Supports filtering by conversation status. Requires a valid API key.

neuron_bot_api_send

Send an outbound message through the bot API to a specified phone number. Supports text and media messages. Requires a valid API key.

neuron_browse_list_pool

Browse verified contact lists available in the shared marketplace pool. Filter by category, region, or search term.

neuron_browse_pool

Browse the shared marketplace pool of published bots, tools, knowledge bases, and reflections with optional filtering by type, category, tags, or search query.

neuron_bulk_toggle_builtin_tools

Enable or disable multiple built-in tools at once for a bot. More efficient than toggling tools individually.

neuron_campaign_marketplace

Browse available campaigns in the marketplace that your organization can join to earn rewards by sending messages.

neuron_campaign_participants

Retrieve all participants who have joined a campaign you own, including their delivery counts and earned rewards.

neuron_cancel_scheduled_message

Cancel a scheduled message to prevent it from being sent. Only messages with status 'scheduled' can be cancelled. This action cannot be undone.

neuron_cancel_subscription

Cancel the current active subscription. Access continues until the end of the current billing period.

neuron_checkout

Initiate a checkout session for a subscription plan upgrade. Returns a checkout URL or confirmation to complete the purchase.

neuron_close_conversation

Close an active conversation, marking it as completed. The bot will stop responding and the conversation is archived.

neuron_compose_message

Compose and send a new message to a phone number via a specific channel. Automatically creates a new conversation if one does not exist.

neuron_create_ad_request

Create an ad distribution request to send a message to contacts in pool lists matching target demographics. Deducts from wallet upon approval.

neuron_create_api_key

Create a new API key for programmatic access to a specific bot. Store the key securely as it cannot be retrieved later.

neuron_create_blog_post

Create a new blog post in draft or published status with specified title, content, and optional metadata such as tags, excerpt, and SEO fields. Content supports full markdown (GFM) AND raw HTML — images/GIFs via ![alt](url), videos via <video>, YouTube/Loom embeds via <iframe>, collapsible sections via <details>/<summary>, plus <mark>, <kbd>, <abbr>, <div> with inline styles, etc.

neuron_create_bot

Create a new AI bot with specified name, model, and behavior instructions. Returns the created bot object.

neuron_create_broadcast

Create a new broadcast message in draft status. Provide recipients directly or use recipientSources to resolve from contact lists. The WhatsApp channel is auto-resolved if not specified.

neuron_create_campaign

Create a new outreach campaign with target audience, messaging template, and schedule configuration. Requires a Pro or Business plan.

neuron_create_channel

Create a new WhatsApp channel with either Meta Cloud API or Baileys (direct WhatsApp) integration. Meta Cloud channels require metaPhoneNumberId and metaAccessToken.

neuron_create_contact

Create a new contact in the organization's address book. If notes are provided, they are saved as a structured note entry with source tracking.

neuron_create_contact_list

Create a new contact list. Slug is auto-generated from name if not provided. For dynamic lists, provide criteria with rules and/or an AI prompt.

neuron_create_kb_entry

Add a new entry (note, document, or information piece) to a knowledge base.

neuron_create_knowledge_base

Create a new knowledge base to store and organize information, documents, and entries.

neuron_create_newsletter

Create a new WhatsApp Channel newsletter for one-way broadcast updates. Requires a connected Baileys session on the specified channel.

neuron_create_outbound_webhook

Register a new outbound webhook that sends HTTP POST requests to an external URL when specified bot events occur. Supported events: message.created, message.assistant, conversation.created, conversation.escalated, conversation.closed, bot.paused, bot.resumed.

neuron_create_social_channel

Create a new social media channel with platform credentials. Supports Instagram and Twitter/X. Credentials should be the full session JSON including account, cookies, headers, and platform-specific tokens.

neuron_create_tool

Create a custom API tool that the bot can invoke during conversations to fetch external data or trigger actions.

neuron_create_webhook

neuron_delete_ad_request

Permanently delete a draft ad request. Only ad requests in draft status can be deleted.

neuron_delete_blog_post

Permanently delete a blog post by its ID. This action cannot be undone.

neuron_delete_bot

Permanently delete a bot and all its associated data. This action cannot be undone.

neuron_delete_broadcast

Permanently delete a broadcast and its recipient data. This action cannot be undone.

neuron_delete_campaign

Permanently delete a campaign that is in 'draft' status. Active or funded campaigns cannot be deleted.

neuron_delete_channel

Permanently delete a WhatsApp channel and disconnect any active sessions. This action cannot be undone.

neuron_delete_contact

Permanently delete a contact and remove them from all contact lists. This action cannot be undone.

neuron_delete_contact_list

Permanently delete a contact list. System-protected lists (e.g., 'Do Not Contact') cannot be deleted.

neuron_delete_kb_entry

Permanently delete a specific entry from a knowledge base.

neuron_delete_knowledge_base

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

neuron_delete_message

Permanently delete a specific message from a conversation. This action cannot be undone.

neuron_delete_newsletter

Permanently delete a WhatsApp Channel newsletter and remove it from WhatsApp. This action cannot be undone.

neuron_delete_outbound_webhook

Permanently remove an outbound webhook. The external endpoint will no longer receive event notifications from this bot.

neuron_delete_social_channel

Permanently delete a social media channel and disconnect any active sessions. This action cannot be undone.

neuron_delete_tool

Permanently remove a custom API tool integration from a bot. The bot will no longer be able to invoke this tool in conversations.

neuron_delete_webhook

Permanently remove an inbound webhook from a bot. External services will no longer be able to trigger this endpoint.

neuron_detach_knowledge_base

Remove a knowledge base from a bot. The bot will no longer reference this knowledge base when generating responses.

neuron_edit_message

Edit the content of a previously sent message in a conversation. Only the message sender can edit their messages.

neuron_export_contacts

Export all contacts as a downloadable dataset for the current organization.

neuron_find_contact_lists_for_contact

Retrieve all contact lists that a specific contact belongs to.

neuron_forward_message

Forward a WhatsApp message from one chat to another. Uses copy-send approach — the message content is re-sent to the destination.

neuron_fund_ad_request

Fund an approved ad request from the organization wallet. This debits the budget amount and activates the campaign for distribution. If wallet balance is insufficient, returns shortfall information instead of an error.

neuron_fund_campaign

Fund an approved campaign by deducting the total budget from the organization's wallet balance. Requires sufficient wallet funds.

neuron_fund_wallet

Initialize a wallet funding transaction via Paystack. Returns a checkout URL to complete the payment in a browser.

neuron_get_ad_request

Get detailed information about a specific ad request, including pool selections if targeting mode is manual.

neuron_get_ad_request_analytics

Retrieve delivery analytics and performance breakdown for a specific ad request, including delivery rates and cost metrics.

neuron_get_bank_account

Retrieve the saved bank account details currently configured as the organization's payout destination.

neuron_get_billing

Retrieve the current billing information, subscription plan, and usage details for the organization.

neuron_get_blocklist

Fetch the list of all blocked WhatsApp contacts for the bot on the given channel.

neuron_get_blog_post

Retrieve a single blog post by its URL-friendly slug, including full content and metadata.

neuron_get_bot

Retrieve detailed information about a specific bot including its configuration, status, and associated resources.

neuron_get_bot_analytics

Retrieve analytics and usage statistics for a specific bot, including message counts, response times, and conversation metrics.

neuron_get_broadcast

Retrieve detailed information about a specific broadcast, including its status, message content, and recipient summary.

neuron_get_broadcast_recipients

Retrieve the paginated list of recipients for a specific broadcast with their individual delivery status.

neuron_get_business_profile

Fetch the WhatsApp Business profile of an external contact, including description, website, category, and business hours.

neuron_get_campaign

Retrieve detailed information about a specific campaign including its status, budget, participants, and delivery metrics.

neuron_get_channel

Retrieve detailed information about a specific WhatsApp channel, including its configuration, type, and connection status.

neuron_get_channel_events

Retrieve the event log for a channel, including connection events, message events, and errors. Supports pagination.

neuron_get_channel_qr

Retrieve the current QR code for pairing a Baileys channel with WhatsApp. A session must be started first.

neuron_get_channel_status

Retrieve the current connection status and session details for a specific channel (e.g., connected, disconnected, qr_pending).

neuron_get_contact

Retrieve detailed information about a specific contact including their tags, notes, and associated lists.

neuron_get_contact_list

Retrieve detailed information about a specific contact list, including member count and configuration.

neuron_get_contact_list_members

Retrieve the members of a specific contact list with optional search filtering and pagination.

neuron_get_conversation

Retrieve detailed information about a specific conversation, including its status, participants, and metadata.

neuron_get_eligible_contacts

Retrieve contacts eligible to receive a campaign message. Respects deduplication rules and mutual contact requirements.

neuron_get_group_invite_link

Get the invite link for a WhatsApp group. Only supported on Baileys channels where the bot is a group admin.

neuron_get_group_participants

Retrieve the list of participants in a specific WhatsApp group accessible through a channel.

neuron_get_knowledge_base

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

neuron_get_messages

Retrieve messages from a specific conversation in chronological order, with optional cursor-based pagination.

neuron_get_newsletter

Retrieve detailed information about a specific WhatsApp Channel newsletter, including subscriber count and metadata.

neuron_get_organization

Retrieve detailed information about a specific organization, including its name, settings, and configuration.

neuron_get_outbound_webhook_logs

Retrieve delivery logs for an outbound webhook to monitor event dispatch history and debug delivery failures.

neuron_get_pool_item

Retrieve detailed information about a specific item in the marketplace pool, including its description, category, tags, and install count.

neuron_get_privacy_settings

Fetch the bot's current WhatsApp privacy settings (last seen, online, profile picture, status, read receipts, groups add).

neuron_get_profile

Retrieve the authenticated user's profile information including name, email, role, and current organization.

neuron_get_scheduled_message

Retrieve detailed information about a specific scheduled message, including its status, send time, and message content.

neuron_get_social_channel

Retrieve detailed information about a specific social media channel, including its platform, credentials status, and connection state.

neuron_get_social_channel_status

Retrieve the current session status for a social media channel (e.g., connected, disconnected, error).

neuron_get_webhook_logs

Retrieve execution logs for an inbound webhook to monitor incoming requests and debug processing issues.

neuron_handle_join_requests

Approve or reject pending join requests for a WhatsApp group. Requires admin privileges.

neuron_import_contacts

Bulk import multiple contacts into the organization's address book. Accepts an array of contact objects with name, phone, and optional fields.

neuron_ingest_knowledge

Ingest content into a knowledge base. Supports deduplication via externalId and optional LLM processing (summarize, extract_facts, or custom instruction).

neuron_install_from_pool

Install a resource from the marketplace pool into the current organization. Choose 'fork' for an independent copy or 'subscribe' to receive future updates from the publisher.

neuron_invite_member

Send an invitation to a new member to join the organization. The invitee receives an email with a link to accept.

neuron_join_campaign

Join a marketplace campaign as a participant to earn rewards by sending messages through your WhatsApp channel.

neuron_leave_group

Make the bot leave a WhatsApp group. This action is irreversible — the bot will need to be re-added by an admin.

neuron_list_ad_requests

Retrieve all ad requests for the current organization with optional status filtering and pagination.

neuron_list_api_keys

Retrieve all API keys associated with a specific bot, including their names, creation dates, expiration status, and revocation status.

neuron_list_audit_logs

Retrieve audit logs for the organization, showing a chronological record of actions performed by members. Supports filtering by action type and resource.

neuron_list_blog_posts

Retrieve a paginated list of blog posts with optional filtering by status, author type, author ID, or tag.

neuron_list_bot_channels

Retrieve all WhatsApp channels connected to a specific bot, including primary and secondary connections.

neuron_list_bot_knowledge_bases

Retrieve all knowledge bases attached to a specific bot, including their priorities and metadata.

neuron_list_bots

Retrieve all bots accessible to the current user, including their configurations and status.

neuron_list_broadcasts

Retrieve a paginated list of all broadcasts with optional filtering by status such as draft, sent, or scheduled.

neuron_list_builtin_tools

Retrieve all available 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.

neuron_list_campaigns

Retrieve all campaigns for the current organization with optional status filtering and pagination.

neuron_list_channel_groups

Retrieve all WhatsApp groups that the channel is participating in, including group metadata.

neuron_list_channels

Retrieve all WhatsApp channels configured in the current organization, including their type and connection status.

neuron_list_contact_lists

Retrieve all contact lists for the current organization with optional filtering by search term, type, and pagination.

neuron_list_contacts

Retrieve all contacts for the current organization with optional filtering by search term, tag, and pagination.

neuron_list_conversations

Retrieve a paginated list of conversations for a specific bot, with optional filtering by status.

neuron_list_installed

List all items the current organization has installed from the marketplace pool.

neuron_list_invitations

Retrieve a list of all pending invitations for the organization that have not yet been accepted or revoked.

neuron_list_kb_bots

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

neuron_list_kb_entries

Retrieve entries from a knowledge base with optional filtering and pagination.

neuron_list_knowledge_bases

Retrieve all knowledge bases accessible to the current user.

neuron_list_members

Retrieve a list of all members in the organization, including their roles and permissions.

neuron_list_newsletters

Retrieve a paginated list of all WhatsApp Channel newsletters for the organization, with optional filtering by WhatsApp session channel.

neuron_list_organizations

Retrieve all organizations the authenticated user belongs to, including their roles in each.

neuron_list_outbound_webhooks

Retrieve all outbound webhooks configured for a specific bot, including their target URLs and subscribed event types.

neuron_list_payouts

Retrieve the payout history for the organization, including amounts, statuses, and timestamps.

neuron_list_published

List all items the current organization has published to the marketplace pool.

neuron_list_reflections

Retrieve pending reflections that the bot has generated from conversations, awaiting human review. Optionally filter by approval status.

neuron_list_scheduled_messages

Retrieve a paginated list of scheduled messages for the current organization, with optional filtering by status (scheduled, sent, failed, cancelled).

neuron_list_social_channels

Retrieve all social media channels (Instagram, Twitter/X) configured in the current organization.

neuron_list_tools

Retrieve all custom API tool integrations configured for a specific bot, including their endpoints and configuration.

neuron_list_webhooks

Retrieve all inbound webhooks configured for a specific bot, including their status and configuration.

neuron_list_whatsapp_contacts

Retrieve contacts from the WhatsApp account connected to this channel, with optional search filtering.

neuron_login

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)

neuron_logout

Clear the current auth token locally. Does NOT revoke server-side MCP tokens — revoke from the Neuron dashboard (Settings > MCP Tokens) for full invalidation.

neuron_mark_as_read

Mark a WhatsApp message as read, sending read receipts to the sender.

neuron_merge_contact_lists

Merge two or more contact lists into a single unified list, deduplicating entries. Window merge creates a virtual union; materialized merge creates a static copy.

neuron_my_participations

Retrieve all campaigns the current organization has joined as a participant, including earnings and delivery stats.

neuron_pause_ad_request

Pause an active ad request campaign. Distribution stops until resumed. Only active ad requests can be paused.

neuron_pause_bot

Pause a bot to temporarily stop it from processing new messages. The bot retains its configuration and can be resumed later.

neuron_pause_campaign

Pause an active campaign to temporarily stop message delivery. Can be resumed later with the resume action.

neuron_populate_contacts

Enrich existing contacts with additional data from connected messaging channels. Syncs profile information from linked platforms.

neuron_post_to_newsletter

Post a message to a WhatsApp Channel newsletter. All subscribers receive the message. Provide at least one of text or mediaUrl. This triggers delivery and cannot be undone.

neuron_publish_blog_post

Publish a blog post, making it publicly visible. The post must be in 'draft' status.

neuron_publish_to_pool

Publish a bot, tool, knowledge base, or reflection to the shared marketplace pool for other organizations to discover and install.

neuron_pull_pool_update

Pull the latest updates for a subscribed pool resource to sync with the publisher's changes. Only applies to items installed with 'subscribe' mode.

neuron_refresh_contact_list

Trigger a refresh of a dynamic contact list. Re-evaluates criteria rules and/or AI prompt and materializes updated members.

neuron_refresh_newsletter

Re-fetch metadata (name, description, subscriber count) for a WhatsApp Channel newsletter from WhatsApp to synchronize local data.

neuron_refresh_token

Refresh the access token using a refresh token. Automatically sets the new access token for subsequent API calls.

neuron_register

Register a new user account with name, email, password, and organization name. Creates both the user and an initial organization.

neuron_reject_reflection

Reject a bot-generated reflection to prevent it from being incorporated into the bot's learned behavior.

neuron_release_conversation

Release a conversation back to the bot, returning control from a human agent. The bot will resume auto-responding.

neuron_remove_bot_channel

Disconnect a WhatsApp channel from a bot. The bot will no longer respond to messages on this channel.

neuron_remove_from_contact_list

Remove one or more contacts from a list by their contact IDs. Does not delete the contacts themselves.

neuron_remove_member

Permanently remove a member from the organization. The member loses all access immediately. This action cannot be undone.

neuron_remove_profile_picture

Remove the bot's WhatsApp profile picture, reverting to the default.

neuron_remove_tool_secret

Permanently delete a stored secret from a custom tool integration. The tool will lose access to this credential.

neuron_request_pair_code

Request a numeric pairing code for a Baileys channel as an alternative to QR code scanning. Requires the phone number to pair with.

neuron_request_payout

Request a payout to transfer funds from the organization wallet to the linked bank account. A bank account must be saved first.

neuron_resume_ad_request

Resume a paused ad request campaign. Distribution resumes from where it left off. Only paused ad requests can be resumed.

neuron_resume_bot

Resume a previously paused bot so it begins processing new messages again.

neuron_resume_campaign

Resume a previously paused campaign to restart message delivery.

neuron_revoke_api_key

Permanently revoke an API key to immediately invalidate it and prevent further programmatic access. This action cannot be undone.

neuron_revoke_group_invite

Revoke the current group invite link and generate a new one. The old link will stop working. Requires admin.

neuron_revoke_invitation

Revoke a pending organization invitation so it can no longer be accepted. This action cannot be undone.

neuron_rewrite_text

Rewrite or rephrase text using AI with specified tone, style, or instructions (e.g., make it more formal, translate, summarize).

neuron_save_bank_account

Save a verified bank account as the organization's payout destination. Verify the account first using neuron_verify_bank_account.

neuron_search_contacts

Search contacts by a query string across name, phone number, and email fields. Returns matching contacts ranked by relevance.

neuron_search_knowledge

Perform semantic search across all entries and documents in a knowledge base to find relevant information.

neuron_semantic_search_contacts

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.

neuron_send_broadcast

Send a broadcast message to all its recipients. The broadcast must be in draft status. This triggers message delivery and cannot be undone.

neuron_send_campaign_message

Send a campaign message to selected eligible contacts via WhatsApp. Requires the campaign to be in 'active' status and contacts to be eligible.

neuron_send_contact_card

Send a vCard contact card via WhatsApp with name, phone, and optional organization.

neuron_send_location

Send a location pin via WhatsApp with coordinates and optional name/address.

neuron_send_message

Send a message to an existing conversation. Supports text, image, and document message types with optional media attachments.

neuron_send_poll

Send a poll message via WhatsApp. Polls support 2-12 options and optional multi-select. Only supported on Baileys channels.

neuron_send_reaction

Send or remove an emoji reaction on a WhatsApp message. Pass an empty emoji string to remove a reaction.

neuron_send_sticker

Send a WebP sticker image via WhatsApp. Only supported on Baileys channels.

neuron_send_whatsapp

Send a WhatsApp message to a phone number or group. Auto-resolves which channel to use (org default > first connected). Supports text, image, audio, video, and document types.

neuron_set_default_channel

Set or clear the default WhatsApp channel for the organization. The default channel is used by neuron_send_whatsapp for auto-resolving which channel to send through.

neuron_set_group_join_approval

Enable or disable join approval mode for a WhatsApp group. When enabled, join requests must be manually approved by admins. Requires admin.

neuron_set_presence

Set typing indicator or online/offline presence on a WhatsApp chat. Only supported on Baileys channels.

neuron_start_channel_session

Start a Baileys (direct WhatsApp) session for the channel. Generates a QR code for device pairing. Only applicable to Baileys-type channels.

neuron_start_social_channel_session

Start or reconnect a social media session for the channel. Initializes the platform client with stored credentials.

neuron_stop_ad_request

Stop an active or paused ad request campaign permanently. Any remaining unspent budget is refunded to the organization wallet. This cannot be undone.

neuron_stop_campaign

Permanently stop an active campaign and refund the remaining unspent budget to the organization's wallet. This action cannot be undone.

neuron_stop_channel_session

Stop the active Baileys session for the channel and disconnect from WhatsApp. The channel can be restarted later.

neuron_stop_social_channel_session

Stop the active session for a social media channel. The channel can be restarted later.

neuron_submit_ad_request

Submit a draft ad request for admin review. The request must be in draft status. After submission, an admin must approve it before it can be funded.

neuron_submit_campaign

Submit a draft campaign for admin review and approval. The campaign must be in 'draft' status.

neuron_submit_to_list_pool

Submit a contact list to the shared pool marketplace for other organizations to discover and use for ad distribution.

neuron_switch_instance

Switch the MCP server to target a different Neuron backend instance. Auth tokens are preserved per instance — if you've previously logged in to an instance, switching back restores your session automatically. Call with no args to list known instances and see which is active.

neuron_switch_org

Switch to a different organization. Returns a new access token scoped to the target organization and automatically sets it.

neuron_sync_knowledge

Trigger a synchronization operation to refresh embeddings, reindex content, or update the knowledge base state.

neuron_sync_newsletters

Synchronize and import WhatsApp Channels from a connected WhatsApp session into Neuron. Discovers channels created outside Neuron.

neuron_sync_reflections

Synchronize all approved reflections into the bot's active knowledge base, applying learned insights to future conversations.

neuron_sync_whatsapp_contacts

Synchronize contacts from all connected WhatsApp channels into the organization's contact database. Creates new contacts for unseen numbers.

neuron_takeover_conversation

Transfer control of a conversation from the bot to a human agent. The bot will stop auto-responding until the conversation is released.

neuron_test_tool

Execute a dry-run test of a custom API tool with sample arguments to verify the endpoint responds correctly.

neuron_toggle_builtin_tool

Toggle a built-in tool on or off for a specific bot. Enabled tools become available in the bot's conversations. Example tool IDs: delete_message, post_to_channel, post_status, web_search, send_direct_message, react_to_message, set_reminder, create_poll.

neuron_toggle_featured

Toggle the featured status of a pool item. Featured items appear prominently in the marketplace. Requires admin privileges.

neuron_unassign_bot_from_channel

Remove the bot assignment from a WhatsApp channel. The channel will stop auto-responding to messages.

neuron_unassign_bot_from_social_channel

Remove the bot assignment from a social media channel. The bot will lose access to the channel's social media credentials.

neuron_unblock_contact

Unblock a previously blocked WhatsApp contact.

neuron_unpublish_from_pool

Permanently remove a published item from the marketplace pool. Organizations that installed this item will retain their copies.

neuron_update_ad_request

Update a draft or rejected ad request. Only draft and rejected ad requests can be edited. Rejected requests revert to draft on update.

neuron_update_blog_post

Update an existing blog post's content, metadata, status, or SEO fields. Only provided fields are changed.

neuron_update_bot

Update an existing bot's configuration. Only provided fields are modified; omitted fields remain unchanged.

neuron_update_broadcast

Update an existing broadcast's name, message content, or media before sending. The broadcast must still be in draft status.

neuron_update_campaign

Update a campaign that is in 'draft' or 'rejected' status. Active or completed campaigns cannot be modified.

neuron_update_channel

Update configuration of an existing WhatsApp channel. Only provided fields are modified; omitted fields remain unchanged.

neuron_update_contact

Update an existing contact's details. If notes are provided, they are appended as a new structured note entry without overwriting existing notes.

neuron_update_contact_list

Update an existing contact list's name, slug, description, criteria, or refresh schedule.

neuron_update_group_description

Update the description of a WhatsApp group. Requires the bot to be a group admin.

neuron_update_group_members

Add, remove, promote, or demote members in a WhatsApp group. Provide phone numbers or JIDs. Requires admin privileges.

neuron_update_group_settings

Change WhatsApp group settings: 'announcement' (only admins send), 'not_announcement' (everyone sends), 'locked' (only admins edit info), 'unlocked' (everyone edits info). Requires admin.

neuron_update_group_subject

Update the name/subject of a WhatsApp group. Requires the bot to be a group admin.

neuron_update_kb_entry

Update the content, title, folder, or source of an existing knowledge base entry.

neuron_update_knowledge_base

Update the properties of an existing knowledge base such as name, description, or root instruction.

neuron_update_member

Update a member's permissions within the organization, such as conversation access. Only provided fields are changed.

neuron_update_newsletter

Update the name or description of an existing WhatsApp Channel newsletter. Only provided fields are changed.

neuron_update_organization

Update organization settings such as name, description, or configuration preferences. Only provided fields are changed.

neuron_update_outbound_webhook

Modify an existing outbound webhook's configuration, including its destination URL, subscribed event types, or filter prompt.

neuron_update_pool_item

Update a pool item you have published — metadata (name, description, category, tags) and content fields (setupInstructions, defaultSecrets for tool_template items). The underlying resource is re-snapshotted and version is bumped on every update.

neuron_update_privacy_setting

Update a specific WhatsApp privacy setting. Settings: lastSeen (all/contacts/contact_blacklist/none), online (all/match_last_seen), profilePicture (all/contacts/contact_blacklist/none), status (all/contacts/contact_blacklist/none), readReceipts (all/none), groupsAdd (all/contacts/contact_blacklist).

neuron_update_profile_name

Update the bot's WhatsApp display name on the given channel.

neuron_update_profile_picture

Update the bot's WhatsApp profile picture from an image URL.

neuron_update_profile_status

Update the bot's WhatsApp status/bio text.

neuron_update_scheduled_message

Update the message content, media, or send time of a scheduled message. Only messages with status 'scheduled' can be updated.

neuron_update_social_channel

Update an existing social media channel. Can update label, username, or refresh credentials.

neuron_update_tool

Modify an existing custom API tool's configuration, including its endpoint, authentication, or request template.

neuron_update_webhook

Modify an existing inbound webhook's configuration, such as its name, event type, or processing prompt.

neuron_update_whatsapp_credentials

Update WhatsApp Business API credentials for the organization. These credentials are required for sending messages via the WhatsApp Cloud API.

neuron_upload_document

Upload a text document to a knowledge base. The document will be automatically chunked and indexed for semantic search.

neuron_upload_media

Upload a media file (image, video, audio, or document) by providing its base64-encoded content. Returns a URL for use in messages and broadcasts.

neuron_validate_social_channel

Test whether the stored credentials for a social channel are still valid by making a test API call to the platform.

neuron_verify_bank_account

Verify a Nigerian bank account number via Paystack to confirm the account holder name before saving.

neuron_verify_wallet_funding

Verify a wallet funding transaction using the Paystack payment reference to confirm the payment was successful.

neuron_wallet_balance

Retrieve the current wallet balance for the organization, including available and pending amounts.

neuron_wallet_transactions

Retrieve the wallet transaction history for the organization, with optional filtering by transaction type.

neuron_whoami

Check which Neuron account is currently logged in, including user name, email, role, and organization.

Endpoints

URL	Transport	State	Latency	Checked
https://mcp.neuron.ng/mcp	streamable-http	answering	272 ms	9 min ago

Neuron — questions

Answers built from our own checks of this server.

What can Neuron do?

It exposes 246 tools, read directly from the server on our last check. Among them: neuron_add_bot_channel, neuron_add_to_contact_list, neuron_add_tool_secret, neuron_approve_reflection, neuron_assign_bot_to_channel, neuron_assign_bot_to_social_channel and 240 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is Neuron working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 309 ms. The bar chart above shows every period we have measured.

Is Neuron still maintained?

The linked repository no longer exists on GitHub — it was deleted or made private. We show this because it changes what you can expect: an unmaintained server may keep answering for months and then stop without warning.

How do I connect Neuron?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Neuron need an API key?

No. Neuron completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 246 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Neuron?

It answers our handshake in 309 ms on average, which is faster than 45% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

How many people use Neuron?

The npm package neuron-mcp-server was installed 37 times in the last week. Week over week that is -16%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.