WAHA MCP Server

Instructions

Implementation Reference

• src/index.ts:2031-2056 (handler)

  Main handler function for waha_update_group_subject tool. Validates input, calls WAHAClient.updateGroupSubject, and returns success message.

  private async handleUpdateGroupSubject(args: any) {
    const groupId = args.groupId;
    const subject = args.subject;
  
    if (!groupId) {
      throw new Error("groupId is required");
    }
  
    if (!subject) {
      throw new Error("subject is required");
    }
  
    await this.wahaClient.updateGroupSubject({
      groupId,
      subject,
    });
  
    return {
      content: [
        {
          type: "text",
          text: `Successfully updated group ${groupId} name to "${subject}".`,
        },
      ],
    };
  }

• src/index.ts:635-651 (schema)

  Tool schema definition including input validation for groupId and subject parameters.

    name: "waha_update_group_subject",
    description: "Change group name/subject.",
    inputSchema: {
      type: "object",
      properties: {
        groupId: {
          type: "string",
          description: "Group ID (format: number@g.us)",
        },
        subject: {
          type: "string",
          description: "New group name",
        },
      },
      required: ["groupId", "subject"],
    },
  },

• src/index.ts:1103-1106 (registration)

  Tool dispatch registration in the CallToolRequestSchema switch statement.

  case "waha_update_group_subject":
    return await this.handleUpdateGroupSubject(args);
  case "waha_update_group_description":
    return await this.handleUpdateGroupDescription(args);

• src/client/waha-client.ts:893-915 (helper)

  Underlying WAHAClient helper method that performs the HTTP PUT request to update the group subject via WAHA API.

  async updateGroupSubject(params: {
    groupId: string;
    subject: string;
  }): Promise<void> {
    const { groupId, subject } = params;
  
    if (!groupId) {
      throw new WAHAError("groupId is required");
    }
  
    if (!subject) {
      throw new WAHAError("subject is required");
    }
  
    const endpoint = `/api/${this.session}/groups/${encodeURIComponent(groupId)}/subject`;
  
    const body = { subject };
  
    await this.request<void>(endpoint, {
      method: "PUT",
      body: JSON.stringify(body),
    });
  }