mcpserver.lol
registry/neuron
Connection check verified live · 27h ago

neuron

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

Tools 315
GitHub stars
Installs / wk
Licence
Transport streamable-http, stdio
Last checked 27h ago

Tools & capabilities

315 tools

Read from the running server on 27h ago.

neuron_add_bot_channel botId*channelId*
Connect an additional WhatsApp channel to a bot as a secondary number. The bot will respond to messages on this channel.
neuron_add_group_members tagsgroup*phoneslistIdscontactIdsallContacts +2
Add members to an existing group, resolved from any combination of sources (other groups, contact lists, contacts, pasted phones, all contacts). Address the group by its id, slug,…
neuron_add_product_codes id*codes*
Add more unique codes/keys to a 'pool' code product's stock. Each buyer receives one. Returns the product with the new remaining count.
neuron_add_to_contact_list entries*idOrSlug*
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 id*key*value*
Store or update a secret credential (API key, token, etc.) for a custom tool integration. Secrets are encrypted at rest.
neuron_apply_persona_to_bot id*botId*
Give a bot this persona's voice: merges a delimited voice block into the bot's system prompt (idempotent — re-applying or swapping personas replaces it cleanly) and tags the bot's…
neuron_apply_to_sell pitch
Apply for seller access (digital products). Requires a Pro plan or higher; a platform admin then grants access.
neuron_approve_reflection id*
Approve a bot-generated reflection to incorporate the learned insight into the bot's future behavior and responses.
neuron_assign_bot_to_channel id*botId*
Assign a bot to handle incoming messages on a specific WhatsApp channel. Replaces any previously assigned bot.
neuron_assign_bot_to_social_channel id*botId*
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 id*priorityknowledgeBaseId*
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 audioBase64*audioFormat
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 can modify data jid*channelId*
Block a WhatsApp contact. Blocked contacts cannot message the bot or see its profile.
neuron_bot_api_chat apiKey*message*contactNamecontactPhone*
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 read-only apiKey*
Retrieve configuration and status information about the bot associated with the provided API key.
neuron_bot_api_get_messages read-only limitapiKey*beforeconversationId*
Retrieve message history for a specific conversation with cursor-based pagination. Requires a valid API key.
neuron_bot_api_list_conversations read-only pagelimitapiKey*status
Retrieve a paginated list of conversations managed by the bot. Supports filtering by conversation status. Requires a valid API key.
neuron_bot_api_send to*apiKey*sendAtmessage*mediaUrlchannelId +1
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 read-only pagelimitregionsearchcategory
Browse verified contact lists available in the shared marketplace pool. Filter by category, region, or search term.
neuron_browse_pool read-only pagetagstypelimitquerycategory +1
Browse the shared marketplace pool of published bots, tools, knowledge bases, and reflections with optional filtering by type, category, tags, or search query.
neuron_build_persona namesampleLimitcollectionId*
Distill a reusable voice from a Collection of mined content: analyzes the top-engagement items and reverse-engineers a voiceProfile (tone, diction, cadence, emoji/formatting habits…
neuron_build_persona_from_conversation namelimitauthorsenderNamesenderPhoneconversationId*
Distill a reusable voice from an existing WhatsApp conversation's stored messages — no extension needed. `author` picks whose voice: 'me' (owner's own outgoing texts), 'contact' (t…
neuron_build_persona_from_text nametextsamplesspeakerplatformauthorLabel +1
Distill a reusable voice from raw text — no Collection or browser extension needed. Feed it pasted posts, a chat/dialogue transcript, WhatsApp-export text, or your own well-crafted…
neuron_bulk_toggle_builtin_tools botId*settings*
Enable or disable multiple built-in tools at once for a bot. More efficient than toggling tools individually.
neuron_campaign_marketplace read-only pagelimit
Browse available campaigns in the marketplace that your organization can join to earn rewards by sending messages.
neuron_campaign_participants read-only id*
Retrieve all participants who have joined a campaign you own, including their delivery counts and earned rewards.
neuron_cancel_approval can modify data apiKey*reasonapprovalId*
Cancel a still-pending approval (e.g. the upstream action was aborted). Fires the approval.cancelled callback. Requires a bot API key.
neuron_cancel_flow_run runId*
Cancel a running or waiting flow execution. Steps already completed are not rolled back.
neuron_cancel_scheduled_message can modify data id*
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 can modify data
Cancel the current active subscription. Access continues until the end of the current billing period.
neuron_checkout plan*
Initiate a checkout session for a subscription plan upgrade. Returns a checkout URL or confirmation to complete the purchase.
neuron_close_conversation id*
Close an active conversation, marking it as completed. The bot will stop responding and the conversation is archived.
neuron_compose_message to*text*sendAtmediaUrlchannelId*contactName +1
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_convert_lead id*addToList
Promote a phone-bearing lead into a contact (so it can be messaged / added to lists). Optionally add the new contact to a list.
neuron_create_ad_request budget*message*mediaUrltargetGoal*messageTypetargetDemographics*
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 name*botId*expiresAt
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 tagstitle*blocksstatuscontentexcerpt +5
Create a new blog post. Body can be authored two ways: (1) `content` as markdown (GFM) + inline raw HTML, or (2) `blocks` — a structured array of typed layout blocks rendered as st…
neuron_create_bot name*llmModelmetadatamaxTokensassignmentsystemPrompt* +7
Create a new AI bot with specified name, model, and behavior instructions. Returns the created bot object.
neuron_create_broadcast name*botIdmessage*mediaUrlchannelIdrecipients +3
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 spec…
neuron_create_campaign title*message*deadline*guidelinesdescriptiontotalBudget* +2
Create a new outreach campaign with target audience, messaging template, and schedule configuration. Requires a Pro or Business plan.
neuron_create_channel name*type*phoneNumbermetaAccessTokenmetaPhoneNumberId
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 name*tagsemailnotesphone*doNotBroadcast +1
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 name*slugtypecriteriadescriptionrefreshSchedule
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_flow name*graphenableddescription
Create a new automation flow. A flow is a directed graph of nodes connected by edges. The graph MUST start with at least one trigger node (entry point). Edges connect nodes via out…
neuron_create_group slugtagsphoneslistIdssubject*ifExists +6
Create a new WhatsApp group and seed its members from any combination of sources: other groups (combine/copy), contact lists, individual contacts, pasted phone numbers, or the whol…
neuron_create_kb_entry id*title*foldersourcecontent*metadata
Add a new entry (note, document, or information piece) to a knowledge base.
neuron_create_knowledge_base name*descriptionrootInstruction
Create a new knowledge base to store and organize information, documents, and entries.
neuron_create_lead_source name*type*configenabledscheduletimezone +1
Create a lead source. `config` depends on type: text_paste {text}; web_scrape {url|urls[]}; document {mediaUrl,mimeType}; tool_output {toolId,args?}; instagram/x {channelId, query?…
neuron_create_list_campaign namebotIdlistId*schedule*sendModebatchSize +5
Create a paced campaign that messages the next N un-reached members of a contact list on a schedule. The cursor follows the LIVE list — as members are added or removed, only curren…
neuron_create_newsletter name*channelId*description
Create a new WhatsApp Channel newsletter for one-way broadcast updates. Requires a connected Baileys session on the specified channel.
neuron_create_outbound_webhook url*name*botId*eventTypes*filterPrompt
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…
neuron_create_product kindcodesthemetitle*contentenabled +23
Create a digital product/service with a public checkout link. Amount in kobo (minor units): ₦1 = 100. Minimum ₦500 = 50000. For 'file' delivery, upload the file first (neuron_uploa…
neuron_create_social_channel label*platform*usernamecredentials
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…
neuron_create_task botId*title*configenabledscheduletimezone +2
Create a scheduled autonomous task for a bot. The instruction is a self-contained, natural-language directive the bot executes with its tools (find stale conversations, message con…
neuron_create_tool name*type*botId*config*authTyperateLimit +2
Create a custom API tool that the bot can invoke during conversations to fetch external data or trigger actions.
neuron_create_webhook name*slugbotId*isActiveeventTypeprocessingPrompt
Register a new inbound webhook endpoint that triggers bot actions when called by an external service.
neuron_delete_ad_request can modify data adRequestId*
Permanently delete a draft ad request. Only ad requests in draft status can be deleted.
neuron_delete_blog_post can modify data id*
Permanently delete a blog post by its ID. This action cannot be undone.
neuron_delete_bot can modify data id*
Permanently delete a bot and all its associated data. This action cannot be undone.
neuron_delete_broadcast can modify data id*
Permanently delete a broadcast and its recipient data. This action cannot be undone.
neuron_delete_campaign can modify data id*
Permanently delete a campaign that is in 'draft' status. Active or funded campaigns cannot be deleted.
neuron_delete_channel can modify data id*
Permanently delete a WhatsApp channel and disconnect any active sessions. This action cannot be undone.
neuron_delete_contact can modify data id*
Permanently delete a contact and remove them from all contact lists. This action cannot be undone.
neuron_delete_contact_list can modify data idOrSlug*
Permanently delete a contact list. System-protected lists (e.g., 'Do Not Contact') cannot be deleted.
neuron_delete_flow can modify data id*
Soft-delete a flow. It stops running but can be restored. Running executions are not cancelled.
neuron_delete_kb_entry can modify data kbId*entryId*
Permanently delete a specific entry from a knowledge base.
neuron_delete_knowledge_base can modify data id*
Permanently delete a knowledge base and all its associated entries and documents.
neuron_delete_list_campaign can modify data id*
Permanently delete a paced list campaign and its reached-set. Does not delete the contacts or the list.
neuron_delete_message can modify data id*msgId*
Permanently delete a specific message from a conversation. This action cannot be undone.
neuron_delete_newsletter can modify data id*
Permanently delete a WhatsApp Channel newsletter and remove it from WhatsApp. This action cannot be undone.
neuron_delete_outbound_webhook can modify data id*
Permanently remove an outbound webhook. The external endpoint will no longer receive event notifications from this bot.
neuron_delete_persona id*
Delete a voice persona.
neuron_delete_product can modify data id*
Permanently delete a product. Existing orders are retained.
neuron_delete_social_channel can modify data id*
Permanently delete a social media channel and disconnect any active sessions. This action cannot be undone.
neuron_delete_task can modify data id*
Delete a scheduled task. This is a soft delete — the task stops running immediately.
neuron_delete_tool can modify data id*
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 can modify data id*
Permanently remove an inbound webhook from a bot. External services will no longer be able to trigger this endpoint.
neuron_deliver_order id*
Re-send a paid-but-undelivered order to the buyer over WhatsApp/email. Use when a sale settled while no WhatsApp session was connected; connect one first, then deliver.
neuron_detach_knowledge_base can modify data id*kbId*
Remove a knowledge base from a bot. The bot will no longer reference this knowledge base when generating responses.
neuron_draft_task read-only botId*prompt*timezone
Turn a plain-English description into a structured task spec (title, instruction, scheduleKind, schedule, timezone, config) WITHOUT creating it. Use the returned draft as input to…
neuron_duplicate_product id*
Clone an existing product into a hidden draft copy (new checkout link, '(copy)' title, reset counters). A 'pool' code product is cloned with an empty pool — restock codes before en…
neuron_edit_message id*msgId*content*
Edit the content of a previously sent message in a conversation. Only the message sender can edit their messages.
neuron_export_contacts read-only
Export all contacts as a downloadable dataset for the current organization.
neuron_extract_leads type*config*
Run a one-off extraction WITHOUT creating a persistent source, saving the results to the lead pool. Great for pasted text or a web page. `type` + `config` as in neuron_create_lead_…
neuron_find_contact_lists_for_contact read-only contactId*
Retrieve all contact lists that a specific contact belongs to.
neuron_forward_message to*from*channelId*messageId*
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 adRequestId*
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 shor…
neuron_fund_campaign id*
Fund an approved campaign by deducting the total budget from the organization's wallet balance. Requires sufficient wallet funds.
neuron_fund_wallet email*amount*
Initialize a wallet funding transaction via Paystack. Returns a checkout URL to complete the payment in a browser.
neuron_generate_from_persona id*counttopicformatplatformextraInstructions
Generate content written in the persona's voice for a topic/brief. Returns N variations. Stateless — nothing is persisted.
neuron_get_ad_request read-only adRequestId*
Get detailed information about a specific ad request, including pool selections if targeting mode is manual.
neuron_get_ad_request_analytics read-only adRequestId*
Retrieve delivery analytics and performance breakdown for a specific ad request, including delivery rates and cost metrics.
neuron_get_approval read-only apiKey*approvalId*waitSeconds
Fetch a single approval request by id, including its decision once resolved. Set waitSeconds (1–60) to long-poll until it resolves. Requires a bot API key.
neuron_get_bank_account read-only
Retrieve the saved bank account details currently configured as the organization's payout destination.
neuron_get_billing read-only
Retrieve the current billing information, subscription plan, and usage details for the organization.
neuron_get_blocklist read-only channelId*
Fetch the list of all blocked WhatsApp contacts for the bot on the given channel.
neuron_get_blog_post read-only slug*
Retrieve a single blog post by its URL-friendly slug, including full content and metadata.
neuron_get_bot read-only id*
Retrieve detailed information about a specific bot including its configuration, status, and associated resources.
neuron_get_bot_analytics read-only id*
Retrieve analytics and usage statistics for a specific bot, including message counts, response times, and conversation metrics.
neuron_get_broadcast read-only id*
Retrieve detailed information about a specific broadcast, including its status, message content, and recipient summary.
neuron_get_broadcast_recipients read-only id*pagelimitstatus
Retrieve the paginated list of recipients for a specific broadcast with their individual delivery status.
neuron_get_business_profile read-only jid*channelId*
Fetch the WhatsApp Business profile of an external contact, including description, website, category, and business hours.
neuron_get_campaign read-only id*
Retrieve detailed information about a specific campaign including its status, budget, participants, and delivery metrics.
neuron_get_channel read-only id*
Retrieve detailed information about a specific WhatsApp channel, including its configuration, type, and connection status.
neuron_get_channel_events read-only id*pagelimit
Retrieve the event log for a channel, including connection events, message events, and errors. Supports pagination.
neuron_get_channel_qr read-only id*
Retrieve the current QR code for pairing a Baileys channel with WhatsApp. A session must be started first.
neuron_get_channel_status read-only id*
Retrieve the current connection status and session details for a specific channel (e.g., connected, disconnected, qr_pending).
neuron_get_contact read-only id*
Retrieve detailed information about a specific contact including their tags, notes, and associated lists.
neuron_get_contact_list read-only idOrSlug*
Retrieve detailed information about a specific contact list, including member count and configuration.
neuron_get_contact_list_members read-only pagelimitsearchidOrSlug*
Retrieve the members of a specific contact list with optional search filtering and pagination.
neuron_get_conversation read-only id*
Retrieve detailed information about a specific conversation, including its status, participants, and metadata.
neuron_get_eligible_contacts read-only id*
Retrieve contacts eligible to receive a campaign message. Respects deduplication rules and mutual contact requirements.
neuron_get_flow read-only id*
Retrieve a single flow by id, including its full graph (nodes and edges), enabled status, and run stats.
neuron_get_flow_catalog read-only
Retrieve the COMPLETE catalog for authoring flows. ALWAYS call this first when building or editing a flow — do not rely on memory, the full node set changes. The response has two p…
neuron_get_flow_run read-only runId*
Get a single flow run with its full step-by-step execution trace. Each step shows the node type, input/output, status (ok/error/skipped/wait), duration, and which handle fired. Use…
neuron_get_group_invite_link read-only groupJid*channelId*
Get the invite link for a WhatsApp group. Only supported on Baileys channels where the bot is a group admin.
neuron_get_group_participants read-only id*groupJid*
Retrieve the list of participants in a specific WhatsApp group accessible through a channel.
neuron_get_knowledge_base read-only id*
Retrieve detailed information about a specific knowledge base by its ID.
neuron_get_list_campaign read-only id*
Get a paced list campaign with live progress: how many members have been reached this cycle, the current list size, and how many remain.
neuron_get_messages read-only id*limitcursor
Retrieve messages from a specific conversation in chronological order, with optional cursor-based pagination.
neuron_get_newsletter read-only id*
Retrieve detailed information about a specific WhatsApp Channel newsletter, including subscriber count and metadata.
neuron_get_organization read-only orgId*
Retrieve detailed information about a specific organization, including its name, settings, and configuration.
neuron_get_outbound_webhook_logs read-only id*pagelimit
Retrieve delivery logs for an outbound webhook to monitor event dispatch history and debug delivery failures.
neuron_get_persona read-only id*
Get one voice persona (full voiceProfile + exemplars).
neuron_get_pool_item read-only id*
Retrieve detailed information about a specific item in the marketplace pool, including its description, category, tags, and install count.
neuron_get_privacy_settings read-only channelId*
Fetch the bot's current WhatsApp privacy settings (last seen, online, profile picture, status, read receipts, groups add).
neuron_get_product read-only id*
Get a single product by id, with its public URL and fee breakdown.
neuron_get_profile read-only
Retrieve the authenticated user's profile information including name, email, role, and current organization.
neuron_get_scheduled_message read-only id*
Retrieve detailed information about a specific scheduled message, including its status, send time, and message content.
neuron_get_social_channel read-only id*
Retrieve detailed information about a specific social media channel, including its platform, credentials status, and connection state.
neuron_get_social_channel_status read-only id*
Retrieve the current session status for a social media channel (e.g., connected, disconnected, error).
neuron_get_storefront read-only
Get this seller's storefront profile (handle, display name, bio, branding) and its public URL.
neuron_get_task_runs read-only id*pagelimit
Retrieve the paginated execution history for a task — each run's status, AI summary, tool steps, and stats (messages sent, contacts processed).
neuron_get_webhook_logs read-only id*pagelimit
Retrieve execution logs for an inbound webhook to monitor incoming requests and debug processing issues.
neuron_handle_join_requests action*groupJid*channelId*participants*
Approve or reject pending join requests for a WhatsApp group. Requires admin privileges.
neuron_import_contacts 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 title*foldersourcecontent*sourceUrlexternalId +2
Ingest content into a knowledge base. Supports deduplication via externalId and optional LLM processing (summarize, extract_facts, or custom instruction).
neuron_install_from_pool id*mode*targetKbIdtargetBotId
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 name*roleemail*orgId*canViewConversations
Send an invitation to a new member to join the organization. The invitee receives an email with a link to accept.
neuron_join_campaign id*channelId*
Join a marketplace campaign as a participant to earn rewards by sending messages through your WhatsApp channel.
neuron_lead_stats read-only
Counts of leads by status.
neuron_leave_group can modify data groupJid*channelId*
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 read-only pagelimitstatus
Retrieve all ad requests for the current organization with optional status filtering and pagination.
neuron_list_api_keys read-only botId*
Retrieve all API keys associated with a specific bot, including their names, creation dates, expiration status, and revocation status.
neuron_list_approvals read-only pagelimitapiKey*statuschannelId
List approval requests for the organization, newest first. Filter by status (pending/approved/rejected/expired/cancelled). Requires a bot API key.
neuron_list_audit_logs read-only pagelimitactionresourceType
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 read-only tagpagelimitstatusauthorIdauthorType
Retrieve a paginated list of blog posts with optional filtering by status, author type, author ID, or tag.
neuron_list_bot_channels read-only botId*
Retrieve all WhatsApp channels connected to a specific bot, including primary and secondary connections.
neuron_list_bot_knowledge_bases read-only id*
Retrieve all knowledge bases attached to a specific bot, including their priorities and metadata.
neuron_list_bots read-only
Retrieve all bots accessible to the current user, including their configurations and status.
neuron_list_broadcasts read-only pagelimitstatus
Retrieve a paginated list of all broadcasts with optional filtering by status such as draft, sent, or scheduled.
neuron_list_builtin_tools read-only botId*
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),…
neuron_list_campaigns read-only pagelimitstatus
Retrieve all campaigns for the current organization with optional status filtering and pagination.
neuron_list_channel_groups read-only id*
Retrieve all WhatsApp groups that the channel is participating in, including group metadata.
neuron_list_channels read-only
Retrieve all WhatsApp channels configured in the current organization, including their type and connection status.
neuron_list_contact_lists read-only pagetypelimitsearch
Retrieve all contact lists for the current organization with optional filtering by search term, type, and pagination.
neuron_list_contacts read-only tagpagelimitsearchdoNotBroadcastdoNotAutoRespond
Retrieve all contacts for the current organization with optional filtering by search term, tag, and pagination.
neuron_list_conversations read-only botId*limitcursorstatus
Retrieve a paginated list of conversations for a specific bot, with optional filtering by status.
neuron_list_flow_runs read-only id*pagelimit
List execution runs for a flow, newest first. Each run shows status (running/waiting/completed/failed/cancelled), trigger type, step count, and timing.
neuron_list_flows read-only
List all automation flows in the organization. Returns each flow's id, name, description, enabled status, trigger events, run count, and last run time.
neuron_list_installed read-only
List all items the current organization has installed from the marketplace pool.
neuron_list_invitations read-only orgId*
Retrieve a list of all pending invitations for the organization that have not yet been accepted or revoked.
neuron_list_kb_bots read-only id*
Retrieve all bots that are connected to or using a specific knowledge base.
neuron_list_kb_entries read-only id*pagelimitfoldersource
Retrieve entries from a knowledge base with optional filtering and pagination.
neuron_list_knowledge_bases read-only
Retrieve all knowledge bases accessible to the current user.
neuron_list_leads read-only pagelimitsearchstatussourceId
List leads from the pool, filterable by status (new/enriched/contacted/converted/rejected), sourceId, and search.
neuron_list_lead_sources read-only
List configured lead sources for the org.
neuron_list_list_campaigns read-only listId
List all paced list campaigns for the organization, optionally filtered to a single contact list.
neuron_list_members read-only orgId*
Retrieve a list of all members in the organization, including their roles and permissions.
neuron_list_newsletters read-only pagelimitchannelId
Retrieve a paginated list of all WhatsApp Channel newsletters for the organization, with optional filtering by WhatsApp session channel.
neuron_list_orders read-only
List recent product orders (sales) for this seller, with buyer, amount, fee breakdown, and status.
neuron_list_organizations read-only
Retrieve all organizations the authenticated user belongs to, including their roles in each.
neuron_list_outbound_webhooks read-only botId*
Retrieve all outbound webhooks configured for a specific bot, including their target URLs and subscribed event types.
neuron_list_payouts read-only pagelimit
Retrieve the payout history for the organization, including amounts, statuses, and timestamps.
neuron_list_personas read-only
List voice personas for the org. Each persona holds a voiceProfile (tone/style/themes/dos/donts) + exemplars distilled from a Collection of mined content.
neuron_list_products read-only
List all products for this seller, each with its public checkout URL and price breakdown.
neuron_list_published read-only
List all items the current organization has published to the marketplace pool.
neuron_list_reflections read-only botId*status
Retrieve pending reflections that the bot has generated from conversations, awaiting human review. Optionally filter by approval status.
neuron_list_reviews read-only
List verified-purchase reviews across this seller's products (rating, text, buyer, status).
neuron_list_scheduled_messages read-only pagelimitstatus
Retrieve a paginated list of scheduled messages for the current organization, with optional filtering by status (scheduled, sent, failed, cancelled).
neuron_list_social_channels read-only
Retrieve all social media channels (Instagram, Twitter/X) configured in the current organization.
neuron_list_tasks read-only botId*
List all scheduled tasks for a bot. A task is a natural-language instruction the bot carries out autonomously on a schedule (e.g. 're-engage stale contacts every morning at 8am').
neuron_list_tools read-only botId*
Retrieve all custom API tool integrations configured for a specific bot, including their endpoints and configuration.
neuron_list_webhooks read-only botId*
Retrieve all inbound webhooks configured for a specific bot, including their status and configuration.
neuron_list_whatsapp_contacts read-only qid*
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_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 chatJid*channelId*messageId*
Mark a WhatsApp message as read, sending read receipts to the sender.
neuron_merge_contact_lists name*slugmergeType*sourceListIds*
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 read-only pagelimit
Retrieve all campaigns the current organization has joined as a participant, including earnings and delivery stats.
neuron_pause_ad_request adRequestId*
Pause an active ad request campaign. Distribution stops until resumed. Only active ad requests can be paused.
neuron_pause_bot id*
Pause a bot to temporarily stop it from processing new messages. The bot retains its configuration and can be resumed later.
neuron_pause_campaign id*
Pause an active campaign to temporarily stop message delivery. Can be resumed later with the resume action.
neuron_pause_list_campaign id*
Pause a paced list campaign. No further batches run until resumed. The cursor is preserved.
neuron_populate_contacts
Enrich existing contacts with additional data from connected messaging channels. Syncs profile information from linked platforms.
neuron_post_to_newsletter id*textmediaUrlmessageType
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_post_to_status fonttextmediaUrlchannelIdmessageTypebackgroundColor
Post a WhatsApp Status / Story from a connected direct (Baileys) WhatsApp number. Visible to the account's synced contacts for 24 hours — you do NOT specify recipients (the contact…
neuron_product_members read-only id*status
List the members of a membership product: current (paid-up) or all. Returns each buyer's status (active / lapsed / cancelled), when their period renews, whether they're in the atta…
neuron_publish_blog_post id*
Publish a blog post, making it publicly visible. The post must be in 'draft' status.
neuron_publish_to_pool name*tagstype*categorysourceId*description +2
Publish a bot, tool, knowledge base, or reflection to the shared marketplace pool for other organizations to discover and install.
neuron_pull_pool_update installId*
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 idOrSlug*
Trigger a refresh of a dynamic contact list. Re-evaluates criteria rules and/or AI prompt and materializes updated members.
neuron_refresh_newsletter id*
Re-fetch metadata (name, description, subscriber count) for a WhatsApp Channel newsletter from WhatsApp to synchronize local data.
neuron_refresh_token refreshToken*
Refresh the access token using a refresh token. Automatically sets the new access token for subsequent API calls.
neuron_refund_order can modify data id*
Refund a paid order via Paystack. The buyer is refunded and the sale amount is reversed from your wallet.
neuron_register name*email*orgName*password*
Register a new user account with name, email, password, and organization name. Creates both the user and an initial organization.
neuron_reject_reflection id*
Reject a bot-generated reflection to prevent it from being incorporated into the bot's learned behavior.
neuron_release_conversation id*
Release a conversation back to the bot, returning control from a human agent. The bot will resume auto-responding.
neuron_remove_bot_channel can modify data botId*channelId*
Disconnect a WhatsApp channel from a bot. The bot will no longer respond to messages on this channel.
neuron_remove_from_contact_list can modify data idOrSlug*contactIds*
Remove one or more contacts from a list by their contact IDs. Does not delete the contacts themselves.
neuron_remove_group_members can modify data tagsgroup*phoneslistIdscontactIdsallContacts +2
Remove members from a group, resolved from any combination of sources — e.g. remove everyone on a contact list. Address the group by its id, slug, or JID.
neuron_remove_member can modify data orgId*userId*
Permanently remove a member from the organization. The member loses all access immediately. This action cannot be undone.
neuron_remove_profile_picture can modify data channelId*
Remove the bot's WhatsApp profile picture, reverting to the default.
neuron_remove_tool_secret can modify data id*key*
Permanently delete a stored secret from a custom tool integration. The tool will lose access to this credential.
neuron_request_approval to*apiKey*prompt*contextcallbackmetadata +3
Ask a human to approve or reject an action over WhatsApp and get the decision back. The recipient replies approve/reject (optionally with a reason) or quotes the message. Use this…
neuron_request_pair_code id*phoneNumber*
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 amount*
Request a payout to transfer funds from the organization wallet to the linked bank account. A bank account must be saved first.
neuron_respond_approval apiKey*reasondecision*approvalId*responderName
Approve or reject a pending approval programmatically — the decision surface for an authorized operator acting via MCP instead of replying on WhatsApp. Fires the configured callbac…
neuron_resume_ad_request adRequestId*
Resume a paused ad request campaign. Distribution resumes from where it left off. Only paused ad requests can be resumed.
neuron_resume_bot id*
Resume a previously paused bot so it begins processing new messages again.
neuron_resume_campaign id*
Resume a previously paused campaign to restart message delivery.
neuron_resume_list_campaign id*
Resume a paused paced list campaign. It picks up from where the cursor left off.
neuron_revoke_api_key can modify data botId*keyId*
Permanently revoke an API key to immediately invalidate it and prevent further programmatic access. This action cannot be undone.
neuron_revoke_group_invite can modify data groupJid*channelId*
Revoke the current group invite link and generate a new one. The old link will stop working. Requires admin.
neuron_revoke_invitation can modify data orgId*invitationId*
Revoke a pending organization invitation so it can no longer be accepted. This action cannot be undone.
neuron_rewrite_text text*instruction
Rewrite or rephrase text using AI with specified tone, style, or instructions (e.g., make it more formal, translate, summarize).
neuron_run_flow id*nodeIdpayload
Manually trigger a flow run for testing. Starts at the 'trigger.manual' node if present, otherwise the first trigger node. Optionally provide a payload object that becomes {{trigge…
neuron_run_lead_source id*
Run a lead source now to pull new leads into the pool (queues the extraction).
neuron_run_list_campaign_now id*
Fire the next batch of a paced list campaign immediately (on the next worker tick, ~30s), regardless of its schedule. The schedule continues normally afterward.
neuron_run_task id*
Trigger a task to run immediately (in addition to its normal schedule). Returns once the run is queued.
neuron_sales_stats read-only
Total paid sales count and net revenue (kobo) for this seller.
neuron_save_bank_account bankCode*bankName*accountName*accountNumber*
Save a verified bank account as the organization's payout destination. Verify the account first using neuron_verify_bank_account.
neuron_search_contacts read-only q*
Search contacts by a query string across name, phone number, and email fields. Returns matching contacts ranked by relevance.
neuron_search_knowledge read-only q*id*limit
Perform semantic search across all entries and documents in a knowledge base to find relevant information.
neuron_seller_status read-only
Check whether this account can sell (Pro plan + admin-granted access) and any pending application.
neuron_semantic_search_contacts read-only limitquery*
Search contacts using natural language AI-powered semantic search. Finds contacts based on the meaning of their notes — skills, services, schedules, preferences, etc. Returns ranke…
neuron_send_broadcast id*
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 id*contactIds*
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 to*channelId*contactOrgcontactName*contactPhone*
Send a vCard contact card via WhatsApp with name, phone, and optional organization.
neuron_send_location to*nameaddresslatitude*channelId*longitude*
Send a location pin via WhatsApp with coordinates and optional name/address.
neuron_send_message id*content*mediaUrlmessageType
Send a message to an existing conversation. Supports text, image, and document message types with optional media attachments.
neuron_send_poll to*name*options*channelId*selectableCount
Send a poll message via WhatsApp. Polls support 2-12 options and optional multi-select. Only supported on Baileys channels.
neuron_send_reaction to*emoji*channelId*messageId*
Send or remove an emoji reaction on a WhatsApp message. Pass an empty emoji string to remove a reaction.
neuron_send_sticker to*stickerchannelId*stickerUrl
Send a sticker via WhatsApp. The easy way: pass `sticker` as a mood or label (e.g. 'laughing', 'thumbs up', 'fire', 'celebrate') and a matching sticker is found automatically from…
neuron_send_whatsapp to*text*sendAtmediaUrlchannelIdcontactName +1
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 orgId*channelId*
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 enabled*groupJid*channelId*
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 to*type*channelId*
Set typing indicator or online/offline presence on a WhatsApp chat. Only supported on Baileys channels.
neuron_start_channel_session id*
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 id*
Start or reconnect a social media session for the channel. Initializes the platform client with stored credentials.
neuron_stop_ad_request can modify data adRequestId*
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 can modify data id*
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 id*
Stop the active Baileys session for the channel and disconnect from WhatsApp. The channel can be restarted later.
neuron_stop_social_channel_session id*
Stop the active session for a social media channel. The channel can be restarted later.
neuron_submit_ad_request adRequestId*
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 id*
Submit a draft campaign for admin review and approval. The campaign must be in 'draft' status.
neuron_submit_to_list_pool listId*category*channelId*descriptiondemographicspricePerDelivery*
Submit a contact list to the shared pool marketplace for other organizations to discover and use for ad distribution.
neuron_switch_instance url
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…
neuron_switch_org orgId*
Switch to a different organization. Returns a new access token scoped to the target organization and automatically sets it.
neuron_sync_knowledge id*
Trigger a synchronization operation to refresh embeddings, reindex content, or update the knowledge base state.
neuron_sync_newsletters channelId*
Synchronize and import WhatsApp Channels from a connected WhatsApp session into Neuron. Discovers channels created outside Neuron.
neuron_sync_reflections botId*
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 id*
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 read-only id*args*
Execute a dry-run test of a custom API tool with sample arguments to verify the endpoint responds correctly.
neuron_toggle_builtin_tool botId*toolId*enabled*
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_…
neuron_toggle_featured id*
Toggle the featured status of a pool item. Featured items appear prominently in the marketplace. Requires admin privileges.
neuron_toggle_flow id*enabled*
Enable or disable a flow. Disabled flows stop receiving events but retain their graph.
neuron_toggle_task id*
Pause or resume a scheduled task (flips its enabled state and reschedules the next run).
neuron_unassign_bot_from_channel can modify data id*
Remove the bot assignment from a WhatsApp channel. The channel will stop auto-responding to messages.
neuron_unassign_bot_from_social_channel can modify data id*botId*
Remove the bot assignment from a social media channel. The bot will lose access to the channel's social media credentials.
neuron_unblock_contact jid*channelId*
Unblock a previously blocked WhatsApp contact.
neuron_unpublish_from_pool can modify data id*
Permanently remove a published item from the marketplace pool. Organizations that installed this item will retain their copies.
neuron_update_ad_request budgetmessagemediaUrltargetGoaltargetTypeadRequestId* +5
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 id*tagstitleblocksstatuscontent +5
Update an existing blog post's content, metadata, status, or SEO fields. Only provided fields are changed.
neuron_update_bot id*namellmModelmetadatamaxTokensassignment +8
Update an existing bot's configuration. Only provided fields are modified; omitted fields remain unchanged.
neuron_update_broadcast id*namemessagemediaUrlmessageType
Update an existing broadcast's name, message content, or media before sending. The broadcast must still be in draft status.
neuron_update_campaign id*titlemessagedeadlineguidelinesdescription +3
Update a campaign that is in 'draft' or 'rejected' status. Active or completed campaigns cannot be modified.
neuron_update_channel id*namephoneNumbermetaAccessTokenmetaPhoneNumberId
Update configuration of an existing WhatsApp channel. Only provided fields are modified; omitted fields remain unchanged.
neuron_update_contact id*nametagsemailnotesphone +2
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 nameslugcriteriaidOrSlug*descriptionrefreshSchedule
Update an existing contact list's name, slug, description, criteria, or refresh schedule.
neuron_update_flow id*namegraphenableddescription
Update a flow's name, description, graph, or enabled state. Only provided fields are changed. When updating the graph, provide the COMPLETE graph (all nodes and edges) — it replace…
neuron_update_group_description groupJid*channelId*description*
Update the description of a WhatsApp group. Requires the bot to be a group admin.
neuron_update_group_members can modify data action*groupJid*channelId*participants*
Add, remove, promote, or demote members in a WhatsApp group. Provide phone numbers or JIDs. Requires admin privileges.
neuron_update_group_settings setting*groupJid*channelId*
Change WhatsApp group settings: 'announcement' (only admins send), 'not_announcement' (everyone sends), 'locked' (only admins edit info), 'unlocked' (everyone edits info). Requires…
neuron_update_group_subject subject*groupJid*channelId*
Update the name/subject of a WhatsApp group. Requires the bot to be a group admin.
neuron_update_kb_entry kbId*titlefoldersourcecontententryId* +1
Update the content, title, folder, or source of an existing knowledge base entry.
neuron_update_knowledge_base id*namedescriptionrootInstruction
Update the properties of an existing knowledge base such as name, description, or root instruction.
neuron_update_list_campaign id*namebotIdschedulesendModebatchSize +4
Update a paced list campaign's name, message source, batch size, schedule, exhaust behavior, or send settings. Changing the schedule reschedules the next run.
neuron_update_member orgId*userId*canViewConversations*
Update a member's permissions within the organization, such as conversation access. Only provided fields are changed.
neuron_update_newsletter id*namedescription
Update the name or description of an existing WhatsApp Channel newsletter. Only provided fields are changed.
neuron_update_organization nameorgId*autoOptOutBroadcastautoSuppressHostile
Update organization settings such as name, description, or configuration preferences. Only provided fields are changed.
neuron_update_outbound_webhook id*urlnameeventTypesfilterPrompt
Modify an existing outbound webhook's configuration, including its destination URL, subscribed event types, or filter prompt.
neuron_update_persona id*nameexemplarsdescriptionvoiceProfile
Update a persona's name/description, or hand-tune its voiceProfile / exemplars.
neuron_update_pool_item id*nametagscategorydescriptiondefaultSecrets +1
Update a pool item you have published — metadata (name, description, category, tags) and content fields (setupInstructions, defaultSecrets for tool_template items). The underlying…
neuron_update_privacy_setting value*setting*channelId*
Update a specific WhatsApp privacy setting. Settings: lastSeen (all/contacts/contact_blacklist/none), online (all/match_last_seen), profilePicture (all/contacts/contact_blacklist/n…
neuron_update_product id*kindcodesthemetitlecontent +24
Update any field of a product (price, delivery, cover, enabled, fee payer, …).
neuron_update_profile_name name*channelId*
Update the bot's WhatsApp display name on the given channel.
neuron_update_profile_picture imageUrl*channelId*
Update the bot's WhatsApp profile picture from an image URL.
neuron_update_profile_status status*channelId*
Update the bot's WhatsApp status/bio text.
neuron_update_scheduled_message id*sendAtmessagemediaUrlcontactNamemessageType
Update the message content, media, or send time of a scheduled message. Only messages with status 'scheduled' can be updated.
neuron_update_social_channel id*labelusernamecredentials
Update an existing social media channel. Can update label, username, or refresh credentials.
neuron_update_storefront biohandleenabledsocialsavatarUrlbrandColor +1
Create or update the seller storefront (nestuge-style page). Handle is auto-generated from the display name if omitted.
neuron_update_task id*titleconfigenabledscheduletimezone +2
Update a scheduled task's instruction, schedule, timezone, enabled state, or config. Only provided fields change.
neuron_update_tool id*nametypeconfigauthTyperateLimit +2
Modify an existing custom API tool's configuration, including its endpoint, authentication, or request template.
neuron_update_webhook id*nameisActiveeventTypeprocessingPrompt
Modify an existing inbound webhook's configuration, such as its name, event type, or processing prompt.
neuron_update_whatsapp_credentials orgId*whatsappAccessToken*whatsappPhoneNumberId*whatsappBusinessAccountId*
Update WhatsApp Business API credentials for the organization. These credentials are required for sending messages via the WhatsApp Cloud API.
neuron_upload_document id*foldercontent*filename*
Upload a text document to a knowledge base. The document will be automatically chunked and indexed for semantic search.
neuron_upload_media base64*filename*mimetype*
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 read-only id*
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 read-only bankCode*accountNumber*
Verify a Nigerian bank account number via Paystack to confirm the account holder name before saving.
neuron_verify_wallet_funding read-only reference*
Verify a wallet funding transaction using the Paystack payment reference to confirm the payment was successful.
neuron_wallet_balance read-only
Retrieve the current wallet balance for the organization, including available and pending amounts.
neuron_wallet_transactions read-only pagetypelimit
Retrieve the wallet transaction history for the organization, with optional filtering by transaction type.
neuron_whoami read-only
Check which Neuron account is currently logged in, including user name, email, role, and organization.