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