WAHA MCP Server

Instructions

Implementation Reference

• src/index.ts:185-214 (registration)

  MCP tool registration and input schema definition for 'waha_edit_message' in the listTools handler
  name: "waha_edit_message", description: "Edit a sent message in a chat. Only works for messages sent by the bot.", inputSchema: { type: "object", properties: { chatId: { type: "string", description: "Chat ID (format: number@c.us)", }, messageId: { type: "string", description: "Message ID to edit", }, text: { type: "string", description: "New message text", }, linkPreview: { type: "boolean", description: "Enable link preview (default: true)", default: true, }, linkPreviewHighQuality: { type: "boolean", description: "Enable high quality link preview (default: false)", default: false, }, }, required: ["chatId", "messageId", "text"], },
• src/index.ts:1367-1402 (handler)

  Primary MCP tool handler for 'waha_edit_message'. Validates input, calls WAHAClient.editMessage, and formats success response.
  private async handleEditMessage(args: any) { const chatId = args.chatId; const messageId = args.messageId; const text = args.text; const linkPreview = args.linkPreview !== false; const linkPreviewHighQuality = args.linkPreviewHighQuality || false; if (!chatId) { throw new Error("chatId is required"); } if (!messageId) { throw new Error("messageId is required"); } if (!text) { throw new Error("text is required"); } await this.wahaClient.editMessage({ chatId, messageId, text, linkPreview, linkPreviewHighQuality, }); return { content: [ { type: "text", text: `Successfully edited message ${messageId} in chat ${chatId}.\nNew text: ${text}`, }, ], }; }
• src/client/waha-client.ts:320-355 (handler)

  Low-level WAHAClient.editMessage method that performs the actual PUT request to WAHA API to edit a message.
  async editMessage(params: { chatId: string; messageId: string; text: string; linkPreview?: boolean; linkPreviewHighQuality?: boolean; }): Promise<void> { const { chatId, messageId, text, linkPreview, linkPreviewHighQuality } = params; if (!chatId) { throw new WAHAError("chatId is required"); } if (!messageId) { throw new WAHAError("messageId is required"); } if (!text) { throw new WAHAError("text is required"); } const endpoint = `/api/${this.session}/chats/${encodeURIComponent( chatId )}/messages/${encodeURIComponent(messageId)}`; const body = { text, linkPreview: linkPreview !== false, linkPreviewHighQuality: linkPreviewHighQuality || false, }; await this.request<void>(endpoint, { method: "PUT", body: JSON.stringify(body), }); }
• src/index.ts:1061-1062 (handler)

  Dispatch case in MCP CallToolRequestSchema handler that routes to the specific tool handler.
  case "waha_edit_message": return await this.handleEditMessage(args);