Skip to content

Free, Open Source, Self-Hosted WhatsApp API Gateway

docs(mcp): name the engine limit of three MCP tools

Yudhi Armyndharis5e0c0286a978
diff --git a/docs/24-mcp-integration.md b/docs/24-mcp-integration.md
index d71c68245..20d2bb258 100644
--- a/docs/24-mcp-integration.md
+++ b/docs/24-mcp-integration.md
@@ -155,6 +155,10 @@ code is a transferable join capability, so it sits at OPERATOR like the QR endpo
> a transient failure and retry something that cannot succeed on that engine. Labels are a WhatsApp
> Business feature throughout.
+> **Three more tools answer `501` on one engine**, and their descriptions say so. `MessageHistory`
+> and `MessageGetReactions` need whatsapp-web.js; on Baileys use `MessageList` for stored messages.
+> `GroupCreate` needs Baileys; whatsapp-web.js cannot create a group.
+
**Deliberately excluded from the surface** (not exposed as tools): session lifecycle
(create/delete/start/stop/logout/force-kill), chat delete, bulk send, message delete, message edit,
group
diff --git a/src/core/agent-tools/tools/group.tools.ts b/src/core/agent-tools/tools/group.tools.ts
index 4aa67217c..6568349f5 100644
--- a/src/core/agent-tools/tools/group.tools.ts
+++ b/src/core/agent-tools/tools/group.tools.ts
@@ -63,7 +63,9 @@ export function groupTools(group: GroupService): AnyToolDescriptor[] {
}),
defineTool({
name: 'GroupCreate',
- description: 'Create a new WhatsApp group with a name and initial participants. Requires OPERATOR role.',
+ description:
+ 'Create a new WhatsApp group with a name and initial participants. ' +
+ 'Requires the Baileys engine; whatsapp-web.js answers 501 and a retry cannot succeed. Requires OPERATOR role.',
tier: 'write',
requiredRole: ApiKeyRole.OPERATOR,
sessionScoped: true,
diff --git a/src/core/agent-tools/tools/message.tools.ts b/src/core/agent-tools/tools/message.tools.ts
index f20ffb034..b395448bf 100644
--- a/src/core/agent-tools/tools/message.tools.ts
+++ b/src/core/agent-tools/tools/message.tools.ts
@@ -110,7 +110,8 @@ export function messageTools(message: MessageService): AnyToolDescriptor[] {
name: 'MessageHistory',
chatScope: ['chatId'],
description:
- 'Fetch live chat history from WhatsApp for a specific chat. Bypasses the local DB — useful for messages that arrived before the gateway started.',
+ 'Fetch live chat history from WhatsApp for a specific chat. Bypasses the local DB — useful for messages that arrived before the gateway started. ' +
+ 'Requires the whatsapp-web.js engine; Baileys answers 501 and a retry cannot succeed, so use MessageList for stored messages.',
tier: 'read',
sessionScoped: true,
inputSchema: z.object({
@@ -132,7 +133,9 @@ export function messageTools(message: MessageService): AnyToolDescriptor[] {
defineTool({
name: 'MessageGetReactions',
chatScope: ['chatId'],
- description: 'Get reactions for a specific message, including which contacts sent which emoji.',
+ description:
+ 'Get reactions for a specific message, including which contacts sent which emoji. ' +
+ 'Requires the whatsapp-web.js engine; Baileys answers 501 and a retry cannot succeed.',
tier: 'read',
sessionScoped: true,
inputSchema: z.object({