WAHA MCP Server

Instructions

Implementation Reference

• src/index.ts:1511-1527 (handler)

  MCP tool handler function that extracts chatId from arguments, validates it, calls wahaClient.archiveChat, and returns success text response.

    const chatId = args.chatId;
  
    if (!chatId) {
      throw new Error("chatId is required");
    }
  
    await this.wahaClient.archiveChat(chatId);
  
    return {
      content: [
        {
          type: "text",
          text: `Successfully archived chat ${chatId}.`,
        },
      ],
    };
  }

• src/index.ts:286-298 (schema)

  Input schema definition for the waha_archive_chat tool, specifying chatId as required string parameter.

    name: "waha_archive_chat",
    description: "Archive a chat. Archived chats are hidden from the main chat list.",
    inputSchema: {
      type: "object",
      properties: {
        chatId: {
          type: "string",
          description: "Chat ID (format: number@c.us)",
        },
      },
      required: ["chatId"],
    },
  },

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

  Dispatch in CallToolRequestSchema switch statement that routes calls to the waha_archive_chat handler.

    return await this.handleArchiveChat(args);
  case "waha_unarchive_chat":

• src/client/waha-client.ts:451-463 (helper)

  WAHAClient helper method that performs POST request to WAHA API /chats/{chatId}/archive endpoint to archive the chat.

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