io.github.conquext/neuron is an MCP server published by io.github.conquext, hosted at mcp.neuron.ng. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 52 tools, including neuron_register, neuron_login, neuron_refresh_token, neuron_switch_org, neuron_list_organizations.
AI-powered WhatsApp chatbot platform with 196 tools for bots, campaigns, and contacts.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Register a new user account with name, email, password, and organization name. Creates both the user and an initial organization.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Full name of the user |
| email * | string | Email address for the new account |
| orgName * | string | Name of the organization to create for this user |
| password * | string | Password for the account (minimum 8 characters) |
{
"name": "neuron_register",
"title": "Register New User",
"description": "Register a new user account with name, email, password, and organization name. Creates both the user and an initial organization.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"email",
"password",
"orgName"
],
"properties": {
"name": {
"type": "string",
"description": "Full name of the user"
},
"email": {
"type": "string",
"format": "email",
"description": "Email address for the new account"
},
"orgName": {
"type": "string",
"description": "Name of the organization to create for this user"
},
"password": {
"type": "string",
"minLength": 8,
"description": "Password for the account (minimum 8 characters)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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)
No parameters.
{
"name": "neuron_login",
"title": "Login to Neuron",
"description": "Authenticate with Neuron. Three modes:\n1. No args: Opens a browser URL for secure authorization (recommended — no credentials shared with AI)\n2. token: Paste an MCP token from the Neuron dashboard\n3. email+password: Legacy login (credentials visible to AI)",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Refresh the access token. Uses the refresh token kept from the last login or org switch in this session; tokens are never shown. Sets the new access token for subsequent API calls.
| Parameter | Type | Description |
|---|---|---|
| refreshToken | string | Only if this session has none kept (e.g. after a restart) |
{
"name": "neuron_refresh_token",
"title": "Refresh Access Token",
"description": "Refresh the access token. Uses the refresh token kept from the last login or org switch in this session; tokens are never shown. Sets the new access token for subsequent API calls.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"refreshToken": {
"type": "string",
"description": "Only if this session has none kept (e.g. after a restart)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Switch to a different organization. Gets a new access token scoped to the target organization and sets it for later calls (the token is not shown).
| Parameter | Type | Description |
|---|---|---|
| orgId * | string | Unique identifier (UUID) of the organization to switch to |
{
"name": "neuron_switch_org",
"title": "Switch Organization",
"description": "Switch to a different organization. Gets a new access token scoped to the target organization and sets it for later calls (the token is not shown).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgId"
],
"properties": {
"orgId": {
"type": "string",
"description": "Unique identifier (UUID) of the organization to switch to"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Retrieve all organizations the authenticated user belongs to, including their roles in each.
No parameters.
{
"name": "neuron_list_organizations",
"title": "List Organizations",
"description": "Retrieve all organizations the authenticated user belongs to, including their roles in each.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Retrieve the authenticated user's profile information including name, email, role, and current organization.
No parameters.
{
"name": "neuron_get_profile",
"title": "Get User Profile",
"description": "Retrieve the authenticated user's profile information including name, email, role, and current organization.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Check which Neuron account is currently logged in, including user name, email, role, and organization.
No parameters.
{
"name": "neuron_whoami",
"title": "Check Current Account",
"description": "Check which Neuron account is currently logged in, including user name, email, role, and organization.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| url | string | Base API URL of the Neuron instance (e.g., 'https://api.client.com/api/v1'). Omit to list known instances. |
{
"name": "neuron_switch_instance",
"title": "Switch Neuron Instance",
"description": "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.\n\nCall with no args to list known instances and see which is active.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"url": {
"type": "string",
"description": "Base API URL of the Neuron instance (e.g., 'https://api.client.com/api/v1'). Omit to list known instances."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Clear the current auth token locally. Does NOT revoke server-side MCP tokens — revoke from the Neuron dashboard (Settings > MCP Tokens) for full invalidation.
No parameters.
{
"name": "neuron_logout",
"title": "Logout",
"description": "Clear the current auth token locally. Does NOT revoke server-side MCP tokens — revoke from the Neuron dashboard (Settings > MCP Tokens) for full invalidation.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Retrieve a paginated list of conversations for a specific bot, with optional filtering by status.
| Parameter | Type | Description |
|---|---|---|
| botId * | string | Unique identifier (UUID) of the bot whose conversations to list |
| limit | integer | Maximum number of conversations to return per page |
| cursor | string | Opaque pagination cursor from a previous response for retrieving the next page |
| status | string | Filter by conversation status (e.g., 'active', 'closed') |
{
"name": "neuron_list_conversations",
"title": "List Conversations",
"description": "Retrieve a paginated list of conversations for a specific bot, with optional filtering by status.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"botId"
],
"properties": {
"botId": {
"type": "string",
"description": "Unique identifier (UUID) of the bot whose conversations to list"
},
"limit": {
"type": "integer",
"description": "Maximum number of conversations to return per page",
"exclusiveMinimum": 0
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous response for retrieving the next page"
},
"status": {
"type": "string",
"description": "Filter by conversation status (e.g., 'active', 'closed')"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Retrieve detailed information about a specific conversation, including its status, participants, and metadata.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the conversation |
{
"name": "neuron_get_conversation",
"title": "Get Conversation",
"description": "Retrieve detailed information about a specific conversation, including its status, participants, and metadata.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the conversation"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Retrieve messages from a specific conversation in chronological order, with optional cursor-based pagination.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the conversation |
| limit | integer | Maximum number of messages to return per page |
| cursor | string | Opaque pagination cursor from a previous response for retrieving the next page |
{
"name": "neuron_get_messages",
"title": "Get Conversation Messages",
"description": "Retrieve messages from a specific conversation in chronological order, with optional cursor-based pagination.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the conversation"
},
"limit": {
"type": "integer",
"description": "Maximum number of messages to return per page",
"exclusiveMinimum": 0
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous response for retrieving the next page"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Transfer control of a conversation from the bot to a human agent. The bot will stop auto-responding until the conversation is released.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the conversation to take over |
{
"name": "neuron_takeover_conversation",
"title": "Takeover Conversation",
"description": "Transfer control of a conversation from the bot to a human agent. The bot will stop auto-responding until the conversation is released.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the conversation to take over"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Release a conversation back to the bot, returning control from a human agent. The bot will resume auto-responding.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the conversation to release |
{
"name": "neuron_release_conversation",
"title": "Release Conversation",
"description": "Release a conversation back to the bot, returning control from a human agent. The bot will resume auto-responding.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the conversation to release"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Send a message to an existing conversation. Supports text, image, and document message types with optional media attachments.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the conversation |
| content * | string | Message content to send |
| mediaUrl | string | URL of media to attach (required for image/document message types) |
| messageType | string | Type of message: 'text' (default), 'image', or 'document' |
{
"name": "neuron_send_message",
"title": "Send Message",
"description": "Send a message to an existing conversation. Supports text, image, and document message types with optional media attachments.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"content"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the conversation"
},
"content": {
"type": "string",
"description": "Message content to send"
},
"mediaUrl": {
"type": "string",
"description": "URL of media to attach (required for image/document message types)"
},
"messageType": {
"type": "string",
"description": "Type of message: 'text' (default), 'image', or 'document'"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Compose and send a new message to a phone number via a specific channel. Automatically creates a new conversation if one does not exist.
| Parameter | Type | Description |
|---|---|---|
| to * | string | Recipient phone number (E.164 format, e.g., '2348012345678') |
| text | string | Message text content (optional when sending a template) |
| sendAt | string | ISO 8601 date-time for scheduled delivery (e.g., '2025-12-31T10:00:00Z'). Message sends immediately if omitted. |
| mediaUrl | string | URL of media to attach (required for non-text message types) |
| template | object | Approved template (official WhatsApp Business API sessions only). Required to reach anyone who hasn't messaged you in the last 24 hours. Set messageType to 'template'. |
| channelId * | string | Unique identifier (UUID) of the WhatsApp channel to send through |
| contactName | string | Display name for the recipient contact |
| messageType | string | Type of message: 'text' (default), 'image', 'document', or 'template' (official API sessions) |
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.
| Parameter | Type | Description |
|---|---|---|
| to * | string | Recipient: phone number (e.g., '2348012345678') or group JID (e.g., '120363XXX@g.us') |
| text | string | Message text content (optional when sending a template) |
| sendAt | string | ISO 8601 date-time for scheduled delivery (e.g., '2025-12-31T10:00:00Z'). Message sends immediately if omitted. |
| mediaUrl | string | URL of media to attach (required for non-text message types) |
| template | object | Approved template (official WhatsApp Business API sessions only). Required to reach anyone who hasn't messaged you in the last 24 hours. Set messageType to 'template'. |
| channelId | string | Unique identifier (UUID) of a specific channel to override auto-resolution |
| contactName | string | Display name for the recipient contact |
| messageType | string | Message type: 'text' (default), 'image', 'audio', 'video', 'document', or 'template' (official API sessions) |
Edit the content of a previously sent message in a conversation. Only the message sender can edit their messages.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the conversation |
| msgId * | string | Unique identifier (UUID) of the message to edit |
| content * | string | New text content to replace the existing message |
{
"name": "neuron_edit_message",
"title": "Edit Message",
"description": "Edit the content of a previously sent message in a conversation. Only the message sender can edit their messages.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"msgId",
"content"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the conversation"
},
"msgId": {
"type": "string",
"description": "Unique identifier (UUID) of the message to edit"
},
"content": {
"type": "string",
"description": "New text content to replace the existing message"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Permanently delete a specific message from a conversation. This action cannot be undone.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the conversation |
| msgId * | string | Unique identifier (UUID) of the message to delete |
{
"name": "neuron_delete_message",
"title": "Delete Message",
"description": "Permanently delete a specific message from a conversation. This action cannot be undone.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"msgId"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the conversation"
},
"msgId": {
"type": "string",
"description": "Unique identifier (UUID) of the message to delete"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Close an active conversation, marking it as completed. The bot will stop responding and the conversation is archived.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the conversation to close |
{
"name": "neuron_close_conversation",
"title": "Close Conversation",
"description": "Close an active conversation, marking it as completed. The bot will stop responding and the conversation is archived.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the conversation to close"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Retrieve all contacts for the current organization with optional filtering by search term, tag, and pagination.
| Parameter | Type | Description |
|---|---|---|
| tag | string | Tag name to filter contacts by category |
| page | integer | Page number for pagination (default: 1) |
| limit | integer | Number of contacts per page (default: 20) |
| search | string | Search term to filter contacts by name, phone number, or email address |
| doNotBroadcast | boolean | Filter to contacts that are (true) or are not (false) excluded from broadcasts |
| doNotAutoRespond | boolean | Filter to contacts the bot will never (true) / may (false) auto-respond to |
{
"name": "neuron_list_contacts",
"title": "List Contacts",
"description": "Retrieve all contacts for the current organization with optional filtering by search term, tag, and pagination.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"tag": {
"type": "string",
"description": "Tag name to filter contacts by category"
},
"page": {
"type": "integer",
"description": "Page number for pagination (default: 1)",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"description": "Number of contacts per page (default: 20)",
"exclusiveMinimum": 0
},
"search": {
"type": "string",
"description": "Search term to filter contacts by name, phone number, or email address"
},
"doNotBroadcast": {
"type": "boolean",
"description": "Filter to contacts that are (true) or are not (false) excluded from broadcasts"
},
"doNotAutoRespond": {
"type": "boolean",
"description": "Filter to contacts the bot will never (true) / may (false) auto-respond to"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search contacts by a query string across name, phone number, and email fields. Returns matching contacts ranked by relevance.
| Parameter | Type | Description |
|---|---|---|
| q * | string | Search query string to match against contact name, phone, or email |
{
"name": "neuron_search_contacts",
"title": "Search Contacts",
"description": "Search contacts by a query string across name, phone number, and email fields. Returns matching contacts ranked by relevance.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Search query string to match against contact name, phone, or email"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Retrieve detailed information about a specific contact including their tags, notes, and associated lists.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the contact |
{
"name": "neuron_get_contact",
"title": "Get Contact",
"description": "Retrieve detailed information about a specific contact including their tags, notes, and associated lists.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the contact"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Full name of the contact |
| tags | array | Tags to categorize the contact (e.g., ['vendor', 'lagos']) |
| string | Email address of the contact | |
| notes | string | Additional notes about the contact, saved as a structured entry |
| phone * | string | Contact phone number in E.164 format (e.g., +2348012345678) |
| doNotBroadcast | boolean | If true, this contact is permanently excluded from all broadcasts |
| doNotAutoRespond | boolean | If true, the bot will never auto-respond to this contact (manual/API and human sends still work) |
{
"name": "neuron_create_contact",
"title": "Create Contact",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"phone"
],
"properties": {
"name": {
"type": "string",
"description": "Full name of the contact"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags to categorize the contact (e.g., ['vendor', 'lagos'])"
},
"email": {
"type": "string",
"description": "Email address of the contact"
},
"notes": {
"type": "string",
"description": "Additional notes about the contact, saved as a structured entry"
},
"phone": {
"type": "string",
"description": "Contact phone number in E.164 format (e.g., +2348012345678)"
},
"doNotBroadcast": {
"type": "boolean",
"description": "If true, this contact is permanently excluded from all broadcasts"
},
"doNotAutoRespond": {
"type": "boolean",
"description": "If true, the bot will never auto-respond to this contact (manual/API and human sends still work)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Update an existing contact's details. If notes are provided, they are appended as a new structured note entry without overwriting existing notes.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the contact to update |
| name | string | Updated full name for the contact |
| tags | array | Updated tags for the contact (replaces existing tags) |
| string | Updated email address for the contact | |
| notes | string | New note to append to the contact's existing notes |
| phone | string | Updated phone number in E.164 format (e.g., +2348012345678) |
| doNotBroadcast | boolean | Set true to exclude this contact from all broadcasts, false to allow |
| doNotAutoRespond | boolean | Set true so the bot never auto-responds to this contact, false to allow (manual/API and human sends are unaffected either way) |
{
"name": "neuron_update_contact",
"title": "Update Contact",
"description": "Update an existing contact's details. If notes are provided, they are appended as a new structured note entry without overwriting existing notes.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the contact to update"
},
"name": {
"type": "string",
"description": "Updated full name for the contact"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Updated tags for the contact (replaces existing tags)"
},
"email": {
"type": "string",
"description": "Updated email address for the contact"
},
"notes": {
"type": "string",
"description": "New note to append to the contact's existing notes"
},
"phone": {
"type": "string",
"description": "Updated phone number in E.164 format (e.g., +2348012345678)"
},
"doNotBroadcast": {
"type": "boolean",
"description": "Set true to exclude this contact from all broadcasts, false to allow"
},
"doNotAutoRespond": {
"type": "boolean",
"description": "Set true so the bot never auto-responds to this contact, false to allow (manual/API and human sends are unaffected either way)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Permanently delete a contact and remove them from all contact lists. This action cannot be undone.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the contact to delete |
{
"name": "neuron_delete_contact",
"title": "Delete Contact",
"description": "Permanently delete a contact and remove them from all contact lists. This action cannot be undone.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the contact to delete"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Export all contacts as a downloadable dataset for the current organization.
No parameters.
{
"name": "neuron_export_contacts",
"title": "Export Contacts",
"description": "Export all contacts as a downloadable dataset for the current organization.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Bulk import multiple contacts into the organization's address book. Accepts an array of contact objects with name, phone, and optional fields.
| Parameter | Type | Description |
|---|---|---|
| contacts * | array | Array of contact objects to import into the organization |
{
"name": "neuron_import_contacts",
"title": "Import Contacts",
"description": "Bulk import multiple contacts into the organization's address book. Accepts an array of contact objects with name, phone, and optional fields.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"contacts"
],
"properties": {
"contacts": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"phone"
],
"properties": {
"name": {
"type": "string",
"description": "Full name of the contact"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags to categorize the contact"
},
"email": {
"type": "string",
"description": "Email address of the contact"
},
"notes": {
"type": "string",
"description": "Additional notes about the contact"
},
"phone": {
"type": "string",
"description": "Contact phone number in E.164 format (e.g., +2348012345678)"
}
},
"additionalProperties": false
},
"description": "Array of contact objects to import into the organization"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Enrich existing contacts with additional data from connected messaging channels. Syncs profile information from linked platforms.
No parameters.
{
"name": "neuron_populate_contacts",
"title": "Populate Contacts",
"description": "Enrich existing contacts with additional data from connected messaging channels. Syncs profile information from linked platforms.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Synchronize contacts from all connected WhatsApp channels into the organization's contact database. Creates new contacts for unseen numbers.
No parameters.
{
"name": "neuron_sync_whatsapp_contacts",
"title": "Sync WhatsApp Contacts",
"description": "Synchronize contacts from all connected WhatsApp channels into the organization's contact database. Creates new contacts for unseen numbers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return (default: 10, max: 20) |
| query * | string | Natural language search query (e.g., 'who can deliver to Lagos on Monday?') |
{
"name": "neuron_semantic_search_contacts",
"title": "Semantic Search Contacts",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"description": "Maximum number of results to return (default: 10, max: 20)",
"exclusiveMinimum": 0
},
"query": {
"type": "string",
"description": "Natural language search query (e.g., 'who can deliver to Lagos on Monday?')"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Transcribe an audio recording and extract contact information (name, phone, email, notes, tags). Automatically saves the extracted contact to the organization's address book.
| Parameter | Type | Description |
|---|---|---|
| audioBase64 * | string | Base64-encoded audio data containing spoken contact information |
| audioFormat | string | Audio format hint for decoding (default: 'webm') |
{
"name": "neuron_audio_contact",
"title": "Extract Contact from Audio",
"description": "Transcribe an audio recording and extract contact information (name, phone, email, notes, tags). Automatically saves the extracted contact to the organization's address book.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"audioBase64"
],
"properties": {
"audioBase64": {
"type": "string",
"description": "Base64-encoded audio data containing spoken contact information"
},
"audioFormat": {
"type": "string",
"default": "webm",
"description": "Audio format hint for decoding (default: 'webm')"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Retrieve all contact lists for the current organization with optional filtering by search term, type, and pagination.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (default: 1) |
| type | string | Filter by list type: 'static', 'dynamic', or 'merged' |
| limit | integer | Number of items per page (default: 20) |
| search | string | Search term to filter lists by name or slug |
{
"name": "neuron_list_contact_lists",
"title": "List Contact Lists",
"description": "Retrieve all contact lists for the current organization with optional filtering by search term, type, and pagination.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "integer",
"description": "Page number for pagination (default: 1)",
"exclusiveMinimum": 0
},
"type": {
"type": "string",
"description": "Filter by list type: 'static', 'dynamic', or 'merged'"
},
"limit": {
"type": "integer",
"description": "Number of items per page (default: 20)",
"exclusiveMinimum": 0
},
"search": {
"type": "string",
"description": "Search term to filter lists by name or slug"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Retrieve detailed information about a specific contact list, including member count and configuration.
| Parameter | Type | Description |
|---|---|---|
| idOrSlug * | string | Unique identifier (UUID) or URL-friendly slug of the contact list |
{
"name": "neuron_get_contact_list",
"title": "Get Contact List",
"description": "Retrieve detailed information about a specific contact list, including member count and configuration.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idOrSlug"
],
"properties": {
"idOrSlug": {
"type": "string",
"description": "Unique identifier (UUID) or URL-friendly slug of the contact list"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Display name for the contact list |
| slug | string | URL-friendly identifier (auto-generated from name if omitted) |
| type | string | List type (default: 'static') |
| criteria | object | Dynamic list criteria object: { rules?: { operator, conditions }, aiPrompt?, aiMaxResults? } |
| description | string | Human-readable description of the list's purpose |
| refreshSchedule | string | Refresh schedule for dynamic lists (default: 'manual') |
{
"name": "neuron_create_contact_list",
"title": "Create Contact List",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Display name for the contact list"
},
"slug": {
"type": "string",
"description": "URL-friendly identifier (auto-generated from name if omitted)"
},
"type": {
"enum": [
"static",
"dynamic",
"merged"
],
"type": "string",
"description": "List type (default: 'static')"
},
"criteria": {
"type": "object",
"description": "Dynamic list criteria object: { rules?: { operator, conditions }, aiPrompt?, aiMaxResults? }",
"additionalProperties": {}
},
"description": {
"type": "string",
"description": "Human-readable description of the list's purpose"
},
"refreshSchedule": {
"enum": [
"manual",
"daily",
"weekly",
"on_access"
],
"type": "string",
"description": "Refresh schedule for dynamic lists (default: 'manual')"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Update an existing contact list's name, slug, description, criteria, or refresh schedule.
| Parameter | Type | Description |
|---|---|---|
| name | string | Updated display name for the list |
| slug | string | Updated URL-friendly slug for the list |
| criteria | any | Updated dynamic list criteria. Set to null to clear existing criteria. |
| idOrSlug * | string | Unique identifier (UUID) or URL-friendly slug of the contact list to update |
| description | string | Updated description of the list's purpose |
| refreshSchedule | string | Updated refresh schedule for dynamic lists |
{
"name": "neuron_update_contact_list",
"title": "Update Contact List",
"description": "Update an existing contact list's name, slug, description, criteria, or refresh schedule.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idOrSlug"
],
"properties": {
"name": {
"type": "string",
"description": "Updated display name for the list"
},
"slug": {
"type": "string",
"description": "Updated URL-friendly slug for the list"
},
"criteria": {
"anyOf": [
{
"anyOf": [
{
"not": {}
},
{
"type": "object",
"additionalProperties": {}
}
]
},
{
"type": "null"
}
],
"description": "Updated dynamic list criteria. Set to null to clear existing criteria."
},
"idOrSlug": {
"type": "string",
"description": "Unique identifier (UUID) or URL-friendly slug of the contact list to update"
},
"description": {
"type": "string",
"description": "Updated description of the list's purpose"
},
"refreshSchedule": {
"enum": [
"manual",
"daily",
"weekly",
"on_access"
],
"type": "string",
"description": "Updated refresh schedule for dynamic lists"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Permanently delete a contact list. System-protected lists (e.g., 'Do Not Contact') cannot be deleted.
| Parameter | Type | Description |
|---|---|---|
| idOrSlug * | string | Unique identifier (UUID) or URL-friendly slug of the contact list to delete |
{
"name": "neuron_delete_contact_list",
"title": "Delete Contact List",
"description": "Permanently delete a contact list. System-protected lists (e.g., 'Do Not Contact') cannot be deleted.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idOrSlug"
],
"properties": {
"idOrSlug": {
"type": "string",
"description": "Unique identifier (UUID) or URL-friendly slug of the contact list to delete"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Retrieve the members of a specific contact list with optional search filtering and pagination.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (default: 1) |
| limit | integer | Number of items per page (default: 20) |
| search | string | Search term to filter members by name or phone number |
| idOrSlug * | string | Unique identifier (UUID) or URL-friendly slug of the contact list |
{
"name": "neuron_get_contact_list_members",
"title": "Get Contact List Members",
"description": "Retrieve the members of a specific contact list with optional search filtering and pagination.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idOrSlug"
],
"properties": {
"page": {
"type": "integer",
"description": "Page number for pagination (default: 1)",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"description": "Number of items per page (default: 20)",
"exclusiveMinimum": 0
},
"search": {
"type": "string",
"description": "Search term to filter members by name or phone number"
},
"idOrSlug": {
"type": "string",
"description": "Unique identifier (UUID) or URL-friendly slug of the contact list"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| entries * | array | Array of contacts to add, each identified by contactId or phone number |
| idOrSlug * | string | Unique identifier (UUID) or URL-friendly slug of the target contact list |
{
"name": "neuron_add_to_contact_list",
"title": "Add to Contact List",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idOrSlug",
"entries"
],
"properties": {
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"phone": {
"type": "string",
"description": "Phone number in E.164 format (e.g., +2348012345678). Creates a new contact if no match exists."
},
"contactId": {
"type": "string",
"description": "Unique identifier (UUID) of an existing contact"
}
},
"additionalProperties": false
},
"description": "Array of contacts to add, each identified by contactId or phone number"
},
"idOrSlug": {
"type": "string",
"description": "Unique identifier (UUID) or URL-friendly slug of the target contact list"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Remove one or more contacts from a list by their contact IDs. Does not delete the contacts themselves.
| Parameter | Type | Description |
|---|---|---|
| idOrSlug * | string | Unique identifier (UUID) or URL-friendly slug of the contact list |
| contactIds * | array | Array of contact UUIDs to remove from the list |
{
"name": "neuron_remove_from_contact_list",
"title": "Remove from Contact List",
"description": "Remove one or more contacts from a list by their contact IDs. Does not delete the contacts themselves.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idOrSlug",
"contactIds"
],
"properties": {
"idOrSlug": {
"type": "string",
"description": "Unique identifier (UUID) or URL-friendly slug of the contact list"
},
"contactIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of contact UUIDs to remove from the list"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Display name for the resulting merged list |
| slug | string | URL-friendly slug for the merged list (auto-generated if omitted) |
| mergeType * | string | Merge strategy: 'window' (virtual union, stays in sync) or 'materialized' (static copy at merge time) |
| sourceListIds * | array | UUIDs or slugs of the source lists to merge (minimum 2) |
{
"name": "neuron_merge_contact_lists",
"title": "Merge Contact Lists",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"sourceListIds",
"mergeType"
],
"properties": {
"name": {
"type": "string",
"description": "Display name for the resulting merged list"
},
"slug": {
"type": "string",
"description": "URL-friendly slug for the merged list (auto-generated if omitted)"
},
"mergeType": {
"enum": [
"window",
"materialized"
],
"type": "string",
"description": "Merge strategy: 'window' (virtual union, stays in sync) or 'materialized' (static copy at merge time)"
},
"sourceListIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 2,
"description": "UUIDs or slugs of the source lists to merge (minimum 2)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Retrieve all contact lists that a specific contact belongs to.
| Parameter | Type | Description |
|---|---|---|
| contactId * | string | Unique identifier (UUID) of the contact to look up |
{
"name": "neuron_find_contact_lists_for_contact",
"title": "Find Contact Lists for Contact",
"description": "Retrieve all contact lists that a specific contact belongs to.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"contactId"
],
"properties": {
"contactId": {
"type": "string",
"description": "Unique identifier (UUID) of the contact to look up"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Trigger a refresh of a dynamic contact list. Re-evaluates criteria rules and/or AI prompt and materializes updated members.
| Parameter | Type | Description |
|---|---|---|
| idOrSlug * | string | Unique identifier (UUID) or URL-friendly slug of the dynamic list to refresh |
{
"name": "neuron_refresh_contact_list",
"title": "Refresh Contact List",
"description": "Trigger a refresh of a dynamic contact list. Re-evaluates criteria rules and/or AI prompt and materializes updated members.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idOrSlug"
],
"properties": {
"idOrSlug": {
"type": "string",
"description": "Unique identifier (UUID) or URL-friendly slug of the dynamic list to refresh"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Retrieve a paginated list of all broadcasts with optional filtering by status such as draft, sent, or scheduled.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (default: 1) |
| limit | integer | Number of broadcasts per page (default: 20) |
| status | string | Filter by broadcast status (e.g., 'draft', 'sent', 'scheduled') |
{
"name": "neuron_list_broadcasts",
"title": "List Broadcasts",
"description": "Retrieve a paginated list of all broadcasts with optional filtering by status such as draft, sent, or scheduled.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "integer",
"description": "Page number for pagination (default: 1)",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"description": "Number of broadcasts per page (default: 20)",
"exclusiveMinimum": 0
},
"status": {
"type": "string",
"description": "Filter by broadcast status (e.g., 'draft', 'sent', 'scheduled')"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Display name or label for the broadcast |
| botId | string | Identifier (UUID) of a bot to send through. Each recipient's channel is picked by the bot's load-balancer + sticky sessions. Takes precedence over channelId. |
| message | string | Message content to broadcast to recipients (optional when sending a template). {{first_name}} or {{name}} is replaced with each recipient's saved name, "there" when there is none; {{first_name|Customer}} picks that word. |
| mediaUrl | string | URL of media to attach (required for image or document message types) |
| template | object | Approved template (official WhatsApp Business API sessions only). On official API sessions, use one for broadcasts: most recipients won't have messaged you in the last 24 hours, and only templates reach them. Set messageType to 'template'. |
| channelId | string | Identifier (UUID) of the WhatsApp channel to send through (auto-resolved from default channel if omitted) |
| recipients | array | Direct list of recipients (alternative to recipientSources) |
| messageType | string | Type of message to send (e.g., 'text', 'image', 'document', or 'template' on official API sessions) |
Retrieve detailed information about a specific broadcast, including its status, message content, and recipient summary.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the broadcast to retrieve |
{
"name": "neuron_get_broadcast",
"title": "Get Broadcast",
"description": "Retrieve detailed information about a specific broadcast, including its status, message content, and recipient summary.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the broadcast to retrieve"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Retrieve the paginated list of recipients for a specific broadcast with their individual delivery status.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the broadcast |
| page | integer | Page number for pagination (default: 1) |
| limit | integer | Number of recipients per page (default: 20) |
| status | string | Filter recipients by delivery status (e.g., 'delivered', 'failed', 'pending') |
{
"name": "neuron_get_broadcast_recipients",
"title": "Get Broadcast Recipients",
"description": "Retrieve the paginated list of recipients for a specific broadcast with their individual delivery status.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the broadcast"
},
"page": {
"type": "integer",
"description": "Page number for pagination (default: 1)",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"description": "Number of recipients per page (default: 20)",
"exclusiveMinimum": 0
},
"status": {
"type": "string",
"description": "Filter recipients by delivery status (e.g., 'delivered', 'failed', 'pending')"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Update an existing broadcast's name, message content, or media before sending. The broadcast must still be in draft status.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the broadcast to update |
| name | string | New display name or label for the broadcast |
| message | string | New message content to broadcast |
| mediaUrl | string | New media URL to attach |
| messageType | string | New message type (e.g., 'text', 'image', 'document') |
{
"name": "neuron_update_broadcast",
"title": "Update Broadcast",
"description": "Update an existing broadcast's name, message content, or media before sending. The broadcast must still be in draft status.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the broadcast to update"
},
"name": {
"type": "string",
"description": "New display name or label for the broadcast"
},
"message": {
"type": "string",
"description": "New message content to broadcast"
},
"mediaUrl": {
"type": "string",
"description": "New media URL to attach"
},
"messageType": {
"type": "string",
"description": "New message type (e.g., 'text', 'image', 'document')"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Permanently delete a broadcast and its recipient data. This action cannot be undone.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the broadcast to delete |
{
"name": "neuron_delete_broadcast",
"title": "Delete Broadcast",
"description": "Permanently delete a broadcast and its recipient data. This action cannot be undone.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the broadcast to delete"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Send a broadcast message to all its recipients. The broadcast must be in draft status. This triggers message delivery and cannot be undone.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Unique identifier (UUID) of the broadcast to send |
{
"name": "neuron_send_broadcast",
"title": "Send Broadcast",
"description": "Send a broadcast message to all its recipients. The broadcast must be in draft status. This triggers message delivery and cannot be undone.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (UUID) of the broadcast to send"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Upload a media file (image, video, audio, or document) from a local file path (local server only) or base64 content. Returns a URL for use in messages and broadcasts, plus the sha256 and size of the bytes sent so the upload can be checked.
No parameters.
{
"name": "neuron_upload_media",
"title": "Upload Media",
"description": "Upload a media file (image, video, audio, or document) from a local file path (local server only) or base64 content. Returns a URL for use in messages and broadcasts, plus the sha256 and size of the bytes sent so the upload can be checked.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| action * | string | one of ["list","enable","disable"] |
| toolsets | array | Group names for enable/disable, or ["all"] |
{
"name": "neuron_toolsets",
"title": "Neuron Toolsets",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"list",
"enable",
"disable"
],
"type": "string"
},
"toolsets": {
"type": "array",
"items": {
"type": "string"
},
"description": "Group names for enable/disable, or [\"all\"]"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Neuron's tools are grouped into toolsets and only some are loaded. Call neuron_toolsets (action "list") to see the groups and "enable" the ones a task needs.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "neuron_compose_message",
"title": "Compose Message",
"description": "Compose and send a new message to a phone number via a specific channel. Automatically creates a new conversation if one does not exist.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"channelId",
"to"
],
"properties": {
"to": {
"type": "string",
"description": "Recipient phone number (E.164 format, e.g., '2348012345678')"
},
"text": {
"type": "string",
"description": "Message text content (optional when sending a template)"
},
"sendAt": {
"type": "string",
"description": "ISO 8601 date-time for scheduled delivery (e.g., '2025-12-31T10:00:00Z'). Message sends immediately if omitted."
},
"mediaUrl": {
"type": "string",
"description": "URL of media to attach (required for non-text message types)"
},
"template": {
"type": "object",
"required": [
"name",
"language"
],
"properties": {
"name": {
"type": "string",
"description": "Template name exactly as approved (see neuron_list_whatsapp_templates)"
},
"language": {
"type": "string",
"description": "Template language code, e.g. 'en_US'"
},
"components": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
},
"description": "Meta send-time components with variable values, e.g. [{ type: 'body', parameters: [{ type: 'text', text: 'Ada' }] }]. Omit for templates without variables."
}
},
"description": "Approved template (official WhatsApp Business API sessions only). Required to reach anyone who hasn't messaged you in the last 24 hours. Set messageType to 'template'.",
"additionalProperties": false
},
"channelId": {
"type": "string",
"description": "Unique identifier (UUID) of the WhatsApp channel to send through"
},
"contactName": {
"type": "string",
"description": "Display name for the recipient contact"
},
"messageType": {
"type": "string",
"description": "Type of message: 'text' (default), 'image', 'document', or 'template' (official API sessions)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}{
"name": "neuron_send_whatsapp",
"title": "Send WhatsApp Message",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"to"
],
"properties": {
"to": {
"type": "string",
"description": "Recipient: phone number (e.g., '2348012345678') or group JID (e.g., '120363XXX@g.us')"
},
"text": {
"type": "string",
"description": "Message text content (optional when sending a template)"
},
"sendAt": {
"type": "string",
"description": "ISO 8601 date-time for scheduled delivery (e.g., '2025-12-31T10:00:00Z'). Message sends immediately if omitted."
},
"mediaUrl": {
"type": "string",
"description": "URL of media to attach (required for non-text message types)"
},
"template": {
"type": "object",
"required": [
"name",
"language"
],
"properties": {
"name": {
"type": "string",
"description": "Template name exactly as approved (see neuron_list_whatsapp_templates)"
},
"language": {
"type": "string",
"description": "Template language code, e.g. 'en_US'"
},
"components": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
},
"description": "Meta send-time components with variable values, e.g. [{ type: 'body', parameters: [{ type: 'text', text: 'Ada' }] }]. Omit for templates without variables."
}
},
"description": "Approved template (official WhatsApp Business API sessions only). Required to reach anyone who hasn't messaged you in the last 24 hours. Set messageType to 'template'.",
"additionalProperties": false
},
"channelId": {
"type": "string",
"description": "Unique identifier (UUID) of a specific channel to override auto-resolution"
},
"contactName": {
"type": "string",
"description": "Display name for the recipient contact"
},
"messageType": {
"type": "string",
"description": "Message type: 'text' (default), 'image', 'audio', 'video', 'document', or 'template' (official API sessions)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}| scheduledAt | string | ISO 8601 date-time for scheduled broadcast delivery (e.g., '2025-12-31T10:00:00Z'). Creates as draft if omitted. |
| recipientSources | object | Resolve recipients dynamically from contact lists with filtering and exclusion |
{
"name": "neuron_create_broadcast",
"title": "Create Broadcast",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Display name or label for the broadcast"
},
"botId": {
"type": "string",
"description": "Identifier (UUID) of a bot to send through. Each recipient's channel is picked by the bot's load-balancer + sticky sessions. Takes precedence over channelId."
},
"message": {
"type": "string",
"description": "Message content to broadcast to recipients (optional when sending a template). {{first_name}} or {{name}} is replaced with each recipient's saved name, \"there\" when there is none; {{first_name|Customer}} picks that word."
},
"mediaUrl": {
"type": "string",
"description": "URL of media to attach (required for image or document message types)"
},
"template": {
"type": "object",
"required": [
"name",
"language"
],
"properties": {
"name": {
"type": "string",
"description": "Template name exactly as approved (see neuron_list_whatsapp_templates)"
},
"language": {
"type": "string",
"description": "Template language code, e.g. 'en_US'"
},
"components": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
},
"description": "Meta send-time components with variable values, e.g. [{ type: 'body', parameters: [{ type: 'text', text: 'Ada' }] }]. Omit for templates without variables."
}
},
"description": "Approved template (official WhatsApp Business API sessions only). On official API sessions, use one for broadcasts: most recipients won't have messaged you in the last 24 hours, and only templates reach them. Set messageType to 'template'.",
"additionalProperties": false
},
"channelId": {
"type": "string",
"description": "Identifier (UUID) of the WhatsApp channel to send through (auto-resolved from default channel if omitted)"
},
"recipients": {
"type": "array",
"items": {
"type": "object",
"required": [
"phone"
],
"properties": {
"phone": {
"type": "string",
"description": "Recipient phone number in E.164 format (e.g., '+2348012345678')"
},
"contactName": {
"type": "string",
"description": "Display name of the recipient contact"
}
},
"additionalProperties": false
},
"description": "Direct list of recipients (alternative to recipientSources)"
},
"messageType": {
"type": "string",
"description": "Type of message to send (e.g., 'text', 'image', 'document', or 'template' on official API sessions)"
},
"scheduledAt": {
"type": "string",
"description": "ISO 8601 date-time for scheduled broadcast delivery (e.g., '2025-12-31T10:00:00Z'). Creates as draft if omitted."
},
"recipientSources": {
"type": "object",
"properties": {
"phones": {
"type": "array",
"items": {
"type": "string"
},
"description": "Individual phone numbers in E.164 format to include"
},
"filters": {
"type": "object",
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Only include contacts matching these tags"
}
},
"description": "Additional filters to narrow down recipients",
"additionalProperties": false
},
"listIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Contact list identifiers (UUIDs or slugs) to include as recipients"
},
"excludeListIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Contact list identifiers (UUIDs or slugs) to exclude from recipients"
}
},
"description": "Resolve recipients dynamically from contact lists with filtering and exclusion",
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}