neuron.ng

Register a new user account with name, email, password, and organization name.

Authenticate with Neuron.

Refresh the access token using a refresh token.

Switch to a different organization.

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

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

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

Switch the MCP server to target a different Neuron backend instance.

Clear the current auth token locally.

Create a new AI bot with specified name, model, and behavior instructions.

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

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

Update an existing bot's configuration.

Permanently delete a bot and all its associated data.

Pause a bot to temporarily stop it from processing new messages.

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

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

Attach a knowledge base to a bot to enhance its responses with domain-specific knowledge.

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

Remove a knowledge base from a bot.

Create a new API key for programmatic access to a specific bot.

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

Permanently revoke an API key to immediately invalidate it and prevent further programmatic access.

Send a message to a bot via the API and receive a streaming or complete AI-generated response.

Send an outbound message through the bot API to a specified phone number.

Retrieve a paginated list of conversations managed by the bot.

Retrieve message history for a specific conversation with cursor-based pagination.

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

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

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

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

Transfer control of a conversation from the bot to a human agent.

Release a conversation back to the bot, returning control from a human agent.

Send a message to an existing conversation.

Compose and send a new message to a phone number via a specific channel.

Send a WhatsApp message to a phone number or group.

Edit the content of a previously sent message in a conversation.

Permanently delete a specific message from a conversation.

Close an active conversation, marking it as completed.

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

Retrieve all knowledge bases accessible to the current user.

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

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

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

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

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

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

Permanently delete a specific entry from a knowledge base.

Upload a text document to a knowledge base.

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

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

Ingest content into a knowledge base.

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

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

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

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

Permanently remove a custom API tool integration from a bot.

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

Store or update a secret credential (API key, token, etc.) for a custom tool integration.

Permanently delete a stored secret from a custom tool integration.

List all scheduled tasks for a bot.

Create a scheduled autonomous task for a bot.

Update a scheduled task's instruction, schedule, timezone, enabled state, or config.

Delete a scheduled task.

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

Trigger a task to run immediately (in addition to its normal schedule).

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

Turn a plain-English description into a structured task spec (title, instruction, scheduleKind, schedule, timezone, config) WITHOUT creating it.

List configured lead sources for the org.

Create a lead source.

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

Run a one-off extraction WITHOUT creating a persistent source, saving the results to the lead pool.

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

Counts of leads by status.

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

List voice personas for the org.

Get one voice persona (full voiceProfile + exemplars).

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.

Distill a reusable voice from raw text — no Collection or browser extension needed.

Distill a reusable voice from an existing WhatsApp conversation's stored messages — no extension needed.

Generate content written in the persona's voice for a topic/brief.

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.

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

Delete a voice persona.

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

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

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

Permanently remove an inbound webhook from a bot.

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

Retrieve pending reflections that the bot has generated from conversations, awaiting human review.

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

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

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

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

Create a new WhatsApp channel with either Meta Cloud API or Baileys (direct WhatsApp) integration.

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

Update configuration of an existing WhatsApp channel.

Permanently delete a WhatsApp channel and disconnect any active sessions.

Assign a bot to handle incoming messages on a specific WhatsApp channel.

Remove the bot assignment from a WhatsApp channel.

Start a Baileys (direct WhatsApp) session for the channel.

Stop the active Baileys session for the channel and disconnect from WhatsApp.

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

Request a numeric pairing code for a Baileys channel as an alternative to QR code scanning.

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

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

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

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

Retrieve the current QR code for pairing a Baileys channel with WhatsApp.

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

Connect an additional WhatsApp channel to a bot as a secondary number.

Disconnect a WhatsApp channel from a bot.

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

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

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

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

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

Update a pool item you have published — metadata (name, description, category, tags) and content fields (setupInstructions, defaultSecrets for tool_template items).

Permanently remove a published item from the marketplace pool.

Install a resource from the marketplace pool into the current organization.

Pull the latest updates for a subscribed pool resource to sync with the publisher's changes.

Toggle the featured status of a pool item.

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

Update organization settings such as name, description, or configuration preferences.

Update WhatsApp Business API credentials for the organization.

Set or clear the default WhatsApp channel for the organization.

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

Send an invitation to a new member to join the organization.

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

Revoke a pending organization invitation so it can no longer be accepted.

Update a member's permissions within the organization, such as conversation access.

Permanently remove a member from the organization.

Retrieve audit logs for the organization, showing a chronological record of actions performed by members.

Retrieve all available built-in tools with their enabled/disabled status for a specific bot.

Toggle a built-in tool on or off for a specific bot.

Enable or disable multiple built-in tools at once for a bot.

Register a new outbound webhook that sends HTTP POST requests to an external URL when specified bot events occur.

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

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

Permanently remove an outbound webhook.

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

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

Search contacts by a query string across name, phone number, and email fields.

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

Create a new contact in the organization's address book.

Update an existing contact's details.

Permanently delete a contact and remove them from all contact lists.

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

Bulk import multiple contacts into the organization's address book.

Enrich existing contacts with additional data from connected messaging channels.

Synchronize contacts from all connected WhatsApp channels into the organization's contact database.

Search contacts using natural language AI-powered semantic search.

Transcribe an audio recording and extract contact information (name, phone, email, notes, tags).

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

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

Create a new contact list.

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

Permanently delete a contact list.

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

Add one or more contacts to a list by contact ID or phone number.

Remove one or more contacts from a list by their contact IDs.

Merge two or more contact lists into a single unified list, deduplicating entries.

Retrieve all contact lists that a specific contact belongs to.

Trigger a refresh of a dynamic contact list.

Create a paced campaign that messages the next N un-reached members of a contact list on a schedule.

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

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

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

Pause a paced list campaign.

Resume a paused paced list campaign.

Fire the next batch of a paced list campaign immediately (on the next worker tick, ~30s), regardless of its schedule.

Permanently delete a paced list campaign and its reached-set.

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

Create a new broadcast message in draft status.

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.

Update an existing broadcast's name, message content, or media before sending.

Permanently delete a broadcast and its recipient data.

Send a broadcast message to all its recipients.

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

Initiate a checkout session for a subscription plan upgrade.

Cancel the current active subscription.

Upload a media file (image, video, audio, or document) by providing its base64-encoded content.

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

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

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

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

Create a new outreach campaign with target audience, messaging template, and schedule configuration.

Update a campaign that is in 'draft' or 'rejected' status.

Permanently delete a campaign that is in 'draft' status.

Submit a draft campaign for admin review and approval.

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

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

Retrieve contacts eligible to receive a campaign message.

Send a campaign message to selected eligible contacts via WhatsApp.

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

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

Pause an active campaign to temporarily stop message delivery.

Resume a previously paused campaign to restart message delivery.

Permanently stop an active campaign and refund the remaining unspent budget to the organization's wallet.

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

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

Initialize a wallet funding transaction via Paystack.

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

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

Save a verified bank account as the organization's payout destination.

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

Request a payout to transfer funds from the organization wallet to the linked bank account.

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

Create a new blog post.

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

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

Update an existing blog post's content, metadata, status, or SEO fields.

Permanently delete a blog post by its ID.

Publish a blog post, making it publicly visible.

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

Create a new WhatsApp Channel newsletter for one-way broadcast updates.

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

Update the name or description of an existing WhatsApp Channel newsletter.

Permanently delete a WhatsApp Channel newsletter and remove it from WhatsApp.

Post a message to a WhatsApp Channel newsletter.

Post a WhatsApp Status / Story from a connected direct (Baileys) WhatsApp number.

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

Synchronize and import WhatsApp Channels from a connected WhatsApp session into Neuron.

Browse verified contact lists available in the shared marketplace pool.

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

Create an ad distribution request to send a message to contacts in pool lists matching target demographics.

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

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

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

Update a draft or rejected ad request.

Permanently delete a draft ad request.

Submit a draft ad request for admin review.

Fund an approved ad request from the organization wallet.

Pause an active ad request campaign.

Resume a paused ad request campaign.

Stop an active or paused ad request campaign permanently.

Create a draft SMS campaign.

List the organization's SMS campaigns, optionally filtered by status or type.

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

Price a draft SMS campaign before sending: returns recipient count, SMS provider cost, curated owner payout (₦2/contact), and the total in kobo.

Send a draft SMS campaign.

Pause a sending drip SMS campaign.

Resume a paused drip SMS campaign.

Delete a draft SMS campaign.

Send or remove an emoji reaction on a WhatsApp message.

Send a sticker via WhatsApp.

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

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

Forward a WhatsApp message from one chat to another.

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

Set typing indicator or online/offline presence on a WhatsApp chat.

Get the invite link for a WhatsApp group.

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 whole address book.

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

Remove members from a group, resolved from any combination of sources — e.g.

Update the name/subject of a WhatsApp group.

Update the description of a WhatsApp group.

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

Add, remove, promote, or demote members in a WhatsApp group.

Enable or disable join approval mode for a WhatsApp group.

Approve or reject pending join requests for a WhatsApp group.

Revoke the current group invite link and generate a new one.

Make the bot leave a WhatsApp group.

Send a poll message via WhatsApp.

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

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

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

Update the bot's WhatsApp status/bio text.

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

Update a specific WhatsApp privacy setting.

Block a WhatsApp contact.

Unblock a previously blocked WhatsApp contact.

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

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

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

Create a new social media channel with platform credentials.

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

Update an existing social media channel.

Permanently delete a social media channel and disconnect any active sessions.

Start or reconnect a social media session for the channel.

Stop the active session for a social media channel.

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

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

Assign a bot to handle interactions on a specific social media channel.

Remove the bot assignment from a social media channel.

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

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

Update the message content, media, or send time of a scheduled message.

Cancel a scheduled message to prevent it from being sent.

Ask a human to approve or reject an action over WhatsApp and get the decision back.

Fetch a single approval request by id, including its decision once resolved.

List approval requests for the organization, newest first.

Approve or reject a pending approval programmatically — the decision surface for an authorized operator acting via MCP instead of replying on WhatsApp.

Cancel a still-pending approval (e.g.

Retrieve the COMPLETE catalog for authoring flows.

List all automation flows in the organization.

Create a new automation flow.

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

Update a flow's name, description, graph, or enabled state.

Soft-delete a flow.

Enable or disable a flow.

Manually trigger a flow run for testing.

List execution runs for a flow, newest first.

Get a single flow run with its full step-by-step execution trace.

Cancel a running or waiting flow execution.

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

Check whether this account can sell (Pro plan + admin-granted access) and any pending application.

Apply for seller access (digital products).

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

Create or update the seller storefront (nestuge-style page).

List all products for this seller, each with its public checkout URL and price breakdown.

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

Create a digital product/service with a public checkout link.

Update any field of a product (price, delivery, cover, enabled, fee payer, …).

List the members of a membership product: current (paid-up) or all.

Manually enroll existing / off-platform people into a membership product WITHOUT a payment.

Add more unique codes/keys to a 'pool' code product's stock.

Clone an existing product into a hidden draft copy (new checkout link, '(copy)' title, reset counters).

Permanently delete a product.

List recent product orders (sales) for this seller, with buyer, amount, fee breakdown, and status.

Refund a paid order via Paystack.

Re-send a paid-but-undelivered order to the buyer over WhatsApp/email.

List verified-purchase reviews across this seller's products (rating, text, buyer, status).

Total paid sales count and net revenue (kobo) for this seller.

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

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

Build a new video or edit an existing one from a natural-language instruction.

One-shot: build/edit a video from a prompt AND start the MP4 render.

Persist a ProjectDoc and get back an `openUrl`.

Submit a Studio ProjectDoc for a headless MP4 render.

Poll a render job by id.

Turn a script into a hosted voiceover audio URL, optionally with caption cues synced to the speech.

Transcribe a hosted media/audio URL into time-coded caption cues { cues:[{startSeconds,endSeconds,text}] }.

Text → image (AI b-roll) via the org's Replicate key.

Text → video via Replicate (async).

Poll an AI video job.

Run an AI transform on a hosted video via Replicate (async): op 'bg-remove' or 'face-swap' (face-swap needs imageUrl).

Poll a video-transform job.

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

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

Upload a local image/video (base64) to the Studio media store (uncapped) so the renderer can fetch it.

List browser-mission runs (live + recent).

Fetch one run's status, config snapshot and latest live stats (captured/flushed/leads/reels/hops/scrolls).

The kill switch — flags a run to stop.

Queue a browser mission for the user's Neuron extension to run — mine content into a Collection or prospects into the lead pool.

Queue a graceful stop for the current mission (the extension finalizes it).

Ask the extension to open its Web Agent panel so the user can review/adjust a mission before it runs.

See the launch/stop/open commands queued for the extension and their outcomes (pending|claimed|done|failed, plus the runId a launch created).

List content collections (where web-agent missions and captures land).

Fetch a collection's metadata by id.

Browse the mined content in a collection — posts/comments/profiles with author, content, engagement and engagementScore.

Retrieve all booking calendars for the current organization.

Retrieve details of a specific calendar by its ID.

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

Update a calendar's settings.

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

Retrieve all event types, optionally filtered by calendar.

Retrieve details of a specific event type.

Create a bookable event type on a calendar (e.g.

Update an event type's settings.

Permanently delete an event type and all its bookings.

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

Create a host-initiated event on a calendar.

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

Update a host-created event.

Delete a host-created event.

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

Retrieve details of a specific booking.

Confirm a pending booking.

Cancel a confirmed or pending booking.

Reschedule a booking to a new time.

Mark a confirmed booking as completed (e.g.

Mark a booking as no-show when the invitee did not attend.

Add or update host notes on a booking.

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

Set the weekly availability hours for a calendar.

List date-specific availability overrides for a calendar (e.g.

Set a date-specific availability override — mark a day as unavailable, or set custom hours for that date.

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

Find available slots across all team calendars.

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

Disconnect a calendar from Google Calendar sync.