financeanalytics-data

TripleWhale MCP Server

by triple-whale

TripleWhale MCP Server — use Model Context Protocol to query TripleWhale ecommerce analytics via natural-language conver

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.

github stars

6

Natural language queries for business metricsRequires TripleWhale API key

best for

  • / E-commerce business owners tracking performance
  • / Marketing teams analyzing ad campaign ROI
  • / Analysts creating revenue and profit reports

capabilities

  • / Query net profit and revenue metrics
  • / Analyze advertising ROAS by attribution model
  • / Rank countries by order revenue and user acquisition
  • / Track Meta and other ad platform spending
  • / Generate business performance reports
  • / Access TripleWhale analytics through natural language

what it does

Connects Claude Desktop to TripleWhale's e-commerce analytics platform, enabling natural language queries about profit, revenue, ad performance, and other business metrics.

about

TripleWhale MCP Server is an official MCP server published by triple-whale that provides AI assistants with tools and capabilities via the Model Context Protocol. TripleWhale MCP Server — use Model Context Protocol to query TripleWhale ecommerce analytics via natural-language conver It is categorized under finance, analytics data.

how to install

You can install TripleWhale MCP Server in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

TripleWhale MCP Server is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

Triplewhale MCP Server

npm version npm downloads License: MIT smithery badge

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