MCP server

Plaintrace is a remote MCP server at https://app.plaintrace.dev/mcp (Streamable HTTP, stateless, JSON responses). Your assistant gets a read key bound to one site; we run no model ourselves.

Connect

Create the key under Settings → AI assistant: the dashboard puts it straight into these snippets.

claude mcp add --transport http plaintrace https://app.plaintrace.dev/mcp \
  --header "Authorization: Bearer sk_live_…"

{
  "mcpServers": {
    "plaintrace": {
      "url": "https://app.plaintrace.dev/mcp",
      "headers": { "Authorization": "Bearer sk_live_…" }
    }
  }
}

{
  "servers": {
    "plaintrace": {
      "type": "http",
      "url": "https://app.plaintrace.dev/mcp",
      "headers": { "Authorization": "Bearer sk_live_…" }
    }
  }
}

Tools

Tool	Returns
`overview`	Visitors, visits, page views, conversions, bounce, engaged time, and the change against the previous period
`timeseries`	Per hour or per day (`interval`)
`breakdown`	Top items of a `dimension`: page, source, channel, country, device, event, utm_source, utm_medium, utm_campaign (`limit` ≤ 50)
`trust_report`	The grade, traffic mix, measured loss, refusals and the formula
`what_changed`	Ranked findings; `compare`: previous or last_year
`revenue`	Net revenue per currency, by channel and by day (needs Stripe)
`crawlers`	Crawler reads by class and crawler
`heatmap_pages`	Pages by clicks, rage and dead clicks (needs heatmaps on)

Every tool takes a period (today, yesterday, last_7_days, last_30_days, this_month, last_month; whole days in your site’s time zone) or from and to in ISO 8601, an optional timezone, and the filters page, source, country and device.

Answers

Each answer has a short text summary, the same data as structured JSON, and a trust object with the grade, the score and any warnings (a D grade, fewer than 30 visits, loss not measured). Only totals: no visitor-level rows, single events, visit or payment ids.

Limits and errors

60 requests a minute per key, shared with the REST API; what_changed counts as ten. Over the limit, the tool answers with how many seconds to wait.
One JSON-RPC message per request; batches are refused.
Clear errors for an unknown or revoked key (401), a key without read (403), Stripe not connected, heatmaps off, and an invalid period (with an example of a valid one).
Session cookies are never accepted: an assistant holds a key you can see and revoke.