Neuron MCP server
online · 100% uptimeio.github.conquext/neuron·v1.0.2AI-powered WhatsApp chatbot platform with 196 tools for bots, campaigns, and contacts.
46 downloads/wk
Reviews
Write oneNobody has reviewed Neuron yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Neuron tools (383, 146 write)
write = sends, deletes, buys or postsneuron_add_bot_channelFreeConnect an additional WhatsApp channel to a bot as a secondary number. The bot will respond to messages on this channel.
neuron_add_group_membersFreeAdd 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, or JID.
neuron_add_product_codesFreeAdd 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_listFreeAdd 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_secretFreeStore or update a secret credential (API key, token, etc.) for a custom tool integration. Secrets are encrypted at rest.
neuron_apply_persona_to_botFreeGive 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 metadata with the persona id.
neuron_apply_to_sellFreeApply for seller access (digital products). Requires a Pro plan or higher; a platform admin then grants access.
neuron_approve_reflectionFreeApprove a bot-generated reflection to incorporate the learned insight into the bot's future behavior and responses.
neuron_assign_bot_to_channelFreeAssign a bot to handle incoming messages on a specific WhatsApp channel. Replaces any previously assigned bot.
neuron_assign_bot_to_social_channelFreeAssign 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_baseFreeAttach 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_contactFreeTranscribe 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_contactFreeBlock a WhatsApp contact. Blocked contacts cannot message the bot or see its profile.
neuron_bot_api_chatwrite actionFreeSend 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_botFreeRetrieve configuration and status information about the bot associated with the provided API key.
neuron_bot_api_get_messagesFreeRetrieve message history for a specific conversation with cursor-based pagination. Requires a valid API key.
neuron_bot_api_list_conversationsFreeRetrieve a paginated list of conversations managed by the bot. Supports filtering by conversation status. Requires a valid API key.
neuron_bot_api_sendwrite actionFreeSend 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_poolFreeBrowse verified contact lists available in the shared marketplace pool. Filter by category, region, or search term.
neuron_browse_poolFreeBrowse the shared marketplace pool of published bots, tools, knowledge bases, and reflections with optional filtering by type, category, tags, or search query.
neuron_build_personaFreeDistill 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, themes, dos/donts) + representative exemplars. Requires the collection to have >=3 usable samples. Runs an LLM call (a few seconds).
neuron_build_persona_from_conversationFreeDistill 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' (the other party), 'bot', or 'any'. For a group chat, pass senderName/senderPhone to isolate one participant. Requires >=3 usable text messages. Runs an LLM call.
neuron_build_persona_from_textFreeDistill 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 writing sample, and it reverse-engineers a voiceProfile (tone, diction, cadence, emoji/formatting habits, themes, dos/donts) + exemplars. Provide `text` (auto-split into samples) and/or `samples` (already-split). Runs an LLM call (a few seconds).
neuron_bulk_toggle_builtin_toolsFreeEnable or disable multiple built-in tools at once for a bot. More efficient than toggling tools individually.
neuron_campaign_marketplaceFreeBrowse available campaigns in the marketplace that your organization can join to earn rewards by sending messages.
neuron_campaign_participantsFreeRetrieve all participants who have joined a campaign you own, including their delivery counts and earned rewards.
neuron_cancel_approvalwrite actionFreeCancel a still-pending approval (e.g. the upstream action was aborted). Fires the approval.cancelled callback. Requires a bot API key.
neuron_cancel_bookingwrite actionFreeCancel a confirmed or pending booking. Sends cancellation notifications to the invitee.
neuron_cancel_flow_runwrite actionFreeCancel a running or waiting flow execution. Steps already completed are not rolled back.
neuron_cancel_scheduled_messagewrite actionFreeCancel a scheduled message to prevent it from being sent. Only messages with status 'scheduled' can be cancelled. This action cannot be undone.
neuron_cancel_subscriptionwrite actionFreeCancel the current active subscription. Access continues until the end of the current billing period.
neuron_checkoutFreeInitiate a checkout session for a subscription plan upgrade. Returns a checkout URL or confirmation to complete the purchase.
neuron_close_conversationFreeClose an active conversation, marking it as completed. The bot will stop responding and the conversation is archived.
neuron_complete_bookingFreeMark a confirmed booking as completed (e.g. after the meeting has happened).
neuron_compose_messageFreeCompose and send a new message to a phone number via a specific channel. Automatically creates a new conversation if one does not exist.
neuron_confirm_bookingFreeConfirm a pending booking. Only works on bookings with status 'pending'.
neuron_convert_leadFreePromote 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_requestwrite actionFreeCreate an ad distribution request to send a message to contacts in pool lists matching target demographics. Deducts from wallet upon approval.
neuron_create_api_keywrite actionFreeCreate a new API key for programmatic access to a specific bot. Store the key securely as it cannot be retrieved later.
neuron_create_blog_postwrite actionFreeCreate 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 styled components (heroes, columns, callouts, code cards, embeds, CTAs, sanitized custom HTML). Prefer `blocks` for rich, magazine-style layouts; use `content` for simple prose. If both are given, `blocks` renders and `content` is kept as a fallback.
neuron_create_botwrite actionFreeCreate a new AI bot with specified name, model, and behavior instructions. Returns the created bot object.
neuron_create_broadcastwrite actionFreeCreate 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_calendarwrite actionFreeCreate a new booking calendar with a name, timezone, and visibility setting.
neuron_create_campaignwrite actionFreeCreate a new outreach campaign with target audience, messaging template, and schedule configuration. Requires a Pro or Business plan.
neuron_create_channelwrite actionFreeCreate a new WhatsApp channel with either Meta Cloud API or Baileys (direct WhatsApp) integration. Meta Cloud channels require metaPhoneNumberId and metaAccessToken.
neuron_create_contactwrite actionFreeCreate 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_listwrite actionFreeCreate 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_eventwrite actionFreeCreate a host-initiated event on a calendar. Supports attendees (with WhatsApp/email invitations), location, and daily/weekly/monthly recurrence.
neuron_create_event_typewrite actionFreeCreate a bookable event type on a calendar (e.g. '30-min consultation').
neuron_create_flowwrite actionFreeCreate 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 output handles. BEFORE BUILDING: call neuron_get_flow_catalog and read its `reference` — it carries the JSON shapes you cannot guess: the ConditionGroup + operator list for branch/filter/switch conditions, the `cases`/`assignments`/`weekdays` composite shapes, the handle wiring map, and copy-ready `examples`. Condition `field` on a logic node must be a {{template}} (e.g. '{{trigger.text}}'); on a trigger's config.conditions it is a raw payload path (e.g. 'text'). AFTER SAVING: the flow always saves, but the response includes a `warnings` array flagging likely bugs (unknown node type, missing required field, malformed conditions/cases/assignments, edges wired to a handle a node never emits, missing trigger). Always check it and fix any warnings — a warning means that part will silently no-op at run time. TEMPLATE RESOLUTION: Node config values support {{…}} templates resolved at runtime: {{trigger.text}} — the triggering message text {{trigger.contactPhone}} — the sender's phone {{trigger.senderName}} — the sender's name {{vars.myVar}} — a variable set by logic.set_variable {{nodes.n_abc.output.text}} — output from a previous node {{= amount * 1.1 }} — inline expression (arithmetic, comparisons, ternary) ERROR HANDLING: Any node's config can include __errorHandling: { continueOnFail: true, retryCount: 3, retryDelayMs: 1000 } to retry on failure with exponential backoff and/or continue on the 'error' handle instead of failing the run. WIRING RULES: - logic.branch: 'true' and 'false' handles - logic.switch / logic.ai_router: one handle per case id, plus 'default' - logic.wait_for_reply: 'default' (replied) and 'timeout' - logic.wait_for_approval: 'approved', 'rejected', 'timeout' - logic.wait_first_of: 'reply', 'event', 'timeout' - logic.loop: 'loop' (body) and 'done' - action.lookup_contact: 'found' and 'not_found' - action.call_flow: 'default' (returned), 'timeout', 'error' - All other nodes: 'default' handle (or 'error' when continueOnFail is on)
neuron_create_groupwrite actionFreeCreate 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 whole address book. Optionally pass a unique `slug` to address the group later without its JID. Members blocked by privacy come back in the failed list. Uses the org's default connected session unless `channelId` is given.
neuron_create_kb_entrywrite actionFreeAdd a new entry (note, document, or information piece) to a knowledge base.
neuron_create_knowledge_basewrite actionFreeCreate a new knowledge base to store and organize information, documents, and entries.
neuron_create_lead_sourcewrite actionFreeCreate 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?|hashtag?, limit?}; csv {rows[]}; stream {triggerTaskId?} (fed by the ingest endpoint). Set scheduleKind cron/interval/once for recurring (schedule: cron {time,days?} / interval {everyMinutes} / once {runAt}).
neuron_create_list_campaignwrite actionFreeCreate 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 current members get reached, and nobody is messaged twice per cycle. Multiple campaigns can run on the same or different lists concurrently. On exhaust, either stop or loop (start over after a cooldown).
neuron_create_newsletterwrite actionFreeCreate a new WhatsApp Channel newsletter for one-way broadcast updates. Requires a connected Baileys session on the specified channel.
neuron_create_outbound_webhookwrite actionFreeRegister 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_productwrite actionFreeCreate 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_upload_media) and pass its URL as deliveryFileUrl. On payment, Neuron confirms it and delivers the product to the buyer's WhatsApp automatically.
neuron_create_sms_campaignwrite actionFreeCreate a draft SMS campaign. Choose the audience via sourceType: 'all_contacts' or 'contact_list' (your own contacts), 'phones' (bring your own list — raw numbers you pass in), 'platform' (the wider Neuron audience — budget required, sent over the bulk campaign route), or 'curated' (SMS-opted-in marketplace lists via poolEntryIds; the list owner earns ₦2/contact). After creating, call neuron_estimate_sms_campaign to price it, then neuron_send_sms_campaign. Requires SMS to be enabled by an admin and a configured provider.
neuron_create_social_channelwrite actionFreeCreate 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_taskwrite actionFreeCreate 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 contacts, schedule follow-ups, etc.). Sends are always screened against Do-Not-Contact, a per-run cap, and a no-repeat window.
neuron_create_toolwrite actionFreeCreate a custom API tool that the bot can invoke during conversations to fetch external data or trigger actions.
neuron_create_webhookwrite actionFreeRegister a new inbound webhook endpoint that triggers bot actions when called by an external service.
neuron_delete_ad_requestwrite actionFreePermanently delete a draft ad request. Only ad requests in draft status can be deleted.
neuron_delete_blog_postwrite actionFreePermanently delete a blog post by its ID. This action cannot be undone.
neuron_delete_botwrite actionFreePermanently delete a bot and all its associated data. This action cannot be undone.
neuron_delete_broadcastwrite actionFreePermanently delete a broadcast and its recipient data. This action cannot be undone.
neuron_delete_calendarwrite actionFreePermanently delete a calendar and all its event types, bookings, and availability data.
neuron_delete_campaignwrite actionFreePermanently delete a campaign that is in 'draft' status. Active or funded campaigns cannot be deleted.
neuron_delete_channelwrite actionFreePermanently delete a WhatsApp channel and disconnect any active sessions. This action cannot be undone.
neuron_delete_contactwrite actionFreePermanently delete a contact and remove them from all contact lists. This action cannot be undone.
neuron_delete_contact_listwrite actionFreePermanently delete a contact list. System-protected lists (e.g., 'Do Not Contact') cannot be deleted.
neuron_delete_eventwrite actionFreeDelete a host-created event. For recurring events, use scope to control what gets deleted: 'single' (just this one), 'future' (this and all future), or 'all' (entire series).
neuron_delete_event_typewrite actionFreePermanently delete an event type and all its bookings.
neuron_delete_flowwrite actionFreeSoft-delete a flow. It stops running but can be restored. Running executions are not cancelled.
neuron_delete_flow_runwrite actionFreePermanently delete a completed, failed, or cancelled flow run and all its step data.
neuron_delete_kb_entrywrite actionFreePermanently delete a specific entry from a knowledge base.
neuron_delete_knowledge_basewrite actionFreePermanently delete a knowledge base and all its associated entries and documents.
neuron_delete_list_campaignwrite actionFreePermanently delete a paced list campaign and its reached-set. Does not delete the contacts or the list.
neuron_delete_messagewrite actionFreePermanently delete a specific message from a conversation. This action cannot be undone.
neuron_delete_newsletterwrite actionFreePermanently delete a WhatsApp Channel newsletter and remove it from WhatsApp. This action cannot be undone.
neuron_delete_outbound_webhookwrite actionFreePermanently remove an outbound webhook. The external endpoint will no longer receive event notifications from this bot.
neuron_delete_overridewrite actionFreeRemove a date-specific availability override, reverting to the default weekly hours.
neuron_delete_personawrite actionFreeDelete a voice persona.
neuron_delete_productwrite actionFreePermanently delete a product. Existing orders are retained.
neuron_delete_sms_campaignwrite actionFreeDelete a draft SMS campaign. Only draft campaigns can be deleted.
neuron_delete_social_channelwrite actionFreePermanently delete a social media channel and disconnect any active sessions. This action cannot be undone.
neuron_delete_taskwrite actionFreeDelete a scheduled task. This is a soft delete — the task stops running immediately.
neuron_delete_toolwrite actionFreePermanently remove a custom API tool integration from a bot. The bot will no longer be able to invoke this tool in conversations.
neuron_delete_webhookwrite actionFreePermanently remove an inbound webhook from a bot. External services will no longer be able to trigger this endpoint.
neuron_deliver_orderwrite actionFreeRe-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_basewrite actionFreeRemove a knowledge base from a bot. The bot will no longer reference this knowledge base when generating responses.
neuron_draft_taskFreeTurn 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_create_task after any edits.
neuron_duplicate_productFreeClone 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 enabling. Edit the copy with neuron_update_product, then set enabled: true to publish.
neuron_edit_messageFreeEdit the content of a previously sent message in a conversation. Only the message sender can edit their messages.
neuron_enroll_membersFreeManually enroll existing / off-platform people into a membership product WITHOUT a payment. Use this to backfill members who were already in the WhatsApp group before you switched membership on, so the renewal + eviction cycle applies to them too. No order or revenue is booked. Each enrolled member gets a free first period (firstPeriodDays, or one normal interval by default), then renews like everyone else — reminder-only until they connect a Neuron account (no auto-charge). Existing members are left untouched (counted as skipped). Returns { enrolled, skipped, total }.
neuron_estimate_sms_campaignFreePrice a draft SMS campaign before sending: returns recipient count, SMS provider cost, curated owner payout (₦2/contact), and the total in kobo. Call this before neuron_send_sms_campaign.
neuron_export_contactsFreeExport all contacts as a downloadable dataset for the current organization.
neuron_extract_leadswrite actionFreeRun 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_source (e.g. type='text_paste', config={text}).
neuron_find_contact_lists_for_contactFreeRetrieve all contact lists that a specific contact belongs to.
neuron_forward_messageFreeForward a WhatsApp message from one chat to another. Uses copy-send approach — the message content is re-sent to the destination.
neuron_fund_ad_requestFreeFund 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_campaignFreeFund an approved campaign by deducting the total budget from the organization's wallet balance. Requires sufficient wallet funds.
neuron_fund_walletFreeInitialize a wallet funding transaction via Paystack. Returns a checkout URL to complete the payment in a browser.
neuron_generate_from_personaFreeGenerate content written in the persona's voice for a topic/brief. Returns N variations. Stateless — nothing is persisted.
neuron_get_ad_requestFreeGet detailed information about a specific ad request, including pool selections if targeting mode is manual.
neuron_get_ad_request_analyticsFreeRetrieve delivery analytics and performance breakdown for a specific ad request, including delivery rates and cost metrics.
neuron_get_approvalFreeFetch 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_availabilityFreeRetrieve the default availability schedule (weekly hours + timezone) for a calendar.
neuron_get_available_slotsFreeCompute available time slots for an event type over a date range, accounting for availability, existing bookings, buffers, and Google Calendar busy times.
neuron_get_bank_accountFreeRetrieve the saved bank account details currently configured as the organization's payout destination.
neuron_get_billingFreeRetrieve the current billing information, subscription plan, and usage details for the organization.
neuron_get_blocklistFreeFetch the list of all blocked WhatsApp contacts for the bot on the given channel.
neuron_get_blog_postwrite actionFreeRetrieve a single blog post by its URL-friendly slug, including full content and metadata.
neuron_get_bookingFreeRetrieve details of a specific booking.
neuron_get_botFreeRetrieve detailed information about a specific bot including its configuration, status, and associated resources.
neuron_get_bot_analyticsFreeRetrieve analytics and usage statistics for a specific bot, including message counts, response times, and conversation metrics.
neuron_get_broadcastFreeRetrieve detailed information about a specific broadcast, including its status, message content, and recipient summary.
neuron_get_broadcast_recipientsFreeRetrieve the paginated list of recipients for a specific broadcast with their individual delivery status.
neuron_get_business_profileFreeFetch the WhatsApp Business profile of an external contact, including description, website, category, and business hours.
neuron_get_calendarFreeRetrieve details of a specific calendar by its ID.
neuron_get_campaignFreeRetrieve detailed information about a specific campaign including its status, budget, participants, and delivery metrics.
neuron_get_channelFreeRetrieve detailed information about a specific WhatsApp channel, including its configuration, type, and connection status.
neuron_get_channel_eventsFreeRetrieve the event log for a channel, including connection events, message events, and errors. Supports pagination.
neuron_get_channel_qrFreeRetrieve the current QR code for pairing a Baileys channel with WhatsApp. A session must be started first.
neuron_get_channel_statusFreeRetrieve the current connection status and session details for a specific channel (e.g., connected, disconnected, qr_pending).
neuron_get_collectionFreeFetch a collection's metadata by id.
neuron_get_collection_itemsFreeBrowse the mined content in a collection — posts/comments/profiles with author, content, engagement and engagementScore. sort 'top' ranks by engagement (great for picking the best clips/posts to reuse or distill into a persona).
neuron_get_contactFreeRetrieve detailed information about a specific contact including their tags, notes, and associated lists.
neuron_get_contact_listFreeRetrieve detailed information about a specific contact list, including member count and configuration.
neuron_get_contact_list_membersFreeRetrieve the members of a specific contact list with optional search filtering and pagination.
neuron_get_conversationFreeRetrieve detailed information about a specific conversation, including its status, participants, and metadata.
neuron_get_eligible_contactsFreeRetrieve contacts eligible to receive a campaign message. Respects deduplication rules and mutual contact requirements.
neuron_get_event_typeFreeRetrieve details of a specific event type.
neuron_get_flowFreeRetrieve a single flow by id, including its full graph (nodes and edges), enabled status, and run stats.
neuron_get_flow_catalogFreeRetrieve 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 parts: • `data`: every node type (all triggers, logic, and actions) with its config `fields` (including `options` enums and `required`), output `handles`, and `dynamicHandles`. • `reference`: the authoring guide you need for anything non-trivial — - `conditions`: the ConditionGroup JSON shape + the full operator vocabulary (used by branch/filter/switch/loop and trigger filters). Note: on LOGIC nodes a rule's `field` is a {{template}}; on a TRIGGER's config.conditions it is a raw payload path. - `compositeFields`: the exact JSON for field kinds the flat schema can't express — `cases` (switch), `assignments` (set_fields), `weekdays`, and the delay amount/unit note. - `triggerConditions`: every trigger also accepts an optional config.conditions AND/OR filter over the raw event payload. - `templating`, `errorHandling` (__errorHandling), `handles` (wiring map), and `examples` (simple, branching AND/OR, and complex switch+set_fields+expression graphs to imitate). The catalog is grouped by kind: trigger (entry points), logic (routing/waits/data), action (side effects). There are dozens of node types — read `data` for the authoritative list rather than assuming.
neuron_get_flow_runwrite actionFreeGet 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 this to debug flows — see exactly what happened at each step.
neuron_get_group_invite_linkFreeGet the invite link for a WhatsApp group. Only supported on Baileys channels where the bot is a group admin.
neuron_get_group_participantsFreeRetrieve the list of participants in a specific WhatsApp group accessible through a channel.
neuron_get_knowledge_baseFreeRetrieve detailed information about a specific knowledge base by its ID.
neuron_get_list_campaignFreeGet 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_messagesFreeRetrieve messages from a specific conversation in chronological order, with optional cursor-based pagination.
neuron_get_newsletterFreeRetrieve detailed information about a specific WhatsApp Channel newsletter, including subscriber count and metadata.
neuron_get_organizationFreeRetrieve detailed information about a specific organization, including its name, settings, and configuration.
neuron_get_outbound_webhook_logsFreeRetrieve delivery logs for an outbound webhook to monitor event dispatch history and debug delivery failures.
neuron_get_personaFreeGet one voice persona (full voiceProfile + exemplars).
neuron_get_pool_itemFreeRetrieve detailed information about a specific item in the marketplace pool, including its description, category, tags, and install count.
neuron_get_privacy_settingsFreeFetch the bot's current WhatsApp privacy settings (last seen, online, profile picture, status, read receipts, groups add).
neuron_get_productFreeGet a single product by id, with its public URL and fee breakdown.
neuron_get_profileFreeRetrieve the authenticated user's profile information including name, email, role, and current organization.
neuron_get_scheduled_messageFreeRetrieve detailed information about a specific scheduled message, including its status, send time, and message content.
neuron_get_sms_campaignFreeRetrieve a single SMS campaign with its status and delivery counters.
neuron_get_social_channelFreeRetrieve detailed information about a specific social media channel, including its platform, credentials status, and connection state.
neuron_get_social_channel_statusFreeRetrieve the current session status for a social media channel (e.g., connected, disconnected, error).
neuron_get_storefrontFreeGet this seller's storefront profile (handle, display name, bio, branding) and its public URL.
neuron_get_task_runsFreeRetrieve the paginated execution history for a task — each run's status, AI summary, tool steps, and stats (messages sent, contacts processed).
neuron_get_webhook_logsFreeRetrieve execution logs for an inbound webhook to monitor incoming requests and debug processing issues.
neuron_google_calendar_disconnectFreeDisconnect a calendar from Google Calendar sync.
neuron_google_calendar_statusFreeCheck whether a calendar is connected to Google Calendar and when it last synced.
neuron_handle_join_requestsFreeApprove or reject pending join requests for a WhatsApp group. Requires admin privileges.
neuron_import_contactsFreeBulk import multiple contacts into the organization's address book. Accepts an array of contact objects with name, phone, and optional fields.
neuron_ingest_knowledgeFreeIngest content into a knowledge base. Supports deduplication via externalId and optional LLM processing (summarize, extract_facts, or custom instruction).
neuron_install_from_poolFreeInstall 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_memberwrite actionFreeSend an invitation to a new member to join the organization. The invitee receives an email with a link to accept.
neuron_join_campaignFreeJoin a marketplace campaign as a participant to earn rewards by sending messages through your WhatsApp channel.
neuron_lead_statsFreeCounts of leads by status.
neuron_leave_groupFreeMake the bot leave a WhatsApp group. This action is irreversible — the bot will need to be re-added by an admin.
neuron_list_ad_requestsFreeRetrieve all ad requests for the current organization with optional status filtering and pagination.
neuron_list_api_keysFreeRetrieve all API keys associated with a specific bot, including their names, creation dates, expiration status, and revocation status.
neuron_list_approvalsFreeList approval requests for the organization, newest first. Filter by status (pending/approved/rejected/expired/cancelled). Requires a bot API key.
neuron_list_audit_logsFreeRetrieve audit logs for the organization, showing a chronological record of actions performed by members. Supports filtering by action type and resource.
neuron_list_blog_postsFreeRetrieve a paginated list of blog posts with optional filtering by status, author type, author ID, or tag.
neuron_list_bookingsFreeList bookings (inbound and host-created) with optional filters for calendar, status, date range, and source.
neuron_list_bot_channelsFreeRetrieve all WhatsApp channels connected to a specific bot, including primary and secondary connections.
neuron_list_bot_knowledge_basesFreeRetrieve all knowledge bases attached to a specific bot, including their priorities and metadata.
neuron_list_botsFreeRetrieve all bots accessible to the current user, including their configurations and status.
neuron_list_broadcastsFreeRetrieve a paginated list of all broadcasts with optional filtering by status such as draft, sent, or scheduled.
neuron_list_builtin_toolsFreeRetrieve 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_calendarsFreeRetrieve all booking calendars for the current organization.
neuron_list_campaignsFreeRetrieve all campaigns for the current organization with optional status filtering and pagination.
neuron_list_channel_groupsFreeRetrieve all WhatsApp groups that the channel is participating in, including group metadata.
neuron_list_channelsFreeRetrieve all WhatsApp channels configured in the current organization, including their type and connection status.
neuron_list_collectionsFreeList content collections (where web-agent missions and captures land). Returns each collection's item count, kind and source.
neuron_list_contact_listsFreeRetrieve all contact lists for the current organization with optional filtering by search term, type, and pagination.
neuron_list_contactsFreeRetrieve all contacts for the current organization with optional filtering by search term, tag, and pagination.
neuron_list_conversationsFreeRetrieve a paginated list of conversations for a specific bot, with optional filtering by status.
neuron_list_event_typesFreeRetrieve all event types, optionally filtered by calendar.
neuron_list_eventsFreeList host-created events, optionally filtered by calendar and date range.
neuron_list_flow_runsFreeList execution runs for a flow, newest first. Each run shows status (running/waiting/completed/failed/cancelled), trigger type, step count, and timing.
neuron_list_flowsFreeList 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_installedFreeList all items the current organization has installed from the marketplace pool.
neuron_list_invitationsFreeRetrieve a list of all pending invitations for the organization that have not yet been accepted or revoked.
neuron_list_kb_botsFreeRetrieve all bots that are connected to or using a specific knowledge base.
neuron_list_kb_entriesFreeRetrieve entries from a knowledge base with optional filtering and pagination.
neuron_list_knowledge_basesFreeRetrieve all knowledge bases accessible to the current user.
neuron_list_lead_sourcesFreeList configured lead sources for the org.
neuron_list_leadsFreeList leads from the pool, filterable by status (new/enriched/contacted/converted/rejected), sourceId, and search.
neuron_list_list_campaignsFreeList all paced list campaigns for the organization, optionally filtered to a single contact list.
neuron_list_membersFreeRetrieve a list of all members in the organization, including their roles and permissions.
neuron_list_newslettersFreeRetrieve a paginated list of all WhatsApp Channel newsletters for the organization, with optional filtering by WhatsApp session channel.
neuron_list_ordersFreeList recent product orders (sales) for this seller, with buyer, amount, fee breakdown, and status.
neuron_list_organizationsFreeRetrieve all organizations the authenticated user belongs to, including their roles in each.
neuron_list_outbound_webhooksFreeRetrieve all outbound webhooks configured for a specific bot, including their target URLs and subscribed event types.
neuron_list_overridesFreeList date-specific availability overrides for a calendar (e.g. holidays, special hours).
neuron_list_payoutsFreeRetrieve the payout history for the organization, including amounts, statuses, and timestamps.
neuron_list_personasFreeList 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_productsFreeList all products for this seller, each with its public checkout URL and price breakdown.
neuron_list_publishedFreeList all items the current organization has published to the marketplace pool.
neuron_list_reflectionsFreeRetrieve pending reflections that the bot has generated from conversations, awaiting human review. Optionally filter by approval status.
neuron_list_reviewsFreeList verified-purchase reviews across this seller's products (rating, text, buyer, status).
neuron_list_scheduled_messagesFreeRetrieve a paginated list of scheduled messages for the current organization, with optional filtering by status (scheduled, sent, failed, cancelled).
neuron_list_sms_campaignsFreeList the organization's SMS campaigns, optionally filtered by status or type.
neuron_list_social_channelsFreeRetrieve all social media channels (Instagram, Twitter/X) configured in the current organization.
neuron_list_tasksFreeList 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_toolsFreeRetrieve all custom API tool integrations configured for a specific bot, including their endpoints and configuration.
neuron_list_webhooksFreeRetrieve all inbound webhooks configured for a specific bot, including their status and configuration.
neuron_list_whatsapp_contactsFreeRetrieve contacts from the WhatsApp account connected to this channel, with optional search filtering.
neuron_loginFreeAuthenticate 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_logoutFreeClear 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_readFreeMark a WhatsApp message as read, sending read receipts to the sender.
neuron_mark_no_showFreeMark a booking as no-show when the invitee did not attend.
neuron_merge_contact_listsFreeMerge 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_participationsFreeRetrieve all campaigns the current organization has joined as a participant, including earnings and delivery stats.
neuron_pause_ad_requestFreePause an active ad request campaign. Distribution stops until resumed. Only active ad requests can be paused.
neuron_pause_botFreePause a bot to temporarily stop it from processing new messages. The bot retains its configuration and can be resumed later.
neuron_pause_campaignFreePause an active campaign to temporarily stop message delivery. Can be resumed later with the resume action.
neuron_pause_list_campaignFreePause a paced list campaign. No further batches run until resumed. The cursor is preserved.
neuron_pause_sms_campaignFreePause a sending drip SMS campaign. Only drip campaigns in the 'sending' state can be paused.
neuron_populate_contactsFreeEnrich existing contacts with additional data from connected messaging channels. Syncs profile information from linked platforms.
neuron_post_to_newsletterwrite actionFreePost 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_statuswrite actionFreePost 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 list is built automatically; pass statusJidList only to target a subset). Provide at least one of text or mediaUrl. channelId is optional and auto-resolves to the default connected number. This triggers delivery and cannot be undone.
neuron_product_membersFreeList 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 attached WhatsApp group (if one is attached), plus totals.
neuron_publish_blog_postwrite actionFreePublish a blog post, making it publicly visible. The post must be in 'draft' status.
neuron_publish_to_poolwrite actionFreePublish a bot, tool, knowledge base, or reflection to the shared marketplace pool for other organizations to discover and install.
neuron_pull_pool_updatewrite actionFreePull 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_listFreeTrigger a refresh of a dynamic contact list. Re-evaluates criteria rules and/or AI prompt and materializes updated members.
neuron_refresh_newsletterFreeRe-fetch metadata (name, description, subscriber count) for a WhatsApp Channel newsletter from WhatsApp to synchronize local data.
neuron_refresh_tokenFreeRefresh the access token using a refresh token. Automatically sets the new access token for subsequent API calls.
neuron_refund_orderwrite actionFreeRefund a paid order via Paystack. The buyer is refunded and the sale amount is reversed from your wallet.
neuron_registerFreeRegister a new user account with name, email, password, and organization name. Creates both the user and an initial organization.
neuron_reject_reflectionFreeReject a bot-generated reflection to prevent it from being incorporated into the bot's learned behavior.
neuron_release_conversationFreeRelease a conversation back to the bot, returning control from a human agent. The bot will resume auto-responding.
neuron_remove_bot_channelwrite actionFreeDisconnect a WhatsApp channel from a bot. The bot will no longer respond to messages on this channel.
neuron_remove_from_contact_listwrite actionFreeRemove one or more contacts from a list by their contact IDs. Does not delete the contacts themselves.
neuron_remove_group_memberswrite actionFreeRemove 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_memberwrite actionFreePermanently remove a member from the organization. The member loses all access immediately. This action cannot be undone.
neuron_remove_profile_picturewrite actionFreeRemove the bot's WhatsApp profile picture, reverting to the default.
neuron_remove_tool_secretwrite actionFreePermanently delete a stored secret from a custom tool integration. The tool will lose access to this credential.
neuron_request_approvalFreeAsk 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 to gate any action needing human sign-off (refunds, deploys, spend, publishing). Returns an approvalId; poll neuron_get_approval / neuron_list_approvals for the outcome, or supply a webhook in `callback` to be notified. Requires a bot API key ('nrn_' prefix).
neuron_request_pair_codeFreeRequest a numeric pairing code for a Baileys channel as an alternative to QR code scanning. Requires the phone number to pair with.
neuron_request_payoutFreeRequest a payout to transfer funds from the organization wallet to the linked bank account. A bank account must be saved first.
neuron_reschedule_bookingFreeReschedule a booking to a new time. Creates a new booking and marks the old one as rescheduled.
neuron_respond_approvalFreeApprove or reject a pending approval programmatically — the decision surface for an authorized operator acting via MCP instead of replying on WhatsApp. Fires the configured callback and posts the outcome to the WhatsApp chat. Exactly-once: the first responder (here or on WhatsApp) wins; later responses return 410. Requires a bot API key.
neuron_resume_ad_requestFreeResume a paused ad request campaign. Distribution resumes from where it left off. Only paused ad requests can be resumed.
neuron_resume_botFreeResume a previously paused bot so it begins processing new messages again.
neuron_resume_campaignFreeResume a previously paused campaign to restart message delivery.
neuron_resume_list_campaignFreeResume a paused paced list campaign. It picks up from where the cursor left off.
neuron_resume_sms_campaignFreeResume a paused drip SMS campaign.
neuron_revoke_api_keyFreePermanently revoke an API key to immediately invalidate it and prevent further programmatic access. This action cannot be undone.
neuron_revoke_group_inviteFreeRevoke the current group invite link and generate a new one. The old link will stop working. Requires admin.
neuron_revoke_invitationFreeRevoke a pending organization invitation so it can no longer be accepted. This action cannot be undone.
neuron_rewrite_textFreeRewrite or rephrase text using AI with specified tone, style, or instructions (e.g., make it more formal, translate, summarize).
neuron_run_flowwrite actionFreeManually 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 {{trigger.*}} in the flow.
neuron_run_lead_sourcewrite actionFreeRun a lead source now to pull new leads into the pool (queues the extraction).
neuron_run_list_campaign_nowwrite actionFreeFire 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_taskwrite actionFreeTrigger a task to run immediately (in addition to its normal schedule). Returns once the run is queued.
neuron_sales_statsFreeTotal paid sales count and net revenue (kobo) for this seller.
neuron_save_bank_accountFreeSave a verified bank account as the organization's payout destination. Verify the account first using neuron_verify_bank_account.
neuron_search_contactsFreeSearch contacts by a query string across name, phone number, and email fields. Returns matching contacts ranked by relevance.
neuron_search_knowledgeFreePerform semantic search across all entries and documents in a knowledge base to find relevant information.
neuron_seller_statusFreeCheck whether this account can sell (Pro plan + admin-granted access) and any pending application.
neuron_semantic_search_contactsFreeSearch 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_broadcastwrite actionFreeSend 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_messagewrite actionFreeSend 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_cardwrite actionFreeSend a vCard contact card via WhatsApp with name, phone, and optional organization.
neuron_send_locationwrite actionFreeSend a location pin via WhatsApp with coordinates and optional name/address.
neuron_send_messagewrite actionFreeSend a message to an existing conversation. Supports text, image, and document message types with optional media attachments.
neuron_send_pollwrite actionFreeSend a poll message via WhatsApp. Polls support 2-12 options and optional multi-select. Only supported on Baileys channels.
neuron_send_reactionwrite actionFreeSend or remove an emoji reaction on a WhatsApp message. Pass an empty emoji string to remove a reaction.
neuron_send_sms_campaignwrite actionFreeSend a draft SMS campaign. Debits the wallet for the SMS cost plus any curated owner payout, then queues delivery. Returns a 402 with shortfall details if the wallet balance is insufficient (fund the wallet with neuron_fund_wallet and retry).
neuron_send_stickerwrite actionFreeSend 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 the platform-wide community sticker library (falling back to this org's own stickers). Advanced: pass `stickerUrl` with a direct public WebP image URL instead. Provide one of the two. Only supported on Baileys channels.
neuron_send_whatsappwrite actionFreeSend 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_channelFreeSet 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_approvalFreeEnable or disable join approval mode for a WhatsApp group. When enabled, join requests must be manually approved by admins. Requires admin.
neuron_set_overrideFreeSet a date-specific availability override — mark a day as unavailable, or set custom hours for that date.
neuron_set_presenceFreeSet typing indicator or online/offline presence on a WhatsApp chat. Only supported on Baileys channels.
neuron_start_channel_sessionFreeStart 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_sessionFreeStart or reconnect a social media session for the channel. Initializes the platform client with stored credentials.
neuron_stop_ad_requestFreeStop an active or paused ad request campaign permanently. Any remaining unspent budget is refunded to the organization wallet. This cannot be undone.
neuron_stop_campaignFreePermanently stop an active campaign and refund the remaining unspent budget to the organization's wallet. This action cannot be undone.
neuron_stop_channel_sessionFreeStop the active Baileys session for the channel and disconnect from WhatsApp. The channel can be restarted later.
neuron_stop_social_channel_sessionFreeStop the active session for a social media channel. The channel can be restarted later.
neuron_studio_agentFreeBuild a new video or edit an existing one from a natural-language instruction. Returns the updated ProjectDoc plus the list of edits made. Pass the returned `doc` back in to keep iterating, or to neuron_studio_render to produce an MP4. Does NOT render.
neuron_studio_applyFreeApply a batch of Studio tool calls to a video doc and get back the updated doc plus a fresh scene description — YOU (this agent) are the brain, so this needs NO OpenRouter/AI key. Loop: call neuron_studio_catalog once, then neuron_studio_apply with { doc, calls:[{tool,args}] }, read the returned `scene`, apply more, and finally neuron_studio_render. Omit `doc` (with an optional `platform`) to start a fresh video.
neuron_studio_catalogFreeGet the Studio's editing vocabulary — every tool (add_text, add_shape, animate_layer, set_visibility_window, group, trim_clip, add_overlay, add_scene, set_transition, …) with its JSON-schema arguments. Read this first when driving the Studio yourself with neuron_studio_apply.
neuron_studio_generate_imageFreeText → image (AI b-roll) via the org's Replicate key. Returns { url } (an external URL). Re-host it (neuron_studio_rehost_media) so it persists, then place it with neuron_studio_apply add_image. Business plan + an image-model version configured in Studio settings.
neuron_studio_generate_videoFreeText → video via Replicate (async). Returns { id, status } — poll neuron_studio_generate_video_status until 'succeeded' to get videoUrl, then re-host + add_video. Needs a genvideo model version configured.
neuron_studio_generate_video_statusFreePoll an AI video job. When status is 'succeeded', videoUrl is the result (external — re-host it before use).
neuron_studio_import_media_urlFreeFetch a video from a direct link or a platform page (YouTube / Instagram / TikTok / X / LinkedIn) and re-host it so the Studio + renderer can use it. Returns { url, filename, kind, w, h, durationMs }. Put the returned url on a video layer in the ProjectDoc.
neuron_studio_makeFreeOne-shot: build/edit a video from a prompt AND start the MP4 render. Returns the ProjectDoc, the edits, and a render `job` — poll it with neuron_studio_render_status until status is 'completed' to get the outputUrl. Great for 'make me a 20s TikTok reel about X'. Requires a Pro+ plan.
neuron_studio_rehost_mediaFreeFetch any image/video/audio URL and re-host it on Neuron so it's stable and server-reachable — use this on external/temporary URLs (AI-generated b-roll, etc.) before placing them with add_image/add_video/add_audio. Returns { url, filename }.
neuron_studio_renderwrite actionFreeSubmit a Studio ProjectDoc for a headless MP4 render. Returns a job id — poll neuron_studio_render_status until 'completed'. Any media (video/image) in the doc must be a server-reachable URL (use neuron_studio_import_media_url / neuron_studio_upload_media first). Requires a Pro+ plan.
neuron_studio_render_statusFreePoll a render job by id. When status is 'completed', outputUrl is the finished MP4. status is queued | rendering | completed | failed.
neuron_studio_saveFreePersist a ProjectDoc and get back an `openUrl`. Opening it drops the video into the Studio in the user's browser, where 'Export MP4' renders CLIENT-SIDE (on their machine, no server render cost). Use this for the hybrid flow: build with neuron_studio_apply/agent, then save and hand the user the link. Use neuron_studio_render instead only for headless/unattended server renders.
neuron_studio_transcribeFreeTranscribe a hosted media/audio URL into time-coded caption cues { cues:[{startSeconds,endSeconds,text}] }. Feed them to neuron_studio_apply add_captions to subtitle existing footage. Needs a transcription key on the org.
neuron_studio_transform_videowrite actionFreeRun an AI transform on a hosted video via Replicate (async): op 'bg-remove' or 'face-swap' (face-swap needs imageUrl). Returns { id, status } — poll neuron_studio_transform_video_status for videoUrl. Needs the matching model version configured.
neuron_studio_transform_video_statusFreePoll a video-transform job. When status is 'succeeded', videoUrl is the result (external — re-host before use).
neuron_studio_upload_mediawrite actionFreeUpload a local image/video (base64) to the Studio media store (uncapped) so the renderer can fetch it. Returns { url, filename }. Put the url on an image/video layer.
neuron_studio_voiceoverFreeTurn a script into a hosted voiceover audio URL, optionally with caption cues synced to the speech. Returns { url, durationSeconds, cues? }. Then place it with neuron_studio_apply: add_audio({url, label:'Voiceover', durationSeconds}) and add_captions({cues}). This makes fully-voiced reels possible from a prompt. Needs a TTS key on the org (captions also need a transcription key).
neuron_submit_ad_requestwrite actionFreeSubmit 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_campaignwrite actionFreeSubmit a draft campaign for admin review and approval. The campaign must be in 'draft' status.
neuron_submit_to_list_poolwrite actionFreeSubmit a contact list to the shared pool marketplace for other organizations to discover and use for ad distribution.
neuron_switch_instanceFreeSwitch 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_orgFreeSwitch to a different organization. Returns a new access token scoped to the target organization and automatically sets it.
neuron_sync_knowledgeFreeTrigger a synchronization operation to refresh embeddings, reindex content, or update the knowledge base state.
neuron_sync_newslettersFreeSynchronize and import WhatsApp Channels from a connected WhatsApp session into Neuron. Discovers channels created outside Neuron.
neuron_sync_reflectionsFreeSynchronize all approved reflections into the bot's active knowledge base, applying learned insights to future conversations.
neuron_sync_whatsapp_contactsFreeSynchronize contacts from all connected WhatsApp channels into the organization's contact database. Creates new contacts for unseen numbers.
neuron_takeover_conversationwrite actionFreeTransfer control of a conversation from the bot to a human agent. The bot will stop auto-responding until the conversation is released.
neuron_team_availabilityFreeFind available slots across all team calendars. Mode 'any' returns slots where at least one member is free (round-robin), 'all' requires everyone to be free (collective).
neuron_test_toolwrite actionFreeExecute a dry-run test of a custom API tool with sample arguments to verify the endpoint responds correctly.
neuron_toggle_builtin_toolFreeToggle 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_featuredFreeToggle the featured status of a pool item. Featured items appear prominently in the marketplace. Requires admin privileges.
neuron_toggle_flowFreeEnable or disable a flow. Disabled flows stop receiving events but retain their graph.
neuron_toggle_taskFreePause or resume a scheduled task (flips its enabled state and reschedules the next run).
neuron_unassign_bot_from_channelwrite actionFreeRemove the bot assignment from a WhatsApp channel. The channel will stop auto-responding to messages.
neuron_unassign_bot_from_social_channelwrite actionFreeRemove the bot assignment from a social media channel. The bot will lose access to the channel's social media credentials.
neuron_unblock_contactFreeUnblock a previously blocked WhatsApp contact.
neuron_unpublish_from_poolFreePermanently remove a published item from the marketplace pool. Organizations that installed this item will retain their copies.
neuron_update_ad_requestwrite actionFreeUpdate a draft or rejected ad request. Only draft and rejected ad requests can be edited. Rejected requests revert to draft on update.
neuron_update_availabilitywrite actionFreeSet the weekly availability hours for a calendar. Each day maps to an array of { start, end } time windows in HH:mm format.
neuron_update_blog_postwrite actionFreeUpdate an existing blog post's content, metadata, status, or SEO fields. Only provided fields are changed.
neuron_update_booking_noteswrite actionFreeAdd or update host notes on a booking.
neuron_update_botwrite actionFreeUpdate an existing bot's configuration. Only provided fields are modified; omitted fields remain unchanged.
neuron_update_broadcastwrite actionFreeUpdate an existing broadcast's name, message content, or media before sending. The broadcast must still be in draft status.
neuron_update_calendarwrite actionFreeUpdate a calendar's settings. Only provided fields are modified.
neuron_update_campaignwrite actionFreeUpdate a campaign that is in 'draft' or 'rejected' status. Active or completed campaigns cannot be modified.
neuron_update_channelwrite actionFreeUpdate configuration of an existing WhatsApp channel. Only provided fields are modified; omitted fields remain unchanged.
neuron_update_contactwrite actionFreeUpdate 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_listwrite actionFreeUpdate an existing contact list's name, slug, description, criteria, or refresh schedule.
neuron_update_eventwrite actionFreeUpdate a host-created event. Use scope='future' to update all future instances of a recurring series.
neuron_update_event_typewrite actionFreeUpdate an event type's settings. Only provided fields are modified.
neuron_update_flowwrite actionFreeUpdate 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 replaces the existing graph entirely. When a graph is supplied the response includes a non-blocking `warnings` array (same checks as create_flow) — check it and fix any flagged issues.
neuron_update_group_descriptionwrite actionFreeUpdate the description of a WhatsApp group. Requires the bot to be a group admin.
neuron_update_group_memberswrite actionFreeAdd, remove, promote, or demote members in a WhatsApp group. Provide phone numbers or JIDs. Requires admin privileges.
neuron_update_group_settingswrite actionFreeChange 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_subjectwrite actionFreeUpdate the name/subject of a WhatsApp group. Requires the bot to be a group admin.
neuron_update_kb_entrywrite actionFreeUpdate the content, title, folder, or source of an existing knowledge base entry.
neuron_update_knowledge_basewrite actionFreeUpdate the properties of an existing knowledge base such as name, description, or root instruction.
neuron_update_list_campaignwrite actionFreeUpdate 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_memberwrite actionFreeUpdate a member's permissions within the organization, such as conversation access. Only provided fields are changed.
neuron_update_newsletterwrite actionFreeUpdate the name or description of an existing WhatsApp Channel newsletter. Only provided fields are changed.
neuron_update_organizationwrite actionFreeUpdate organization settings such as name, description, or configuration preferences. Only provided fields are changed.
neuron_update_outbound_webhookwrite actionFreeModify an existing outbound webhook's configuration, including its destination URL, subscribed event types, or filter prompt.
neuron_update_personawrite actionFreeUpdate a persona's name/description, or hand-tune its voiceProfile / exemplars.
neuron_update_pool_itemwrite actionFreeUpdate 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_settingwrite actionFreeUpdate 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_productwrite actionFreeUpdate any field of a product (price, delivery, cover, enabled, fee payer, …).
neuron_update_profile_namewrite actionFreeUpdate the bot's WhatsApp display name on the given channel.
neuron_update_profile_picturewrite actionFreeUpdate the bot's WhatsApp profile picture from an image URL.
neuron_update_profile_statuswrite actionFreeUpdate the bot's WhatsApp status/bio text.
neuron_update_scheduled_messagewrite actionFreeUpdate the message content, media, or send time of a scheduled message. Only messages with status 'scheduled' can be updated.
neuron_update_social_channelwrite actionFreeUpdate an existing social media channel. Can update label, username, or refresh credentials.
neuron_update_storefrontwrite actionFreeCreate or update the seller storefront (nestuge-style page). Handle is auto-generated from the display name if omitted.
neuron_update_taskwrite actionFreeUpdate a scheduled task's instruction, schedule, timezone, enabled state, or config. Only provided fields change.
neuron_update_toolwrite actionFreeModify an existing custom API tool's configuration, including its endpoint, authentication, or request template.
neuron_update_webhookwrite actionFreeModify an existing inbound webhook's configuration, such as its name, event type, or processing prompt.
neuron_update_whatsapp_credentialswrite actionFreeUpdate WhatsApp Business API credentials for the organization. These credentials are required for sending messages via the WhatsApp Cloud API.
neuron_upload_documentwrite actionFreeUpload a text document to a knowledge base. The document will be automatically chunked and indexed for semantic search.
neuron_upload_mediawrite actionFreeUpload 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_channelFreeTest whether the stored credentials for a social channel are still valid by making a test API call to the platform.
neuron_verify_bank_accountFreeVerify a Nigerian bank account number via Paystack to confirm the account holder name before saving.
neuron_verify_wallet_fundingFreeVerify a wallet funding transaction using the Paystack payment reference to confirm the payment was successful.
neuron_wallet_balanceFreeRetrieve the current wallet balance for the organization, including available and pending amounts.
neuron_wallet_transactionsFreeRetrieve the wallet transaction history for the organization, with optional filtering by transaction type.
neuron_webagent_command_historyFreeSee the launch/stop/open commands queued for the extension and their outcomes (pending|claimed|done|failed, plus the runId a launch created).
neuron_webagent_get_runwrite actionFreeFetch one run's status, config snapshot and latest live stats (captured/flushed/leads/reels/hops/scrolls). status is running|stopped|completed|killed|stale.
neuron_webagent_killwrite actionFreeThe kill switch — flags a run to stop. It's cooperative: the browser extension stops on its next heartbeat (usually within ~12s) and finalizes the run.
neuron_webagent_list_runsFreeList browser-mission runs (live + recent). Stale runs (no heartbeat >2min) show as 'stale'. Note the result nests as data.data[].
neuron_webagent_open_launcherFreeAsk the extension to open its Web Agent panel so the user can review/adjust a mission before it runs. Delivered on the extension's next poll.
neuron_webagent_runwrite actionFreeQueue a browser mission for the user's Neuron extension to run — mine content into a Collection or prospects into the lead pool. Returns a command id; the extension picks it up on its next poll (so the browser must be open, signed in, and remote-control enabled in the extension). Watch it with neuron_webagent_list_runs / neuron_webagent_get_run and stop it with neuron_webagent_kill.
neuron_webagent_stopFreeQueue a graceful stop for the current mission (the extension finalizes it). For an immediate hard stop of a specific run, use neuron_webagent_kill.
neuron_whoamiFreeCheck which Neuron account is currently logged in, including user name, email, role, and organization.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan59 source files scanned25/25
- Live reliabilityremote reachable in 2808ms17/20
- Tool poisoning383 tool descriptions checked13/15
- Auth qualityopen endpoint exposes 146 write-action tools with no auth3/15
- Maintenancerepository not readable: repo not found3/15
- Maintainer identityno repository or website to verify2/10
Findings (2)
- highWrite-action tools reachable without authentication
auth.open-write - lowUnusually long tool description (over 2,000 characters)
poison.long-descriptiontool neuron_create_flow: …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 output handles. BEFORE BUILDING: call neuron_get_flow_catalog and read its `reference` — it carries the JSON shapes you cannot guess: the ConditionGroup + operator list for branch/filter/switch conditions, the `cases`/`assignments`/`weekdays` composite shapes, the handle wiring map, and copy-ready `examples`. Condition `field` on a logic node must be a {{template}} (e.g. '{{trigger.text}}'); on a trigger's config.conditions it is a raw payload path (e.g. 'text'). AFTER SAVING: the flow always saves, but the response includes a `warnings` array flagging likely bugs (unknown node type, missing required field, malformed conditions/cases/assignments, edges wired to a handle a node never emits, missing trigger). Always check it and fix any warnings — a warning means that part will silently no-op at run time. TEMPLATE RESOLUTION: Node config values support {{…}} templates resolved at runtime: {{trigger.text}} — the triggering message text {{trigger.contactPhone}} — the sender's phone {{trigger.senderName}} — the sender's name {{vars.myVar}} — a variable set by logic.set_variable {{nodes.n_abc.output.text}} — output from a previous node {{= amount * 1.1 }} — inline expression (arithmetic, comparisons, ternary) ERROR HANDLING: Any node's config can include __errorHandling: { continueOnFail: true, retryCount: 3, retryDelayMs: 1000 } to retry on failure with exponential backoff and/or continue on the 'error' handle instead of failing the run. WIRING RULES: - logic.branch: 'true' and 'false' handles - logic.switch / logic.ai_router: one handle per case id, plus 'default' - logic.wait_for_reply: 'default' (replied) and 'timeout' - logic.wait_for_approval: 'approved', 'rejected', 'timeout' - logic.wait_first_of: 'reply', 'event', 'timeout' - logic.loop: 'loop' (body) and 'done' - action.lookup_contact: 'found' and 'not_found' - action.call_flow: 'default' (returned), 'timeout', 'error' - All other nodes: 'default' handle (or 'error' when continueOnFail is on)…
How Neuron compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 63/100
- higher than 18% of 48,255 servers
- Tools
- 383
- the typical server has 7
- Tools that change things
- 38%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote server answers 100%
- Response time
- 171 ms
- faster than 69% of 30,031 servers
- Downloads a week
- 46
- more than 38% of 12,191 servers with a package
What its tools let an agent do: 237 read · 146 change
Install Neuron in Claude Code, Cursor or VS Code
claude mcp add --transport http neuron https://mcp.neuron.ng/mcp
Neuron: common questions
- Is Neuron MCP server safe?
- With care: it is graded C, so read the findings first (63/100). Read the Neuron safety report
- How do I install Neuron?
- It runs remotely at mcp.neuron.ng. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Neuron need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Neuron maintained?
- The latest release is v1.0.2.
- Is Neuron up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- How does Neuron compare with other MCP servers?
- safety score 63/100 (higher than 18% of 48,255 servers); tools 383 (the typical server has 7); tools that change things 38% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.