Tagely now speaks MCP: ask your AI assistant about your tracking data
Tagely now has an MCP server. You can connect an AI assistant such as Claude Code or Cursor straight to your Tagely account and ask it about your traffic, campaigns and conversions in plain English. The assistant looks up the answers in your own tracking data.
Until now, getting Tagely data into an AI tool meant downloading a CSV export and uploading it. Exports still work. With MCP, the assistant fetches only the numbers it needs, when it needs them, and always works from your current data.
What is MCP?
MCP, the Model Context Protocol, is an open standard that lets AI assistants use outside data sources. A service publishes a set of tools; an assistant that supports MCP can call those tools while it works on your question.
For Tagely, that means you no longer have to pull reports and paste them into a chat. You ask the question, and the assistant decides which Tagely data to look up to answer it.
What you can ask
A connected assistant can answer the questions you would normally dig through reports for. A few to start with:
-
- “Which UTM campaigns generated conversions last month, and how does that compare with the month before?”
-
- “Compare daily pageviews and conversions this month. Which referral sources changed, and how much of the traffic was bots?”
-
- “Summarize traffic and conversions by device and country. Flag any group too small to draw a conclusion from.”
-
- “Show me the full journey of the last visitor who made a purchase.”
Behind the scenes, the assistant has six read-only tools to work with:
| Tool | What it returns |
|---|---|
get_account |
Your business name, website, timezone, how far back your data goes, and which event types count as conversions |
get_summary |
Page views, unique and new visitors, conversions and conversion rate, with an optional comparison to the previous period |
get_breakdown |
Top values by URL, UTM, referrer, country or device, with visitors and conversions side by side |
list_views |
Individual page views with URL, referrers, UTMs, affiliate and sub IDs, country, device and browser |
list_events |
Individual events such as leads, purchases and subscriptions, with the page they fired on and data like order value |
get_visitor_journey |
Every view and event for one visitor, in time order |
Summaries and breakdowns use the same calculations as the Tagely analytics page, so the numbers your assistant reports match the ones in your dashboard. A good habit: ask the assistant to state the date range and filters it used, and check key totals against your reports before acting on them.
Get set up in three steps
-
- Have the pixel installed. You need a Tagely account with the tracking pixel on your site, so there is data to read. New to Tagely? Start a 14-day free trial.
-
- Generate a token. In your Tagely account, open AI Access (MCP) and choose Generate token. Copy it straight away: it is shown only once.
-
- Add Tagely to your AI tool. Give your assistant the server URL,
https://tagely.com/mcp, and your token.
- Add Tagely to your AI tool. Give your assistant the server URL,
In Claude Code, that is one command:
claude mcp add --transport http tagely https://tagely.com/mcp --header "Authorization: Bearer YOUR_TOKEN"
In Cursor, VS Code and most other MCP clients, add a remote (HTTP) server in settings. The exact file and key names vary a little between tools, but the configuration usually looks like this:
{
"mcpServers": {
"tagely": {
"url": "https://tagely.com/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}
Building your own agent? Any MCP client library that supports the Streamable HTTP transport with custom headers can connect.
One limitation for now: connectors added through the claude.ai or ChatGPT websites sign in through the browser (OAuth) rather than with a token, so they are not supported yet. You can still use those tools with Tagely’s CSV exports.
Read-only, and you stay in control
We built AI access to be safe to switch on:
-
- Read-only. A connected assistant can read reporting data. It cannot change your account or settings, record or delete events, or see billing.
-
- One account per token. No tool accepts an account ID, so a token can never reach anyone else’s data.
-
- No IP addresses. Visitor IP addresses are never returned through MCP. Bots are excluded from visitor and conversion figures unless you ask for them.
-
- Revocable at any time. Generating a new token or revoking access in your account stops the old token immediately. Tagely stores only a fingerprint (hash) of each token, never the token itself.
-
- Separate from your Events API key. Changing one never affects the other.
-
- Rate limited. Each token can make 60 requests per minute.
One thing to keep in mind: whatever an AI tool reads from Tagely is sent to that tool’s provider and handled under their terms. Connect only tools you trust with your analytics data.
Included in your plan
MCP access is included in every Tagely plan at no extra cost, alongside CSV exports. You only need access to an AI tool that supports MCP.
Already a customer? Open AI Access (MCP) in your account, generate a token, and ask your assistant your first question. New to Tagely? Start your 14-day free trial — no credit card required.
For the full tool reference, data notes and troubleshooting, see the Tagely MCP server documentation. For more ideas on what to ask, visit Website data you can explore with AI.