WAHA MCP Server

Instructions

Implementation Reference

• src/index.ts:239-256 (registration)

  Tool registration and schema definition in the ListToolsRequestSchema handler. Defines name, description, and input schema (chatId and messageId required).

  {
    name: "waha_unpin_message",
    description: "Unpin a message in a chat.",
    inputSchema: {
      type: "object",
      properties: {
        chatId: {
          type: "string",
          description: "Chat ID (format: number@c.us)",
        },
        messageId: {
          type: "string",
          description: "Message ID to unpin",
        },
      },
      required: ["chatId", "messageId"],
    },
  },

• src/index.ts:1437-1461 (handler)

  MCP tool handler function. Validates input parameters (chatId, messageId), calls the WAHA client unpinMessage method, and returns success message.

   * Handle waha_unpin_message tool
   */
  private async handleUnpinMessage(args: any) {
    const chatId = args.chatId;
    const messageId = args.messageId;
  
    if (!chatId) {
      throw new Error("chatId is required");
    }
  
    if (!messageId) {
      throw new Error("messageId is required");
    }
  
    await this.wahaClient.unpinMessage(chatId, messageId);
  
    return {
      content: [
        {
          type: "text",
          text: `Successfully unpinned message ${messageId} from chat ${chatId}.`,
        },
      ],
    };
  }

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

  Tool dispatch registration in the CallToolRequestSchema switch statement. Routes calls to waha_unpin_message to the handleUnpinMessage handler.

    return await this.handlePinMessage(args);
  case "waha_unpin_message":
    return await this.handleUnpinMessage(args);
  case "waha_clear_chat_messages":

• src/client/waha-client.ts:395-411 (helper)

  Underlying WAHA client method that performs the actual HTTP POST request to unpin the message via the WAHA API endpoint.

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