# TraceLog

> TraceLog is a freemium MCP server for analytics and data. Read-only conversion analytics for your own assistant, with a rerun link per answer. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $39 a month
- **Platforms:** Web, API
- **Website:** https://tracelog.io/en/docs/assistant/
- **MCP Registry name:** io.tracelog/assistant
- **Categories:** analytics and data, marketing and SEO
- **Listing updated:** 2026-11-16

## About

The principle on the docs page is that the assistant explains and TraceLog computes. Your assistant picks a query, TraceLog runs it, and every number in the answer comes from that run. TraceLog receives only the composed query, never what you typed, and each result includes a link that reopens the same query in its Analytics view.

The server has a single tool, run_semantic_query. A query asks for one metric, such as sessions, conversions, conversion_rate, step_rate, value or lead_time, over a range of calendar days in the project's time zone. It can cut by one dimension of a session's origin, filter to one value, compare with another period, or return day, week, weekday or hour breakdowns over at most 371 days.

Access uses a read-only key scoped to one project, created under Settings, Assistant and API, shown once and revocable immediately. Plan limits come back as an explained answer, not an error. For example, on Free, cutting by channel returns a refusal saying that dimension is included in Pro. Claude Code, Cursor and Claude Desktop are supported; the claude.ai and ChatGPT web connectors are not yet.

## Features

- **Single semantic tool:** run_semantic_query handles all metric, filter and comparison requests.
- **Read-only project key:** The key reads one project and cannot send events or change settings.
- **Rerun links:** Every answer links to the same query in TraceLog Analytics.
- **Explained limits:** Plan limits return a reason and sentence instead of an error.
- **Period comparison:** Compare a period with another, or break results out by day, week or hour.
- **Declared conversions:** The tool description lists the conversions and steps the project declares.

## Good for

- Ask which channel converted best last week
- Compare conversion rate before and after a site change
- Check whether a stopped conversion step recovered
- Pull weekday or hourly session patterns into a chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http assistant https://api.tracelog.io/v1/assistant/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.tracelog.io/v1/assistant/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "assistant": {
      "url": "https://api.tracelog.io/v1/assistant/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "assistant": {
      "type": "http",
      "url": "https://api.tracelog.io/v1/assistant/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "assistant": {
      "serverUrl": "https://api.tracelog.io/v1/assistant/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "assistant": {
      "type": "http",
      "url": "https://api.tracelog.io/v1/assistant/mcp"
    }
  }
}
```

## Tools

- `run_semantic_query`: Run one validated, read-only metric query over a period, with optional cut, filter, comparison or time breakdown.

## FAQ

### How do I authenticate?

With a read-only assistant key from Settings, sent as a Bearer header.

### Can the assistant change my data?

No. The key writes nothing and is limited to one project.

### Do claude.ai or ChatGPT connectors work?

Not yet, because they need OAuth and this endpoint uses a key.

### What does it cost?

Free is 10,000 sessions a month; Pro is 39 euros a month excluding VAT, and Pro opens comparison and segment cuts.

### Is TraceLog free?

TraceLog has a free plan, with paid plans for more usage or features. Paid plans start at $39 a month.

### How do I add TraceLog to Claude Code?

Run this command in your terminal: claude mcp add --transport http assistant https://api.tracelog.io/v1/assistant/mcp

### What are the best alternatives to TraceLog?

The closest alternatives to TraceLog are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/tracelog
