WAHA MCP Server

Instructions

Implementation Reference

• src/index.ts:1666-1717 (handler)

  Main execution handler for waha_send_audio tool. Validates parameters, prepares file object from URL or base64 data, calls WAHA client sendAudio method, and returns formatted success response with message ID and timestamp.
  private async handleSendAudio(args: any) { const chatId = args.chatId; const fileUrl = args.fileUrl; const fileData = args.fileData; const mimetype = args.mimetype; const filename = args.filename; const replyTo = args.replyTo; if (!chatId) { throw new Error("chatId is required"); } if (!mimetype) { throw new Error("mimetype is required"); } if (!fileUrl && !fileData) { throw new Error("Either fileUrl or fileData is required"); } const file: any = { mimetype, filename, }; if (fileUrl) { file.url = fileUrl; } else { file.data = fileData; } const response = await this.wahaClient.sendAudio({ chatId, file, reply_to: replyTo, }); const formattedResponse = formatSendMessageSuccess( chatId, response.id, response.timestamp ); return { content: [ { type: "text", text: `${formattedResponse}\nMedia type: audio/voice`, }, ], }; }
• src/index.ts:389-422 (registration)

  Tool registration in ListTools handler, including name, description, and complete input schema definition for parameter validation.
  { name: "waha_send_audio", description: "Send audio/voice messages to a WhatsApp chat. Supports URL or base64 data.", inputSchema: { type: "object", properties: { chatId: { type: "string", description: "Chat ID (format: number@c.us)", }, fileUrl: { type: "string", description: "URL of the audio file to send (use either fileUrl or fileData, not both)", }, fileData: { type: "string", description: "Base64 encoded audio data (use either fileUrl or fileData, not both)", }, mimetype: { type: "string", description: "MIME type of the audio file (e.g., 'audio/ogg', 'audio/mpeg')", }, filename: { type: "string", description: "Optional filename for the audio", }, replyTo: { type: "string", description: "Optional message ID to reply to", }, }, required: ["chatId", "mimetype"], }, },
• src/index.ts:392-421 (schema)

  Input schema for waha_send_audio tool defining structure, types, descriptions, and required fields for validation.
  inputSchema: { type: "object", properties: { chatId: { type: "string", description: "Chat ID (format: number@c.us)", }, fileUrl: { type: "string", description: "URL of the audio file to send (use either fileUrl or fileData, not both)", }, fileData: { type: "string", description: "Base64 encoded audio data (use either fileUrl or fileData, not both)", }, mimetype: { type: "string", description: "MIME type of the audio file (e.g., 'audio/ogg', 'audio/mpeg')", }, filename: { type: "string", description: "Optional filename for the audio", }, replyTo: { type: "string", description: "Optional message ID to reply to", }, }, required: ["chatId", "mimetype"], },
• src/client/waha-client.ts:580-611 (helper)

  Core WAHA client helper method that performs the actual HTTP POST to /api/sendVoice endpoint to send audio message.
  async sendAudio(params: { chatId: string; file: { mimetype: string; url?: string; data?: string; // base64 filename?: string; }; reply_to?: string; }): Promise<SendMessageResponse> { const { chatId, file, reply_to } = params; if (!chatId) { throw new WAHAError("chatId is required"); } if (!file || (!file.url && !file.data)) { throw new WAHAError("file with url or data is required"); } const body = { chatId, file, session: this.session, reply_to, }; return this.request<SendMessageResponse>("/api/sendVoice", { method: "POST", body: JSON.stringify(body), }); }
• src/tools/formatters.ts:107-109 (helper)

  Utility function used by the handler to format the success response text.
  export function formatSendMessageSuccess(chatId: string, messageId: string, timestamp: number): string { return `Message sent successfully!\nChat: ${chatId}\nMessage ID: ${messageId}\nTime: ${formatTimestamp(timestamp)}`; }