Triplewhale MCP Server

🚀 Triple Whale MCP Server

A Multi-Connector Platform (MCP) server that accesses Triple Whale e-commerce analytics data via the Triple Whale API.

🚀 Quick Start

This is an MCP server that accesses Triple Whale e-commerce analytics data through the Triple Whale API. It offers a range of features and tools to help you interact with the data effectively.

✨ Features

• Access blended statistics table data.
• Retrieve shop information.
• Discover available metrics and dimensions.
• Integrate with the MCP Inspector for testing.

📦 Installation

1. Clone this repository.
2. Install dependencies:

   npm install
   

3. Create a .env file and add 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
   

💻 Usage Examples

Testing with the MCP Inspector

To test the server using the MCP Inspector:

npm run inspect

This will open a web interface where you can:

• Test all tools with custom inputs.
• Browse available resources.
• View server logs and responses.

Available Tools

• get_blended_stats: Retrieve Triple Whale's blended statistics data.
• get_shop_info: Get information about the configured shop.
• get_available_metrics: Obtain a list of available metrics for the shop.
• get_available_dimensions: Get a list of available dimensions for the shop.

Available Resources

• triplewhale://shop: Information about the configured shop.
• triplewhale://metrics: A list of available metrics.
• triplewhale://dimensions: A list of available dimensions.

Example Usage - Getting Blended Statistics Data

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

📚 Documentation

For more information about the Triple Whale API, please refer to:

• Blended Stats Table Documentation
• Triple Whale API Reference Documentation