MCP serverio.github.conquext/neuron

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

Add members to an existing group, resolved from any combination of sources (other groups, contact lists, contacts, pasted phones, all contacts). Address the group by its id, slug,

Add more unique codes/keys to a 'pool' code product's stock. Each buyer receives one. Returns the product with the new remaining count.

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.

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

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

Apply for seller access (digital products). Requires a Pro plan or higher; a platform admin then grants access.

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

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

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.

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.

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

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

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.

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

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

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

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

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

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

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

Distill a reusable voice from an existing WhatsApp conversation's stored messages — no extension needed. `author` picks whose voice: 'me' (owner's own outgoing texts), 'contact' (t

Distill a reusable voice from raw text — no Collection or browser extension needed. Feed it pasted posts, a chat/dialogue transcript, WhatsApp-export text, or your own well-crafted

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

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

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

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

Cancel a confirmed or pending booking. Sends cancellation notifications to the invitee.

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

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

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

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

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

Mark a confirmed booking as completed (e.g. after the meeting has happened).

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

Confirm a pending booking. Only works on bookings with status 'pending'.

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

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

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

Create a new blog post. Body can be authored two ways: (1) `content` as markdown (GFM) + inline raw HTML, or (2) `blocks` — a structured array of typed layout blocks rendered as st

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

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

Create a new booking calendar with a name, timezone, and visibility setting.

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

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

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.

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.

Create a host-initiated event on a calendar. Supports attendees (with WhatsApp/email invitations), location, and daily/weekly/monthly recurrence.

Create a bookable event type on a calendar (e.g. '30-min consultation').

Create a new automation flow. A flow is a directed graph of nodes connected by edges. The graph MUST start with at least one trigger node (entry point). Edges connect nodes via out

Create a new WhatsApp group and seed its members from any combination of sources: other groups (combine/copy), contact lists, individual contacts, pasted phone numbers, or the whol

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

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

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?

Create a paced campaign that messages the next N un-reached members of a contact list on a schedule. The cursor follows the LIVE list — as members are added or removed, only curren

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

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

Create a digital product/service with a public checkout link. Amount in kobo (minor units): ₦1 = 100. Minimum ₦500 = 50000. For 'file' delivery, upload the file first (neuron_uploa

Create 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), 'pl

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

Create a scheduled autonomous task for a bot. The instruction is a self-contained, natural-language directive the bot executes with its tools (find stale conversations, message con

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

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

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

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

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

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

Permanently delete a calendar and all its event types, bookings, and availability data.

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

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

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

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

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

Permanently delete an event type and all its bookings.

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

Permanently delete a completed, failed, or cancelled flow run and all its step data.

Permanently delete a specific entry from a knowledge base.

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

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

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

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

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

Remove a date-specific availability override, reverting to the default weekly hours.

Delete a voice persona.

Permanently delete a product. Existing orders are retained.

Delete a draft SMS campaign. Only draft campaigns can be deleted.

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

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

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

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

Re-send a paid-but-undelivered order to the buyer over WhatsApp/email. Use when a sale settled while no WhatsApp session was connected; connect one first, then deliver.

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

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

Clone an existing product into a hidden draft copy (new checkout link, '(copy)' title, reset counters). A 'pool' code product is cloned with an empty pool — restock codes before en

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

Manually 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

Price 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_ca

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

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_

Retrieve all contact lists that a specific contact belongs to.

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

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

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

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

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

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

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

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.

Retrieve the default availability schedule (weekly hours + timezone) for a calendar.

Compute available time slots for an event type over a date range, accounting for availability, existing bookings, buffers, and Google Calendar busy times.

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

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

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

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

Retrieve details of a specific booking.

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

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

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

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

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

Retrieve details of a specific calendar by its ID.

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

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

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

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

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

Fetch a collection's metadata by id.

Browse 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

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

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

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

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

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

Retrieve details of a specific event type.

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

Retrieve the COMPLETE catalog for authoring flows. ALWAYS call this first when building or editing a flow — do not rely on memory, the full node set changes. The response has two p

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

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

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

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

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

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

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

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

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

Get one voice persona (full voiceProfile + exemplars).

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

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

Get a single product by id, with its public URL and fee breakdown.

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

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

Retrieve a single SMS campaign with its status and delivery counters.

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

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

Get this seller's storefront profile (handle, display name, bio, branding) and its public URL.

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

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

Disconnect a calendar from Google Calendar sync.

Check whether a calendar is connected to Google Calendar and when it last synced.

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

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

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

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.

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

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

Counts of leads by status.

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

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

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

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

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

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

List bookings (inbound and host-created) with optional filters for calendar, status, date range, and source.

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

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

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

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

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

Retrieve all booking calendars for the current organization.

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

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

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

List content collections (where web-agent missions and captures land). Returns each collection's item count, kind and source.

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

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

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

Retrieve all event types, optionally filtered by calendar.

List host-created events, optionally filtered by calendar and date range.

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

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

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

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

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

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

Retrieve all knowledge bases accessible to the current user.

List configured lead sources for the org.

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

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

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

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