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), }); }