Triplewhale MCP Server logo

Triplewhale MCP Server

by Triplewhale

The Triplewhale MCP Server allows you to use natural language with Claude Desktop or any MCP Client to interact with your Triplewhale data. It leverages the Model Context Protocol (MCP) to manage context between LLMs and the Triplewhale platform.

View on GitHub

Last updated: N/A

Triplewhale MCP Server

npm downloads

npm downloads

License: MIT

License: MIT

smithery badge

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