# Triple Whale: how to read it into Maplith

*Ads · also known as TripleWhale · last checked 2026-10-27 · recipe `maplith://systems/triplewhale`*

Marketing totals by period and channel. The hosted connection is held pending verification with a real account.

## Best path

**Recommended: export files.** Export aggregate measures while the hosted connection is verified. No account contract has been inspected yet.

Try the paths in this order (ADR-0031):

1. **Your agent fetches it**, with the access your human already gave you. No named client connector confirmed: check the tools you already have. If your agent already has access, ask for period and channel totals only, never individual orders or customer rows.
2. **Maplith reads an MCP server your human already has.** Official: **Triple Whale hosted MCP**. Endpoint to connect to: `https://mcp.triplewhale.com`. Documentation (a page to read, not an address to connect to): https://mcp.triplewhale.com. Access: An MCP Read API key sent as x-api-key, never pasted into chat. The first connection lists the offered tools for review. No tool is called until its aggregate read plan is verified. Maplith cannot read this server: it offers tools or a personal sign-in to an agent, not resources Maplith reads. Maplith reads only a server that serves MCP resources and takes a token a person types under Data sources › Systems in the Maplith app, such as the customer-run template for a database (ADR-0028). Your human can connect this server to you instead, as path 1.
3. **Export files**, the fallback that always works: see *Export steps* below.

## Datasets that make a good map

| Dataset | One row is | Key columns | Joins to |
|---|---|---|---|
| Blended measures | One aggregate marketing measure across channels for one period, if offered by the verified read plan. | period, metric, value | Other aggregate measures by the same period; never individual orders or customers. |
| Channel measures | One aggregate measure for one channel and period, if offered by the verified read plan. | period, metric, value, channel | Other aggregate measures by the same period; never individual orders or customers. |
| Attribution measures | One aggregate attribution measure for one period and model, if offered by the verified read plan. | period, metric, value, channel | Other aggregate measures by the same period; never individual orders or customers. |

Columns are named, never their values. Maplith tries to mask personal data such as email addresses, but that is best effort: your human decides what goes in.

## Read-only access

**Who usually has the rights:** A person allowed to create an MCP Read API key.

**For the key your own agent's client uses, choose only these read permissions:** `MCP Read API key`

**Where to click:**

1. Create a read-only MCP API key in Triple Whale.
2. Keep the key out of chat.
3. Wait for connection verification before scanning.

A key or token made here stays in the tool that reads the system for your human, never in a chat. Maplith asks for one only under Data sources › Systems in the app, and only for an MCP server it can read.

## Export steps

**Format:** CSV · **Date range:** A bounded past window, normally 90 days.

1. Export the aggregate measures you want to map, grouped by period and channel.
2. Exclude individual orders and customer rows.

## Volume hint

**About Depends on the measures and period chosen. a month** (an estimate). No account inspected; no volume estimate is claimed.

Every row an agent reads passes through its context, about one token per four characters. Above a few thousand rows a dataset, or for a daily refresh, prefer an MCP server or an export over fetching through the chat.

## Always

- Read-only, and never a credential sent to Maplith through the chat.
- The same recent period, a few months, from every system.
- Your human decides what goes in.

## Sources

Written from the vendor's public documentation, last checked 2026-10-27:

- https://mcp.triplewhale.com
- https://www.triplewhale.com/