io.github.conquext/neuron

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.

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

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

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

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.

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.

Permanently delete a broadcast and its recipient data. 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.

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

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

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

Retrieve all contact lists that a specific contact belongs to.

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.

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 messages from a specific conversation in chronological order, with optional cursor-based pagination.

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

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

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

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 organizations the authenticated user belongs to, including their roles in each.

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)

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

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.

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

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

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

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

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

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

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

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.

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

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

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.

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.

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

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

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

Neuron's tools come in groups; only some are loaded to save context. Call with action "list" to see every group, then "enable" the ones the task needs (e.g. ["flows"] to build an automation, ["sell"] for products). If a Neuron tool you expect is missing or reported disabled, enable its group here.

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

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

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

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

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