Free, Open Source, Self-Hosted WhatsApp API Gateway
TypeScript apibotgatewayself-hostedwhatsappwhatsapp-apiwhatsapp-automationwhatsapp-botwhatsapp-gatewaywhatsapp-gateway-apiwhatsapp-webwhatsapp-web-api
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.mdindex 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,groupdiff --git a/src/core/agent-tools/tools/group.tools.ts b/src/core/agent-tools/tools/group.tools.tsindex 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.tsindex 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({