Traculo MCP server
Ask your AI assistant about your Traculo numbers. The Traculo MCP server lets Claude, ChatGPT, Codex, Cursor and other assistants read your traffic, sources, events and alerts, and add a note to your charts when you ask them to.
What you can ask
- “How many visitors did my website get last week, and where did they come from?”
- “Which pages brought the most visitors in the last 28 days?”
- “Show me the latest purchase events with their values.”
- “Are there any open traffic or tracking alerts?”
- “Add a note on Tuesday that the spring campaign started.”
How to connect
The server address is https://api.traculo.com/mcp (Streamable HTTP). Sign in with your Traculo account, or use an API token.
- In Traculo, open Settings > AI assistants and pick your assistant. The page shows a prompt to paste, or the steps to click through.
- Your assistant opens Traculo in the browser. Sign in and click Allow. No token has to be pasted into a chat.
- Ask a question. The assistant starts by listing your websites.
In Claude Code it is one command:
claude mcp add --transport http --scope user traculo https://api.traculo.com/mcpIf your assistant cannot sign in, create a token under Account settings > API tokens and send it as a Bearer token. A Read only token is enough to read.
What the tools do
| Tool | What it does |
|---|---|
| list_websites | The websites the connection can use. Start here. |
| get_overview | Visitors, visits, page views and the other headline numbers for a period. |
| get_breakdown | The top rows of one breakdown: pages, sources, countries and more. |
| get_realtime | The visitors of the last 30 minutes. |
| list_events | The latest tracked events, newest first, filtered by name and dates. |
| list_alerts | Unusual changes in traffic or tracking, with the likely cause and how to fix it. |
| list_annotations | The notes on your charts: launches, campaigns, incidents. |
| add_annotation | Adds a note on a day. Only works when the connection is allowed to change things. |
You stay in control
- A connection only sees the websites you allow, and only does what its scope allows.
- Adding a note is the only thing that changes data. It needs a connection that can write, and the assistant is told to ask you first.
- You can remove a connection at any time by revoking its token under Account settings > API tokens.
For developers
- Listed in the official MCP Registry as
com.traculo/traculo. - The MCP server card describes the server for agents.
- Prefer plain HTTP? The read API has an OpenAPI description.