AI & Tracklution MCP

Tracklution's MCP integration lets you connect AI assistants that supports MCP directly to your Tracklution account. Once connected, you can query your tracking data, check your setup, and get insights in plain language, without opening the dashboard.

This article explains what the MCP integration does, how to connect it, and what you can ask once it's set up.

Video Overview (analytics use-case with Claude)

{height=315 width=560}

What is MCP?

MCP (Model Context Protocol) is an open standard that allows AI assistants to securely connect to external tools and data sources. When you add Tracklution as an MCP server, your AI assistant gains the ability to read your tracking data and interact with your account directly.

Think of it as giving your AI assistant read access to your Tracklution dashboard, so you can ask questions like "how did my site perform last week?" or "which source drove the most signups?" and get a direct answer, without clicking through reports.

Connect Tracklution to your AI assistant

To connect Tracklution as an MCP server, you need the MPC server URL:

• The MCP server URL: https://mcp.tracklution.com/mcp

Connect Tracklution MCP (Claude UI example)

1. Open Claude and go to Customize and select Connectors.
2. Add a new MCP by clicking the plus icon.
3. Click "Add custom connector"
4. Name the connector and enter The MCP server URL https://mcp.tracklution.com/mcp
5. Connect your Tracklution account when prompted by logging in
6. Click "Connect" and return to your conversation.

Install with a single prompt

Drop this into Cursor, Claude Code, Codex, Windsurf, Cline, Lovable, Replit, or Bolt. The agent reads our install protocol, mounts the Tracklution MCP, and finishes the setup.

• The prompt Install Tracklution
• Or the URL-anchored variant if the agent doesn't recognise the brand: Install Tracklution tracking - see https://www.tracklution.com/agent-install.md

What you can ask

Once the MCP is connected, you can ask your AI assistant questions about your tracking data in plain language. Below are the most useful things you can do.

Get a performance snapshot

Ask for a high-level summary of your tracking results over any date range.

Example prompts:

• "How did my website perform last week?"
• "How many events were recorded in May? What was the total value?"
• "What's my event recovery rate for the last 30 days?"

The assistant will return totals including event count, conversion value, email and phone coverage, consent stats, and a breakdown by traffic source.

Break down performance by source or event type

Drill into your data by traffic source, event name, device, browser, or day.

Example prompts:

• "Which traffic source drove the most conversions last month?"
• "Show me a breakdown of all event types tracked this week."
• "Compare Google Ads vs. Facebook performance for purchases in May."
• "How did conversion volume trend day by day last week?"

Filter raw events by ad click ID

Look for events that arrived with a specific platform's click ID, useful for verifying that clicks from a particular ad platform are being tracked correctly.

Example prompts:

• "Show me purchase events from the last 7 days that have a Google Ads click ID."
• "Are there any events from Facebook traffic in the last 3 days?"
• "List recent events that came in with a TikTok click ID."

Supported click ID filters include: Google Ads (gclid), Meta (fbclid), Microsoft (msclkid), LinkedIn (li_fat_id), TikTok (ttclid), Pinterest (epik), Reddit (rdt_cid), and Snapchat (scclid).

Check your containers and connectors

Ask the assistant to list your tracked sites or inspect what's set up on a specific container.

Example prompts:

• "Which Tracklution containers do I have access to?"
• "What events are tracked on website B?"
• "Which ad platform connectors are active on my main container?"

Check your connection status

Verify that the MCP connection is working and your API key is valid.

Example prompts:

• "Is my Tracklution connection working?"
• "Which API key am I connected with, and how many containers can it access?"

Setting up tracking via an AI coding assistant

If you're a developer using an AI coding assistant, the Tracklution MCP also supports guided installation of tracking on a new website. The assistant can:

• Detect your site's platform and framework
• Provision a new Tracklution container
• Generate and apply the correct tracking snippets to your codebase
• Verify that events are being received

This flow is intended for technical users working in a code editor. To start, simply tell your AI assistant that you want to set up Tracklution tracking on your website and provide your site URL.

:::Info The AI-assisted setup flow creates a new container in your Tracklution account. If you already have a container for the site, the assistant will use that instead. :::

Things to keep in mind

Data retention for raw event queries When querying raw events or sessions (as opposed to aggregated reports), data is available for approximately the last 14 days. For longer date ranges, use the performance summary or report breakdowns instead, which pull from pre-aggregated data.

PII is never exposed to AI assistants Personally identifiable information (PII), such as emails and phone numbers, is not accessible through the MCP integration. The assistant can analyze tracking data and setups, but cannot search or reveal individual users.

Date ranges are capped at 30 days All queries, including summaries, reports, and raw event listings, support a maximum date range of 30 days per request.

The assistant reads your data, it does not modify it The MCP integration is read-only for analytics queries. The only actions that modify your account are part of the installation flow (creating a container, selecting an installation method), and these only happen when you explicitly ask the assistant to set up tracking.

Multiple containers If your API key has access to more than one container, the assistant should ask which site you're referring to, else you can specify it in your prompt (e.g. "for website A, website B, etc").

For AI coding agents: Tracklution publishes a step-by-step install contract designed for Cursor, Claude Code, Codex, Windsurf, Cline, Lovable, Replit, and Bolt. Fetch and follow tracklution.com/agent-install.md - or just tell your agent: 'Install Tracklution.'