WAHA MCP Server

Instructions

Implementation Reference

• src/index.ts:272-284 (registration)

  Tool registration and input schema definition for 'waha_delete_chat' in the listTools handler

    name: "waha_delete_chat",
    description: "Delete a chat completely. 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:1488-1505 (handler)

  Main handler function that processes 'waha_delete_chat' tool calls, validates input, calls WAHAClient.deleteChat, and returns confirmation

  private async handleDeleteChat(args: any) {
    const chatId = args.chatId;
  
    if (!chatId) {
      throw new Error("chatId is required");
    }
  
    await this.wahaClient.deleteChat(chatId);
  
    return {
      content: [
        {
          type: "text",
          text: `WARNING: Chat ${chatId} has been completely deleted.\nThis operation cannot be undone.`,
        },
      ],
    };
  }

• src/client/waha-client.ts:435-445 (handler)

  WAHAClient.deleteChat method - core API implementation that makes the DELETE request to WAHA API to delete the chat

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