WAHA MCP Server

Instructions

Implementation Reference

• src/index.ts:580-601 (registration)

  Registration of the waha_set_group_picture tool in the MCP ListTools handler, including input schema definition.

  {
    name: "waha_set_group_picture",
    description: "Set or update group profile picture.",
    inputSchema: {
      type: "object",
      properties: {
        groupId: {
          type: "string",
          description: "Group ID (format: number@g.us)",
        },
        fileUrl: {
          type: "string",
          description: "URL of the image (use either fileUrl or fileData)",
        },
        fileData: {
          type: "string",
          description: "Base64 encoded image data (use either fileUrl or fileData)",
        },
      },
      required: ["groupId"],
    },
  },

• src/index.ts:1942-1972 (handler)

  MCP tool handler function that validates input, calls WAHAClient.setGroupPicture, and returns success response.

  private async handleSetGroupPicture(args: any) {
    const groupId = args.groupId;
    const fileUrl = args.fileUrl;
    const fileData = args.fileData;
  
    if (!groupId) {
      throw new Error("groupId is required");
    }
  
    if (!fileUrl && !fileData) {
      throw new Error("Either fileUrl or fileData is required");
    }
  
    const file: any = {};
    if (fileUrl) file.url = fileUrl;
    if (fileData) file.data = fileData;
  
    await this.wahaClient.setGroupPicture({
      groupId,
      file,
    });
  
    return {
      content: [
        {
          type: "text",
          text: `Successfully set picture for group ${groupId}.`,
        },
      ],
    };
  }

• src/client/waha-client.ts:820-845 (helper)

  Underlying WAHA API client method that makes the HTTP POST request to set group picture via WAHA server.

  async setGroupPicture(params: {
    groupId: string;
    file: {
      url?: string;
      data?: string;
    };
  }): Promise<void> {
    const { groupId, file } = params;
  
    if (!groupId) {
      throw new WAHAError("groupId is required");
    }
  
    if (!file || (!file.url && !file.data)) {
      throw new WAHAError("file with url or data is required");
    }
  
    const endpoint = `/api/${this.session}/groups/${encodeURIComponent(groupId)}/picture`;
  
    const body = { file };
  
    await this.request<void>(endpoint, {
      method: "POST",
      body: JSON.stringify(body),
    });
  }