TripleWhale MCP Server

Official

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Triplewhale MCP Server

Model Context Protocol (MCP) is a new, standardized protocol for managing context between large language models (LLMs) and external systems. In this repository, we provide an installer as well as an MCP Server for Triplewhale.

This lets you use Claude Desktop, or any MCP Client, to use natural language to accomplish things with Triplewhale, e.g.:

  • Was my net profit positive last month?.
  • Rank countries by order revenue and new users for the last quarter..
  • Give me ads ROAS over the last 7 days and break it out by attribution model?

Claude Setup

Installing via Smithery

To install Triplewhale MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install triplewhale --client claude

Requirements

  • Node.js >= v18.0.0
  • Claude Desktop
  • Triplewhale API key - you can generate one through the Triplewhale console. Learn more or click here for quick access.

How to use locally

  1. Run npx -y @triplewhale/mcp-server-triplewhale init $TRIPLEWHALE_API_KEY
  2. Restart Claude Desktop
  3. You should now be able to try a simple command such as what's my meta spend in the last 7 days?

Supported Tools

  • moby

Development with Claude Desktop

npm install npm run build npm run watch # You can keep this open. node dist/index.js init $TRIPLEWHALE_API_KEY

Then, restart Claude each time you want to test changes.

Testing

To run the tests you need to setup the .env file according to the .env.example file.

npm run test
-
security - not tested
A
license - permissive license
-
quality - not tested

An implementation of Model Context Protocol (MCP) that allows users to interact with TripleWhale's e-commerce analytics platform using natural language queries through Claude Desktop.

  1. Claude Setup
    1. Installing via Smithery
      1. Requirements
        1. How to use locally
          1. Supported Tools
            1. Development with Claude Desktop
            2. Testing