AI Assistant (MCP)
Connect Tugus to your AI assistant (Claude, ChatGPT/Codex, Cursor) and ask your tracking data in chat — including data quality.
Tugus can connect to your AI assistant over MCP (Model Context Protocol). Once connected, you can ask your tracking data in plain language — "How did paid traffic convert last week?", "Compare attribution models for this campaign" — and the assistant fetches the answer live from Tugus.
Access is read-only — the assistant can query your data, but never change anything in your account or ad platforms.
Where to find it
In the dashboard, open AI & MCP in the sidebar. The page shows your personal server address, a Connect button, and ready-to-paste setup for each supported client.
Connect a client
Tugus supports Claude Code, Claude Desktop, Codex, Codex Desktop and Cursor. Pick yours on the page — the exact command is filled in for you.
Open AI & MCP and choose your client
Each client tile shows either a copy-paste command (CLI clients like Claude Code and Codex) or a short manual config (desktop apps).
Connect
- Login (recommended): click Connect and confirm the login in your browser on the first request — no token to copy or store.
- Token: if login isn't enabled yet, Connect creates a read-only access token and inserts it into the command. The token is shown once — copy it right away.
Run the command
Paste the command into your client (transport: HTTP). For example, Claude Code:
claude mcp add --transport http --scope user tugus https://app.tugus.io/mcpYour assistant now lists the Tugus tools and can answer questions about your data.
What the assistant can do
The assistant works across your properties and always respects the same permissions and data limits as the dashboard. Its tools cover:
- Properties & context — list your websites and discover which conversion events and attribution models are valid before querying.
- Metrics — traffic sources, campaign performance, funnels, insights, ad spend & ROAS, and a generic query for any metric × breakdown × time range (including trends and click-IDs by platform).
- Attribution & funnel — compare attribution models, inspect funnels.
- Data quality — consent rate, delivery rate and validation status, so you know how reliable a number is.
- Events & debug — search events and inspect a single event end-to-end.
Every metric answer carries a data-quality note — e.g. a low delivery rate means attributed revenue is a lower bound. The assistant is asked to state this alongside its interpretation.
Guided prompts
Beyond ad-hoc questions, Tugus ships prompt templates — guided workflows your client exposes as slash commands (e.g. a weekly performance review or a budget-decision helper). They appear automatically once connected.
Manage access
On the same page you can see and revoke your access tokens, or disconnect connected clients at any time — access is cut immediately.
Prefer to pull data into your own tools instead of a chat assistant? The same metrics are available through the Analytics API.