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

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)

Refresh the access token using a refresh token. Automatically sets the new access token.

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

List all organizations the authenticated user belongs to

Get the authenticated user's profile information

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

Clear the current auth token locally. Does NOT revoke server-side MCP tokens — revoke from the Neuron dashboard (Settings > MCP Tokens) for full invalidation.

Create a new bot with specified configuration including name, system prompt, and optional parameters like model, temperature, and phone number.

Retrieve a list of all bots in the system with their configurations and status.

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

Update an existing bot's configuration including name, system prompt, model parameters, and phone number association.

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

Pause a bot's operations temporarily. The bot will stop responding to messages until resumed.

Resume a paused bot's operations. The bot will start responding to 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 specific domain knowledge. Optional priority determines retrieval order.

Retrieve all knowledge bases attached to a specific bot along with their priorities and metadata.

Remove a knowledge base from a bot. The bot will no longer use this knowledge base for responses.

Generate a new API key for a bot to enable programmatic access. The key will have an 'nrn_' prefix and can optionally expire at a specified date.

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

Revoke an API key to immediately invalidate it and prevent further use. This action cannot be undone.

Send a chat message to the bot API as a contact and receive an AI-generated response. Requires a valid API key with 'nrn_' prefix.

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

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

Retrieve message history for a specific conversation with pagination support. Requires a valid API key.

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

Retrieve a list of conversations for a specific bot with optional filtering by status and pagination

Retrieve detailed information about a specific conversation by its ID

Retrieve messages from a specific conversation with optional pagination

Take over a conversation, transferring control from the bot to a human agent

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

Send a message to a specific conversation

Compose and send a new message to a phone number, starting a new conversation if one does not exist

Send a WhatsApp message to a phone number or group. Auto-resolves which WhatsApp channel to use (org default channel > first connected channel). Optionally attach media.

Edit the content of a previously sent message in a conversation

Delete a specific message from a conversation. This action cannot be undone.

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. The document will be automatically chunked and indexed for semantic search.

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. Supports deduplication via externalId and optional LLM processing (summarize, extract_facts, or custom instruction).

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

Create a new tool integration for a bot to call external HTTP APIs and webhooks

List all tool integrations for a specific bot

Update an existing tool integration configuration

Delete a tool integration from a bot

Test a tool integration with sample arguments to verify it works correctly

Add or update a secret (API key, token, etc.) for a tool integration

Remove a secret from a tool integration

Create a new inbound webhook that triggers bot actions when called

List all inbound webhooks configured for a specific bot

Update an existing webhook configuration

Delete an inbound webhook from a bot

Retrieve execution logs for a webhook to monitor activity and debug issues

List self-learning reflections generated by a bot, optionally filtered by status

Approve a bot reflection to incorporate it into the bot's learning and behavior

Reject a bot reflection to prevent it from being incorporated into the bot's behavior

Synchronize and update the bot's knowledge base with all approved reflections

List all WhatsApp channels configured in the Neuron system

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

Get detailed information about a specific WhatsApp channel

Update configuration details of an existing WhatsApp channel

Delete a WhatsApp channel from the system. This action cannot be undone.

Assign a bot to handle messages on a specific WhatsApp channel

Remove the bot assignment from a WhatsApp channel

Start a Baileys (direct WhatsApp) session for the channel. Generates QR code for pairing.

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

Get the current session status of a WhatsApp channel (connected, disconnected, etc.)

Request a pairing code for a Baileys channel instead of using QR code. Useful for linking with a phone number.

List all WhatsApp groups that the channel is participating in

Get the list of participants in a specific WhatsApp group on a channel

List contacts from the WhatsApp account connected to this channel

Get the event log for a channel (connection events, message events, errors, etc.)

Get the QR code for pairing a Baileys channel with WhatsApp. Scan with WhatsApp mobile app.

List all WhatsApp channels connected to a 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 marketplace/pool to discover shared bots, tools, knowledge bases, and reflections. Supports filtering and search.

Get detailed information about a specific item in the marketplace/pool

List all items you have published to the marketplace/pool

List all items you have installed from the marketplace/pool

Publish a bot, tool, knowledge base, or reflection to the marketplace/pool for others to discover and use

Update the metadata of a pool item you have published (title, description, category, tags)

Remove a published item from the marketplace/pool. This action cannot be undone.

Install a resource from the marketplace/pool. Choose 'fork' to create an independent copy or 'subscribe' to receive updates.

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

Toggle the featured status of a pool item. Featured items appear prominently in the marketplace. (Admin operation)

Get details of a specific organization by ID

Update organization details such as name

Update WhatsApp Business API credentials for the organization