API and MCP access

Ask your own AI about your TrueMetriks numbers

Connect Claude Desktop, Claude Code or Cursor to your TrueMetriks data and ask questions in plain language. Or pull your numbers into your own reports with the REST API

Unlimited Included in the free trial

No credit card required. Set up in about 5 minutes

Same numbers, three ways

Your dashboard, the REST API and your AI all read the sales TrueMetriks tracked. Here is the last 30 days of revenue, three ways

The MCP revenue tool returns the same attributed revenue as your dashboard

What your AI can look up: 16 read-only tools

Your AI picks the right tool for your question, runs it on your data and answers in plain words. It can go down to a single ad or a single buyer

ToolWhat your AI can look up
get_overviewVisits, pageviews, unique visitors, bounce rate and visit length
get_channel_breakdownVisits, revenue, ad spend and ROAS per channel, such as Facebook, Google or email, for paid, organic or all traffic
get_campaign_performanceVisits, revenue, spend, ROAS and cost per sale for each campaign
get_ad_breakdownThe same per campaign, ad set or ad, with any custom conversion counted on each row, like booked calls by ad name
get_ad_spendSpend from your connected ad accounts by platform or campaign, in each account's own currency
get_revenue_summaryRevenue, purchases, average order value, conversion rate and customer lifetime value, matching your Revenue page
get_product_performanceRevenue, orders and average order value for each product
get_customer_ltvCustomer lifetime value: the average and median a buyer spends, and how often buyers come back
get_buyer_journeysEach buyer's first and last touch, visits, revenue and days to purchase
get_buyer_detailOne buyer's full timeline by email: every visit and event, with the campaign, ad set and ad it came from
get_time_to_purchaseHow long buyers take from their first visit to their first purchase, average and median
get_event_funnelEvent to event: how many people who did one event later did another, like booked call to purchase, and the hours between
get_funnel_ab_resultsYour saved funnels step by step, with visitors, conversion and revenue for each A/B version
get_traffic_dimensionsYour top 25 pages or referrers
list_event_namesEvery event name your site recorded, with counts, so your AI spells a custom event exactly right
compare_periodsAny of the other lookups for two date ranges, side by side

The channel, campaign and ad tools can credit each sale to its first, last or any touch

The REST API

Seven read-only endpoints at app.truemetriks.com/v1 that return JSON. Send your API key as a bearer token, a site_id, and either a period or a from and to date

EndpointWhat it returns
GET /v1/overviewVisits, unique visitors, pageviews, revenue, leads and purchases, in total and per source
GET /v1/revenueRevenue, purchases and average order value, then per source with its conversion rate, per product and per day
GET /v1/leadsHow many leads, in total and per source
GET /v1/pagesYour top pages with pageviews, unique visitors, time on page and bounce rate, up to 100 pages
GET /v1/productsUnits sold, revenue and average price per product, and each source's top product
GET /v1/usersUnique, new and returning visitors, per source and per country
GET /v1/funnelsYour saved funnels, with visitors and conversion at each step

Periods: today, yesterday, last_7d, last_30d, last_90d or last_365d. An OpenAPI file and an llms.txt for AI assistants live at app.truemetriks.com/api-docs/

Set up in three steps

Connect your AI app once, then ask it anything about your numbers

  1. 1

    Generate a key

    In your website's settings, open Integrations, then MCP (AI access), and click Generate key

  2. 2

    Paste the config

    Copy the config for your AI app into its MCP settings file, or run the one Claude Code command, then restart the app

  3. 3

    Ask a question

    Ask in plain words, like: What is my best campaign by ROAS this month?

Step 1: the MCP (AI access) tile on your website's Integrations tab. Keys for the REST API are on the API Keys tile next to it

Your key is shown once

When you generate it, TrueMetriks shows the key and two ready-made configs, each with a copy button. Lose the key and you generate a new one, which stops the old one

A config for each app

Claude Desktop connects through the mcp-remote bridge, which needs Node.js on your computer. Cursor and other apps that can reach a remote server take the address and a header in their config file. Claude Code adds it with one command

{
  "mcpServers": {
    "tm": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.truemetriks.com/mcp",
               "--header", "Authorization: Bearer YOUR_MCP_KEY"]
    }
  }
}
{
  "mcpServers": {
    "tm": {
      "url": "https://app.truemetriks.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_KEY" }
    }
  }
}
claude mcp add --transport http tm https://app.truemetriks.com/mcp \
  --header "Authorization: Bearer YOUR_MCP_KEY"

Claude Desktop reads claude_desktop_config.json and Cursor reads .cursor/mcp.json. Run the Claude Code command in your project folder

Read-only, and yours to revoke

It reads, it never writes

Your AI can read your analytics. It cannot change a setting, edit data or spend money

One website per MCP key

An MCP key reads the one website it was made for. Your AI cannot ask it for another website

Made by an owner or admin

Only a workspace owner or admin can generate the MCP key. It stops working if that person leaves the workspace or loses the owner or admin role

Shown once, stored hashed

You see a key once, when you make it. TrueMetriks keeps only a hash of it, so nobody can look it up later, us included

Revoke any time

Revoke the MCP key and any AI app using it loses access right away. Each API key can be deleted on its own

Your AI, your subscription

Your AI app runs on your own AI subscription. TrueMetriks charges nothing per message

Limits

Request limits count per key

Limits per keyUnlimited plan and free trial
REST API requests200 a minute
REST API date rangeUp to 366 days per request
REST API answersCached for 60 seconds. Send Cache-Control: no-cache for a fresh one
MCP requests30 a minute and 2,000 a day
MCP requests at once3
MCP date rangeUp to 180 days per lookup

What it does not do

  • No data goes in. The API and MCP only read. To send sales and leads into TrueMetriks, use webhooks
  • The REST API returns summaries. It has no raw event export and no per-person lists, and no campaign, ad or ad spend numbers. Ad-level, spend and buyer questions are for MCP
  • MCP needs an app that sends a key in a header. It does not work as a Claude.ai web or ChatGPT connector, or in an MCP app that runs inside a web page
  • One MCP key per workspace. It reads one website. Generating a new key stops the old one
  • Your AI can see named buyers. The buyer timeline tool returns one buyer's visits and events when your AI asks for them by email, so keep the key as safe as a password

Questions

Which plan includes it?

API and MCP are on the Unlimited plan, and included in the free trial. On a lower plan your keys stop answering, and the same keys work again when you move back to Unlimited

Which AI apps work?

Claude Desktop, Claude Code and Cursor, with the ready-made configs TrueMetriks shows you. Another MCP app can work too if it connects to a remote server and sends your key in a header. It does not work as a Claude.ai web or ChatGPT connector

Can the AI change anything?

No. Your AI can read your analytics. It cannot change a setting, edit data or spend money

Does it cost per question?

No. Your AI app runs on your own AI subscription or tokens, and TrueMetriks charges nothing per message

API or MCP, which one?

Use MCP to ask questions in your AI app, with no code. Use the REST API to build something: a scheduled report, a sheet that refreshes itself or your own dashboard

Related features

Ask your numbers a question

Start a free trial, generate a key and ask your own AI what is working

No credit card required. Set up in about 5 minutes