article

README

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

Run npx -y @triplewhale/mcp-server-triplewhale init $TRIPLEWHALE_API_KEY
Restart Claude Desktop
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

mcp-server-triplewhale