io.github.conquext/neuron

Tools

• neuron_add_bot_channel

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

  shallow
• neuron_add_to_contact_list

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

  shallow
• neuron_add_tool_secret

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

  shallow
• neuron_apply_persona_to_bot

  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 metadata with the persona id.

  shallow
• neuron_approve_reflection

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

  shallow
• neuron_assign_bot_to_channel

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

  shallow
• neuron_assign_bot_to_social_channel

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

  shallow
• neuron_attach_knowledge_base

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

  shallow
• neuron_audio_contact

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

  shallow
• neuron_block_contact

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

  shallow
• neuron_bot_api_chat

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

  shallow
• neuron_bot_api_get_bot

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

  shallow
• neuron_bot_api_get_messages

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

  shallow
• neuron_bot_api_list_conversations

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

  shallow
• neuron_bot_api_send

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

  shallow
• neuron_browse_list_pool

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

  shallow
• neuron_browse_pool

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

  shallow
• neuron_build_persona

  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, themes, dos/donts) + representative exemplars. Requires the collection to have >=3 usable samples. Runs an LLM call (a few seconds).

  shallow
• neuron_bulk_toggle_builtin_tools

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

  shallow
• neuron_campaign_marketplace

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

  shallow
• neuron_campaign_participants

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

  shallow
• neuron_cancel_approval

  Cancel a still-pending approval (e.g. the upstream action was aborted). Fires the approval.cancelled callback. Requires a bot API key.

  shallow
• neuron_cancel_flow_run

  Cancel a running or waiting flow execution. Steps already completed are not rolled back.

  shallow
• neuron_cancel_scheduled_message

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

  shallow
• neuron_cancel_subscription

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

  shallow
• neuron_checkout

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

  shallow
• neuron_close_conversation

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

  shallow
• neuron_compose_message

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

  shallow
• neuron_convert_lead

  Promote a phone-bearing lead into a contact (so it can be messaged / added to lists). Optionally add the new contact to a list.

  shallow
• neuron_create_ad_request

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

  shallow
• neuron_create_api_key

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

  shallow
• neuron_create_blog_post

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

  shallow
• neuron_create_bot

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

  shallow
• neuron_create_broadcast

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

  shallow
• neuron_create_campaign

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

  shallow
• neuron_create_channel

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

  shallow
• neuron_create_contact

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

  shallow
• neuron_create_contact_list

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

  shallow
• 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)

  shallow
• neuron_create_kb_entry

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

  shallow
• neuron_create_knowledge_base

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

  shallow
• neuron_create_lead_source

  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?|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}).

  shallow
• neuron_create_list_campaign

  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 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).

  shallow
• neuron_create_newsletter

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

  shallow
• neuron_create_outbound_webhook

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

  shallow
• neuron_create_social_channel

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

  shallow
• neuron_create_task

  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 contacts, schedule follow-ups, etc.). Sends are always screened against Do-Not-Contact, a per-run cap, and a no-repeat window.

  shallow
• neuron_create_tool

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

  shallow
• neuron_create_webhook

  Register a new inbound webhook endpoint that triggers bot actions when called by an external service.

  shallow
• neuron_delete_ad_request

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

  shallow
• neuron_delete_blog_post

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

  shallow
• neuron_delete_bot

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

  shallow
• neuron_delete_broadcast

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

  shallow
• neuron_delete_campaign

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

  shallow
• neuron_delete_channel

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

  shallow
• neuron_delete_contact

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

  shallow
• neuron_delete_contact_list

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

  shallow
• neuron_delete_flow

  Soft-delete a flow. It stops running but can be restored. Running executions are not cancelled.

  shallow
• neuron_delete_kb_entry

  Permanently delete a specific entry from a knowledge base.

  shallow
• neuron_delete_knowledge_base

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

  shallow
• neuron_delete_list_campaign

  Permanently delete a paced list campaign and its reached-set. Does not delete the contacts or the list.

  shallow
• neuron_delete_message

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

  shallow
• neuron_delete_newsletter

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

  shallow
• neuron_delete_outbound_webhook

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

  shallow
• neuron_delete_persona

  Delete a voice persona.

  shallow
• neuron_delete_social_channel

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

  shallow
• neuron_delete_task

  Delete a scheduled task. This is a soft delete — the task stops running immediately.

  shallow
• neuron_delete_tool

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

  shallow
• neuron_delete_webhook

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

  shallow
• neuron_detach_knowledge_base

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

  shallow
• neuron_draft_task

  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_create_task after any edits.

  shallow
• neuron_edit_message

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

  shallow
• neuron_export_contacts

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

  shallow
• neuron_extract_leads

  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_source (e.g. type='text_paste', config={text}).

  shallow
• neuron_find_contact_lists_for_contact

  Retrieve all contact lists that a specific contact belongs to.

  shallow
• neuron_forward_message

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

  shallow
• neuron_fund_ad_request

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

  shallow
• neuron_fund_campaign

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

  shallow
• neuron_fund_wallet

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

  shallow
• neuron_generate_from_persona

  Generate content written in the persona's voice for a topic/brief. Returns N variations. Stateless — nothing is persisted.

  shallow
• neuron_get_ad_request

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

  shallow
• neuron_get_ad_request_analytics

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

  shallow
• neuron_get_approval

  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.

  shallow
• neuron_get_bank_account

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

  shallow
• neuron_get_billing

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

  shallow
• neuron_get_blocklist

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

  shallow
• neuron_get_blog_post

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

  shallow
• neuron_get_bot

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

  shallow
• neuron_get_bot_analytics

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

  shallow
• neuron_get_broadcast

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

  shallow
• neuron_get_broadcast_recipients

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

  shallow
• neuron_get_business_profile

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

  shallow
• neuron_get_campaign

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

  shallow
• neuron_get_channel

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

  shallow
• neuron_get_channel_events

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

  shallow
• neuron_get_channel_qr

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

  shallow
• neuron_get_channel_status

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

  shallow
• neuron_get_contact

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

  shallow
• neuron_get_contact_list

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

  shallow
• neuron_get_contact_list_members

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

  shallow
• neuron_get_conversation

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

  shallow
• neuron_get_eligible_contacts

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

  shallow
• neuron_get_flow

  Retrieve a single flow by id, including its full graph (nodes and edges), enabled status, and run stats.

  shallow
• neuron_get_flow_catalog

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

  shallow
• neuron_get_flow_run

  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 this to debug flows — see exactly what happened at each step.

  shallow
• neuron_get_group_invite_link

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

  shallow
• neuron_get_group_participants

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

  shallow
• neuron_get_knowledge_base

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

  shallow
• neuron_get_list_campaign

  Get a paced list campaign with live progress: how many members have been reached this cycle, the current list size, and how many remain.

  shallow
• neuron_get_messages

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

  shallow
• neuron_get_newsletter

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

  shallow
• neuron_get_organization

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

  shallow
• neuron_get_outbound_webhook_logs

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

  shallow
• neuron_get_persona

  Get one voice persona (full voiceProfile + exemplars).

  shallow
• neuron_get_pool_item

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

  shallow
• neuron_get_privacy_settings

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

  shallow
• neuron_get_profile

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

  shallow
• neuron_get_scheduled_message

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

  shallow
• neuron_get_social_channel

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

  shallow
• neuron_get_social_channel_status

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

  shallow
• neuron_get_task_runs

  Retrieve the paginated execution history for a task — each run's status, AI summary, tool steps, and stats (messages sent, contacts processed).

  shallow
• neuron_get_webhook_logs

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

  shallow
• neuron_handle_join_requests

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

  shallow
• neuron_import_contacts

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

  shallow
• neuron_ingest_knowledge

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

  shallow
• neuron_install_from_pool

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

  shallow
• neuron_invite_member

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

  shallow
• neuron_join_campaign

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

  shallow
• neuron_lead_stats

  Counts of leads by status.

  shallow
• neuron_leave_group

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

  shallow
• neuron_list_ad_requests

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

  shallow
• neuron_list_api_keys

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

  shallow
• neuron_list_approvals

  List approval requests for the organization, newest first. Filter by status (pending/approved/rejected/expired/cancelled). Requires a bot API key.

  shallow
• neuron_list_audit_logs

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

  shallow
• neuron_list_blog_posts

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

  shallow
• neuron_list_bot_channels

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

  shallow
• neuron_list_bot_knowledge_bases

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

  shallow
• neuron_list_bots

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

  shallow
• neuron_list_broadcasts

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

  shallow
• neuron_list_builtin_tools

  Retrieve all available built-in tools with their enabled/disabled status for a specific bot. Built-in tools include WhatsApp actions (send messages, delete messages, post status), utility functions (web search, QR codes, weather), scheduling, knowledge base search, and more.

  shallow
• neuron_list_campaigns

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

  shallow
• neuron_list_channel_groups

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

  shallow
• neuron_list_channels

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

  shallow
• neuron_list_contact_lists

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

  shallow
• neuron_list_contacts

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

  shallow
• neuron_list_conversations

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

  shallow
• neuron_list_flow_runs

  List execution runs for a flow, newest first. Each run shows status (running/waiting/completed/failed/cancelled), trigger type, step count, and timing.

  shallow
• neuron_list_flows

  List all automation flows in the organization. Returns each flow's id, name, description, enabled status, trigger events, run count, and last run time.

  shallow
• neuron_list_installed

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

  shallow
• neuron_list_invitations

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

  shallow
• neuron_list_kb_bots

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

  shallow
• neuron_list_kb_entries

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

  shallow
• neuron_list_knowledge_bases

  Retrieve all knowledge bases accessible to the current user.

  shallow
• neuron_list_lead_sources

  List configured lead sources for the org.

  shallow
• neuron_list_leads

  List leads from the pool, filterable by status (new/enriched/contacted/converted/rejected), sourceId, and search.

  shallow
• neuron_list_list_campaigns

  List all paced list campaigns for the organization, optionally filtered to a single contact list.

  shallow
• neuron_list_members

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

  shallow
• neuron_list_newsletters

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

  shallow
• neuron_list_organizations

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

  shallow
• neuron_list_outbound_webhooks

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

  shallow
• neuron_list_payouts

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

  shallow
• neuron_list_personas

  List voice personas for the org. Each persona holds a voiceProfile (tone/style/themes/dos/donts) + exemplars distilled from a Collection of mined content.

  shallow
• neuron_list_published

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

  shallow
• neuron_list_reflections

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

  shallow
• neuron_list_scheduled_messages

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

  shallow
• neuron_list_social_channels

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

  shallow
• neuron_list_tasks

  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').

  shallow
• neuron_list_tools

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

  shallow
• neuron_list_webhooks

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

  shallow
• neuron_list_whatsapp_contacts

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

  shallow
• neuron_login

  Authenticate with Neuron. Three modes: 1. No args: Opens a browser URL for secure authorization (recommended — no credentials shared with AI) 2. token: Paste an MCP token from the Neuron dashboard 3. email+password: Legacy login (credentials visible to AI)

  shallow
• 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.

  shallow
• neuron_mark_as_read

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

  shallow
• neuron_merge_contact_lists

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

  shallow
• neuron_my_participations

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

  shallow
• neuron_pause_ad_request

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

  shallow
• neuron_pause_bot

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

  shallow
• neuron_pause_campaign

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

  shallow
• neuron_pause_list_campaign

  Pause a paced list campaign. No further batches run until resumed. The cursor is preserved.

  shallow
• neuron_populate_contacts

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

  shallow
• neuron_post_to_newsletter

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

  shallow
• neuron_post_to_status

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

  shallow
• neuron_publish_blog_post

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

  shallow
• neuron_publish_to_pool

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

  shallow
• neuron_pull_pool_update

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

  shallow
• neuron_refresh_contact_list

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

  shallow
• neuron_refresh_newsletter

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

  shallow
• neuron_refresh_token

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

  shallow
• neuron_register

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

  shallow
• neuron_reject_reflection

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

  shallow
• neuron_release_conversation

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

  shallow
• neuron_remove_bot_channel

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

  shallow
• neuron_remove_from_contact_list

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

  shallow
• neuron_remove_member

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

  shallow
• neuron_remove_profile_picture

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

  shallow
• neuron_remove_tool_secret

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

  shallow
• neuron_request_approval

  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 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).

  shallow
• neuron_request_pair_code

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

  shallow
• neuron_request_payout

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

  shallow
• neuron_respond_approval

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

  shallow
• neuron_resume_ad_request

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

  shallow
• neuron_resume_bot

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

  shallow
• neuron_resume_campaign

  Resume a previously paused campaign to restart message delivery.

  shallow
• neuron_resume_list_campaign

  Resume a paused paced list campaign. It picks up from where the cursor left off.

  shallow
• neuron_revoke_api_key

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

  shallow
• neuron_revoke_group_invite

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

  shallow
• neuron_revoke_invitation

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

  shallow
• neuron_rewrite_text

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

  shallow
• neuron_run_flow

  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 {{trigger.*}} in the flow.

  shallow
• neuron_run_lead_source

  Run a lead source now to pull new leads into the pool (queues the extraction).

  shallow
• neuron_run_list_campaign_now

  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.

  shallow
• neuron_run_task

  Trigger a task to run immediately (in addition to its normal schedule). Returns once the run is queued.

  shallow
• neuron_save_bank_account

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

  shallow
• neuron_search_contacts

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

  shallow
• neuron_search_knowledge

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

  shallow
• neuron_semantic_search_contacts

  Search contacts using natural language AI-powered semantic search. Finds contacts based on the meaning of their notes — skills, services, schedules, preferences, etc. Returns ranked results with relevance scores and AI-generated match reasons.

  shallow
• neuron_send_broadcast

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

  shallow
• neuron_send_campaign_message

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

  shallow
• neuron_send_contact_card

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

  shallow
• neuron_send_location

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

  shallow
• neuron_send_message

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

  shallow
• neuron_send_poll

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

  shallow
• neuron_send_reaction

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

  shallow
• neuron_send_sticker

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

  shallow
• neuron_send_whatsapp

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

  shallow
• neuron_set_default_channel

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

  shallow
• neuron_set_group_join_approval

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

  shallow
• neuron_set_presence

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

  shallow
• neuron_start_channel_session

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

  shallow
• neuron_start_social_channel_session

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

  shallow
• neuron_stop_ad_request

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

  shallow
• neuron_stop_campaign

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

  shallow
• neuron_stop_channel_session

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

  shallow
• neuron_stop_social_channel_session

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

  shallow
• neuron_submit_ad_request

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

  shallow
• neuron_submit_campaign

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

  shallow
• neuron_submit_to_list_pool

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

  shallow
• neuron_switch_instance

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

  shallow
• neuron_switch_org

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

  shallow
• neuron_sync_knowledge

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

  shallow
• neuron_sync_newsletters

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

  shallow
• neuron_sync_reflections

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

  shallow
• neuron_sync_whatsapp_contacts

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

  shallow
• neuron_takeover_conversation

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

  shallow
• neuron_test_tool

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

  shallow
• neuron_toggle_builtin_tool

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

  shallow
• neuron_toggle_featured

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

  shallow
• neuron_toggle_flow

  Enable or disable a flow. Disabled flows stop receiving events but retain their graph.

  shallow
• neuron_toggle_task

  Pause or resume a scheduled task (flips its enabled state and reschedules the next run).

  shallow
• neuron_unassign_bot_from_channel

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

  shallow
• neuron_unassign_bot_from_social_channel

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

  shallow
• neuron_unblock_contact

  Unblock a previously blocked WhatsApp contact.

  shallow
• neuron_unpublish_from_pool

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

  shallow
• neuron_update_ad_request

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

  shallow
• neuron_update_blog_post

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

  shallow
• neuron_update_bot

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

  shallow
• neuron_update_broadcast

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

  shallow
• neuron_update_campaign

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

  shallow
• neuron_update_channel

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

  shallow
• neuron_update_contact

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

  shallow
• neuron_update_contact_list

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

  shallow
• neuron_update_flow

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

  shallow
• neuron_update_group_description

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

  shallow
• neuron_update_group_members

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

  shallow
• neuron_update_group_settings

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

  shallow
• neuron_update_group_subject

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

  shallow
• neuron_update_kb_entry

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

  shallow
• neuron_update_knowledge_base

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

  shallow
• neuron_update_list_campaign

  Update a paced list campaign's name, message source, batch size, schedule, exhaust behavior, or send settings. Changing the schedule reschedules the next run.

  shallow
• neuron_update_member

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

  shallow
• neuron_update_newsletter

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

  shallow
• neuron_update_organization

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

  shallow
• neuron_update_outbound_webhook

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

  shallow
• neuron_update_persona

  Update a persona's name/description, or hand-tune its voiceProfile / exemplars.

  shallow
• neuron_update_pool_item

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

  shallow
• neuron_update_privacy_setting

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

  shallow
• neuron_update_profile_name

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

  shallow
• neuron_update_profile_picture

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

  shallow
• neuron_update_profile_status

  Update the bot's WhatsApp status/bio text.

  shallow
• neuron_update_scheduled_message

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

  shallow
• neuron_update_social_channel

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

  shallow
• neuron_update_task

  Update a scheduled task's instruction, schedule, timezone, enabled state, or config. Only provided fields change.

  shallow
• neuron_update_tool

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

  shallow
• neuron_update_webhook

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

  shallow
• neuron_update_whatsapp_credentials

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

  shallow
• neuron_upload_document

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

  shallow
• neuron_upload_media

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

  shallow
• neuron_validate_social_channel

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

  shallow
• neuron_verify_bank_account

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

  shallow
• neuron_verify_wallet_funding

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

  shallow
• neuron_wallet_balance

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

  shallow
• neuron_wallet_transactions

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

  shallow
• neuron_whoami

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

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/3bdadf99-78ab-487f-b67d-8f960df119c7/badge.svg)](https://vouch.tools/servers/3bdadf99-78ab-487f-b67d-8f960df119c7)