# WhatsApp Business API MCP Server

    A comprehensive Model Context Protocol (MCP) server for interacting with the WhatsApp Business API.

    ## Features

    - Send various types of messages (text, template, media, interactive)
    - Manage message templates
    - Upload and manage media files
    - Update business profile information
    - Manage phone numbers
    - Configure webhooks

    ## Prerequisites

    - Node.js 16 or higher
    - WhatsApp Business API credentials:
      - API Token
      - Phone Number ID
      - Business Account ID

    ## Installation

    ```bash
    npm install whatsapp-business-mcp-server
    ```

    Or run directly with npx:

    ```bash
    npx whatsapp-business-mcp-server
    ```

    ## Configuration

    Create a `.env` file with your WhatsApp Business API credentials:

    ```
    WHATSAPP_API_TOKEN=your_api_token_here
    WHATSAPP_PHONE_NUMBER_ID=your_phone_number_id_here
    WHATSAPP_BUSINESS_ACCOUNT_ID=your_business_account_id_here
    WHATSAPP_API_VERSION=v18.0
    ```

    ## Usage

    ### Starting the Server

    ```bash
    npm start
    ```

    ### Development Mode

    ```bash
    npm run dev
    ```

    ### Using with MCP Inspector

    ```bash
    npm run inspect
    ```

    ## Available Tools

    ### Messaging

    - `sendTextMessage` - Send a text message
    - `sendTemplateMessage` - Send a template message
    - `sendImageMessage` - Send an image
    - `sendDocumentMessage` - Send a document
    - `sendVideoMessage` - Send a video
    - `sendLocationMessage` - Send a location
    - `sendContactMessage` - Send contact information
    - `sendInteractiveMessage` - Send interactive messages
    - `markMessageAsRead` - Mark a message as read

    ### Media

    - `uploadMedia` - Upload media to WhatsApp servers
    - `getMediaUrl` - Get the URL for a media file
    - `deleteMedia` - Delete media from WhatsApp servers

    ### Templates

    - `getMessageTemplates` - Get message templates
    - `createMessageTemplate` - Create a message template

    ### Business Profile

    - `getBusinessProfile` - Get business profile information
    - `updateBusinessProfile` - Update business profile

    ### Phone Numbers

    - `getPhoneNumbers` - Get phone numbers
    - `getPhoneNumberById` - Get phone number details
    - `requestVerificationCode` - Request verification code
    - `verifyCode` - Verify a phone number

    ### Webhooks

    - `getWebhookInfo` - Get webhook information
    - `subscribeWebhook` - Subscribe to webhooks
    - `deleteWebhookSubscription` - Delete webhook subscription

    ## Available Resources

    - `whatsapp://templates` - List all templates
    - `whatsapp://templates/{category}` - List templates by category
    - `whatsapp://template/{name}` - Get template details
    - `whatsapp://business-profile` - View business profile
    - `whatsapp://phone-numbers` - List phone numbers
    - `whatsapp://phone-number/{id}` - Get phone number details
    - `whatsapp://docs` - API documentation

    ## License

    MIT