# neuron_create_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. Optionally pass a unique slug to address the group later without its JID. Members blocked by privacy come back in the failed list. Uses the org's default connected session unless channelId is given.

Agent View of the PolicyLayer registry record for `neuron_create_group`. HTML page: https://policylayer.com/tools/io-github-conquext-neuron/neuron-create-group

## Facts

- Tool: `neuron_create_group`
- Server: Neuron (`neuron-mcp-server`) — https://policylayer.com/tools/io-github-conquext-neuron.md
- Install: `npx -y neuron-mcp-server`
- Homepage: https://github.com/conquext/neuron
- Risk category: Write (Medium risk)
- Registry record: grade F, identity unverified
- Server auth posture: open
- Server CORS policy: *
- Server rate-limited: no
- Parameters: 12 (1 required)
- Recommended policy verdict: Rate-limited

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `slug` | string | no | Optional org-unique handle (lowercase letters, numbers, hyphens) |
| `tags` | array | no | Keep only contacts carrying one of these tags |
| `phones` | array | no | Raw phone numbers, e.g. pasted from a CSV |
| `listIds` | array | no | Contact list ids or slugs — pulls every member |
| `subject` | string | yes | Group name |
| `ifExists` | string | no | When the slug is already taken: 'error' (default) fails, 'return' returns the existing group and adds any given members to it (idempotent create). |
| `channelId` | string | no | Session (connected WhatsApp number) UUID. Omit to use the default. |
| `contactIds` | array | no | Existing contact ids |
| `allContacts` | boolean | no | Union the org's entire address book |
| `description` | string | no | Optional group description |
| `fromGroupIds` | array | no | Copy/combine members live from these WhatsApp group JIDs |
| `excludeListIds` | array | no | Subtract every member of these lists |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "neuron_create_group",
    "arguments": {
      "subject": "<subject>"
    }
  }
}
```

## Why neuron_create_group is rated Medium

An AI agent can call neuron_create_group faster than any human can review: one bad instruction and it creates or modifies resources in Neuron by the hundred, each call as confident as the last.

Risk signals: High parameter count (12 properties)

## Use case

AI agents use neuron_create_group to create or update resources in Neuron, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Neuron environment.

## Recommended policy (PolicyLayer)

Verdict: **Rate-limited**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Neuron:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "neuron_create_group": {
      "limits": [
        {
          "counter": "neuron_create_group_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}
```

## Other tools on Neuron (400)

- `neuron_cancel_approval` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-cancel-approval.md
- `neuron_cancel_booking` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-cancel-booking.md
- `neuron_cancel_flow_run` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-cancel-flow-run.md
- `neuron_cancel_scheduled_message` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-cancel-scheduled-message.md
- `neuron_clear_chat` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-clear-chat.md
- `neuron_clear_media` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-clear-media.md
- `neuron_delete_ad_request` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-ad-request.md
- `neuron_delete_blog_post` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-blog-post.md
- `neuron_delete_bot` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-bot.md
- `neuron_delete_broadcast` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-broadcast.md
- `neuron_delete_calendar` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-calendar.md
- `neuron_delete_campaign` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-campaign.md
- `neuron_delete_channel` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-channel.md
- `neuron_delete_contact` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-contact.md
- `neuron_delete_contact_list` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-contact-list.md
- `neuron_delete_event` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-event.md
- `neuron_delete_event_type` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-event-type.md
- `neuron_delete_flow` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-flow.md
- `neuron_delete_flow_run` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-flow-run.md
- `neuron_delete_kb_entry` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-kb-entry.md
- `neuron_delete_knowledge_base` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-knowledge-base.md
- `neuron_delete_list_campaign` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-list-campaign.md
- `neuron_delete_message` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-message.md
- `neuron_delete_newsletter` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-newsletter.md
- `neuron_delete_outbound_webhook` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-outbound-webhook.md
- `neuron_delete_override` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-override.md
- `neuron_delete_persona` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-persona.md
- `neuron_delete_product` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-product.md
- `neuron_delete_sms_campaign` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-sms-campaign.md
- `neuron_delete_social_channel` — Destructive — https://policylayer.com/tools/io-github-conquext-neuron/neuron-delete-social-channel.md
- …and 370 more: https://policylayer.com/tools/io-github-conquext-neuron.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=io-github-conquext-neuron · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/io-github-conquext-neuron