# Triple Whale MCP Server

    An MCP server for accessing Triple Whale e-commerce analytics data through the Triple Whale API.

    ## Features

    - Access to Blended Stats Table data
    - Shop information retrieval
    - Available metrics and dimensions discovery
    - MCP Inspector integration for testing

    ## Setup

    1. Clone this repository
    2. Install dependencies:
       ```
       npm install
       ```
    3. Create a `.env` file with your Triple Whale API credentials:
       ```
       TRIPLE_WHALE_API_KEY=your_api_key_here
       TRIPLE_WHALE_SHOP_ID=your_shop_id_here
       ```
    4. Run the server:
       ```
       npm run dev
       ```

    ## Testing with MCP Inspector

    To test the server with the MCP Inspector:

    ```
    npm run inspect
    ```

    This will open a web interface where you can:
    - Test all available tools with custom inputs
    - Browse available resources
    - View server logs and responses

    ## Available Tools

    - `get_blended_stats`: Get blended statistics from Triple Whale
    - `get_shop_info`: Get information about the configured shop
    - `get_available_metrics`: Get list of available metrics for the shop
    - `get_available_dimensions`: Get list of available dimensions for the shop

    ## Available Resources

    - `triplewhale://shop`: Information about the configured shop
    - `triplewhale://metrics`: List of available metrics
    - `triplewhale://dimensions`: List of available dimensions

    ## Example Usage

    ### Getting Blended Stats

    ```json
    {
      "dateRange": {
        "start": "2023-01-01",
        "end": "2023-01-31"
      },
      "metrics": [
        {
          "id": "revenue"
        },
        {
          "id": "orders"
        }
      ],
      "dimensions": [
        {
          "id": "utm_source"
        }
      ],
      "limit": 10
    }
    ```

    ## API Documentation

    For more information about the Triple Whale API, see:
    - [Blended Stats Table Documentation](https://triplewhale.readme.io/docs/blended-stats-table)
    - [Triple Whale API Reference](https://triplewhale.readme.io/reference/introduction-to-the-triple-whale-api)