Assistants (MCP)
Let an AI assistant answer questions from your project's data. It can read, and nothing else.
The API includes an MCP server, so an assistant such as Claude Code can search events, count them, run funnels and look people up while it works with you.
Connect
Create a read key under Setup, then add the server to your assistant. In Claude Code:
claude mcp add --transport http events https://api.snekot.co/mcp --header "Authorization: Bearer YOUR_READ_KEY"
Any client that speaks MCP over HTTP works the same way: the address is https://api.snekot.co/mcp, and the key goes in the Authorization header. One key is one connection to one project.
Then ask in your own words. “What failed in checkout today?” “How many people got from signing up to paying this month?” “Who is the busiest user this week?”
The tools
Every tool only reads.
| Tool | Answers |
|---|---|
project_info |
The project’s name, plan, and events used this month. |
list_channels |
Every channel, with counts. |
search_events |
Events by channel, name, user, time or free text. |
get_insights |
The single numbers your product sets. |
count_events |
An event per day over a range, against the period before. |
funnel |
How many people get from each step to the next. |
retention |
Cohorts by when people first came, and how many came back each week after. |
top_values |
The most frequent events, channels, people, or values of a tag. |
traffic_sources |
Visitors, where they came from, and what they used. |
experiment_results |
Each A/B test’s variants, and whether one is really ahead. |
find_people |
People, by id or any property. |
get_person |
One person and their latest events. |
What it cannot do
- It cannot write. A read key cannot post events, change insights or delete anything, whatever the assistant is asked to do.
- It sees what the key sees. A key limited to some channels shows only those.
- It treats your data as data. Event names and descriptions are written by your product and sometimes by its users. Every result opens with a line telling the assistant that the rows are records, not instructions.
To cut an assistant off, delete its key.
Next Limits and errors