Skip to main content
Glama

Create WhatsApp Group

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.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
slugNoOptional org-unique handle (lowercase letters, numbers, hyphens)
tagsNoKeep only contacts carrying one of these tags
phonesNoRaw phone numbers, e.g. pasted from a CSV
listIdsNoContact list ids or slugs — pulls every member
subjectYesGroup name
ifExistsNoWhen the slug is already taken: 'error' (default) fails, 'return' returns the existing group and adds any given members to it (idempotent create).
channelIdNoSession (connected WhatsApp number) UUID. Omit to use the default.
contactIdsNoExisting contact ids
allContactsNoUnion the org's entire address book
descriptionNoOptional group description
fromGroupIdsNoCopy/combine members live from these WhatsApp group JIDs
excludeListIdsNoSubtract every member of these lists

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Added

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With all annotations false, the description carries the full disclosure burden. It reveals non-obvious behaviors: privacy-blocked members appear in a failed list, the slug allows later addressing without a JID, and the tool falls back to the org's default session unless channelId is provided. It could also mention return structure or permission requirements, but the disclosed behaviors are substantive and go well beyond a generic creation statement.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four dense sentences with zero filler. The first sentence identifies the verb and resource, then each subsequent sentence adds a distinct behavioral fact: member-source combinations, slug addressing, privacy-failure handling, and session selection. For a 12-parameter creation tool, this is appropriately sized and well front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers the core creation action, all major input source categories, slug semantics, a partial-failure mode, and session selection — a strong picture for a complex tool with no output schema and no annotations. The main gap is that it doesn't describe what a successful response contains (e.g., group ID/JID), though the mention of a 'failed list' hints at the response shape. This is a minor omission given how much else is covered.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3. The description adds conceptual grouping that the flat schema doesn't: it explains that member sources can be combined from groups (fromGroupIds), contact lists (listIds), individual contacts (contactIds), pasted numbers (phones), or the whole address book (allContacts). It also clarifies the slug's purpose ('address the group later without its JID'), which goes slightly beyond the schema's own description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a precise verb and resource: 'Create a new WhatsApp group.' It then adds the member-seeding scope and the slug mechanism, making it clearly distinct from siblings like neuron_add_group_members, neuron_update_group_settings, and neuron_remove_group_members. The word 'new' also signals the lifecycle stage, so an agent immediately knows this is for group creation, not modification.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description makes the intended use context clear: creating a new group and simultaneously seeding members from various sources. This implicitly distinguishes it from later-stage member operations, but it never explicitly names alternatives or states when NOT to use this tool (e.g., 'to add members to an existing group, use neuron_add_group_members instead'). A small explicit routing note would push this to a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

B3.4/5.0
Disambiguation3/5

Most tools are clearly separated by resource type, but there is meaningful overlap in messaging entry points (send_message, send_whatsapp, compose_message, bot_api_send) and contact ingestion/sync tools (import_contacts, populate_contacts, sync_whatsapp_contacts). The descriptions help disambiguate, but with 309 tools an agent will frequently need to read closely to pick the right one.

Naming Consistency4/5

The overwhelming majority of tools follow a consistent verb_noun snake_case pattern: create_*, get_*, list_*, update_*, delete_*. Minor deviations like sales_stats, lead_stats, wallet_balance, and whoami break the pattern slightly, but overall naming is highly predictable.

Tool Count1/5

309 tools is an extreme count for any MCP server, even a broad platform. This creates significant cognitive load and navigation overhead for agents, and far exceeds the well-scoped 3-15 tool range where coherence is strongest.

Completeness4/5

The tool surface is remarkably comprehensive across bots, contacts, campaigns, flows, knowledge bases, personas, marketplace, wallet, and products. Minor gaps exist — lead sources lack update/delete tools, and there is no single get_task or get_webhook alongside their list/update/delete counterparts — but these are workable gaps rather than dead ends.

Resources