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);