WAHA MCP Server

Instructions

Implementation Reference

• src/index.ts:1577-1597 (handler)

  Primary MCP tool handler for 'waha_get_chat_picture'. Validates args, calls WAHAClient.getChatPicture(), formats and returns the picture URL response.

    const chatId = args.chatId;
    const refresh = args.refresh || false;
  
    if (!chatId) {
      throw new Error("chatId is required");
    }
  
    const result = await this.wahaClient.getChatPicture({
      chatId,
      refresh,
    });
  
    return {
      content: [
        {
          type: "text",
          text: `Chat picture URL for ${chatId}:\n${result.url}\n${refresh ? '(Refreshed from server)' : '(From 24h cache)'}`,
        },
      ],
    };
  }

• src/index.ts:327-345 (registration)

  Tool registration definition in ListToolsRequestSchema handler, including name, description, and input schema for validation.

  {
    name: "waha_get_chat_picture",
    description: "Get the profile picture URL for a chat. Uses 24-hour cache by default.",
    inputSchema: {
      type: "object",
      properties: {
        chatId: {
          type: "string",
          description: "Chat ID (format: number@c.us)",
        },
        refresh: {
          type: "boolean",
          description: "Refresh from server instead of using cache (default: false)",
          default: false,
        },
      },
      required: ["chatId"],
    },
  },

• src/index.ts:1077-1078 (registration)

  Switch case registration in CallToolRequestSchema handler that routes calls to the tool handler function.

  case "waha_get_chat_picture":
    return await this.handleGetChatPicture(args);

• src/client/waha-client.ts:505-528 (helper)

  WAHAClient helper method that performs the actual HTTP GET request to the WAHA API endpoint /api/{session}/chats/{chatId}/picture to retrieve the chat picture URL.

  async getChatPicture(params: {
    chatId: string;
    refresh?: boolean;
  }): Promise<{ url: string }> {
    const { chatId, refresh } = params;
  
    if (!chatId) {
      throw new WAHAError("chatId is required");
    }
  
    const queryParams: Record<string, any> = {};
    if (refresh !== undefined) {
      queryParams.refresh = refresh;
    }
  
    const queryString = this.buildQueryString(queryParams);
    const endpoint = `/api/${this.session}/chats/${encodeURIComponent(
      chatId
    )}/picture${queryString}`;
  
    return this.request<{ url: string }>(endpoint, {
      method: "GET",
    });
  }