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.