WAHA MCP Server

Instructions

Implementation Reference

• src/index.ts:1466-1483 (handler)

  The primary handler function for the 'waha_clear_chat_messages' tool. It validates input, calls the WAHAClient.clearChatMessages method, and returns a confirmation message warning about the destructive nature of the operation.

  private async handleClearChatMessages(args: any) {
    const chatId = args.chatId;
  
    if (!chatId) {
      throw new Error("chatId is required");
    }
  
    await this.wahaClient.clearChatMessages(chatId);
  
    return {
      content: [
        {
          type: "text",
          text: `WARNING: All messages have been cleared from chat ${chatId}.\nThis operation cannot be undone.`,
        },
      ],
    };
  }

• src/index.ts:258-270 (schema)

  Input schema definition for the tool, specifying the required 'chatId' parameter and description.

    name: "waha_clear_chat_messages",
    description: "Clear all messages from a chat. WARNING: This is a destructive operation that cannot be undone.",
    inputSchema: {
      type: "object",
      properties: {
        chatId: {
          type: "string",
          description: "Chat ID (format: number@c.us)",
        },
      },
      required: ["chatId"],
    },
  },

• src/index.ts:1067-1073 (registration)

  Registration and dispatch logic in the CallToolRequestSchema handler's switch statement that routes calls to the specific handler function.

  case "waha_clear_chat_messages":
    return await this.handleClearChatMessages(args);
  case "waha_delete_chat":
    return await this.handleDeleteChat(args);
  case "waha_archive_chat":
    return await this.handleArchiveChat(args);
  case "waha_unarchive_chat":

• src/client/waha-client.ts:417-429 (helper)

  Underlying WAHAClient helper method that performs the actual HTTP DELETE request to the WAHA API endpoint to clear messages from the specified chat.

  async clearChatMessages(chatId: string): Promise<void> {
    if (!chatId) {
      throw new WAHAError("chatId is required");
    }
  
    const endpoint = `/api/${this.session}/chats/${encodeURIComponent(
      chatId
    )}/messages`;
  
    await this.request<void>(endpoint, {
      method: "DELETE",
    });
  }