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

       

       TRIPLE_WHALE_API_KEY=your_api_key_here

       TRIPLE_WHALE_SHOP_ID=your_shop_id_here

       

       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

    {
      "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
- Triple Whale API Reference