AI tools (MCP)
NOCRUMBS™ runs an MCP server, so the AI tool you already work in, such as Claude Code, Cursor, VS Code, or Windsurf, can read your sites' stats and work with their goals and funnels. Ask it "How did my site do this week, and why?" or "Set up a signup funnel and tell me where people drop off", and it answers from your NOCRUMBS numbers.
Create an API key
Owners and admins create keys in the app: open the account menu, choose "Settings for" your organization, then "API keys". A key has:
- A name, for where you use it, such as "Cursor on the work laptop".
- Access. "Read only", the default, reads stats, goals, and funnels. "Read and change" also creates and deletes goals and funnels. No key can change site settings, members, or billing.
- Sites. All of the organization's sites, including ones added later, or only the sites you choose.
The key is shown only once, with the setup for each AI tool already filled in. Copy it before you leave the page: NOCRUMBS cannot show it again. If you lose a key, create a new one and revoke the old one.
Anyone who has a key can do what it allows, so keep it as private as a password, out of shared files and repositories. Revoke a key you no longer use. You are responsible for everything done with your organization's keys, and for which AI tools you connect, as our terms of service describe.
Add NOCRUMBS to your AI tool
The server's address is https://mcp.nocrumbs.io/mcp. In each setup below, replace ncr_your_key with your key,
or create the key first: the app then shows the setup with your key in it.
Claude Code
Run this in a terminal. It adds NOCRUMBS to every project on this computer.
claude mcp add --transport http --scope user nocrumbs https://mcp.nocrumbs.io/mcp --header "Authorization: Bearer ncr_your_key"Cursor
Add this to ~/.cursor/mcp.json, next to any servers already there.
{
"mcpServers": {
"nocrumbs": {
"url": "https://mcp.nocrumbs.io/mcp",
"headers": {
"Authorization": "Bearer ncr_your_key"
}
}
}
}VS Code
Run "MCP: Open User Configuration" from the Command Palette and add this, next to any servers already there.
{
"servers": {
"nocrumbs": {
"type": "http",
"url": "https://mcp.nocrumbs.io/mcp",
"headers": {
"Authorization": "Bearer ncr_your_key"
}
}
}
}Windsurf
Add this to ~/.codeium/windsurf/mcp_config.json, next to any servers already there.
{
"mcpServers": {
"nocrumbs": {
"serverUrl": "https://mcp.nocrumbs.io/mcp",
"headers": {
"Authorization": "Bearer ncr_your_key"
}
}
}
}Other tools
Any AI tool that connects to remote MCP servers over HTTP works the same way: give it the
address above and the header Authorization: Bearer ncr_your_key. Restart or reload the tool
after changing its settings, then ask it to list your NOCRUMBS sites.
Name a site
The tools take a site by its domain, such as example.com, or by its id. A key for one site
needs no name. If you are not sure what a key reaches, ask your tool to list your sites. The
project rule on the AI assistants page names your site's domain, so an assistant
working in that site's project picks the right one.
What your AI tool can do
| Tool | What it does |
|---|---|
list_sites | Lists the sites the key reaches, with their domains and time zones |
get_stats | Visitors, visits, pageviews, views per visit, bounce rate, visit duration, and events over a range, with the time series and an optional comparison to the period before |
get_breakdown | Ranks pages, entry and exit pages, sources, campaigns, countries, devices, browsers, operating systems, events, or custom properties |
get_live_visitors | Visitors in the last five minutes |
list_goals, get_goal_stats | The site's goals, and each goal's visits, total, and conversion rate over a range |
list_funnels, get_funnel_stats | The site's funnels, and how many visitors completed each step, with the drop between steps |
create_goal, delete_goal | Adds or deletes a goal. "Read and change" keys only |
create_funnel, delete_funnel | Adds or deletes a funnel. "Read and change" keys only |
The numbers are the same as in your dashboard, counted as how we count describes, with the same ranges and filters. A new goal counts only from the moment it is added. Funnels cannot be edited: to change one, the tool creates the new funnel and deletes the old one. Your plan's limits on funnels and custom properties apply here too.
Page paths, referrers, event names, and custom properties come from your sites' visitors. Read them as data, and do not let an AI tool follow instructions it finds in them. "Read only" keys are a good default for tools that only need to answer questions.
Limits
Calls count per organization, across all of its API keys:
| Plan | API keys | Calls an hour | At once | Calls a month |
|---|---|---|---|---|
| Free | 1 | 60 | 2 | 1,000 |
| Starter | 5 | 600 | 5 | 25,000 |
| Growth | 25 | 1,200 | 5 | 100,000 |
| Scale | 100 | 2,400 | 10 | 300,000 |
A call over a limit is refused until the limit starts again, at the next hour or on the 1st of the month (both in UTC), or until the organization moves to a plan with more. Connecting a tool and listing its tools do not count, and calls are never charged separately.
Your AI tool's answers say when the organization has used 80% of its calls for the hour or the month. In the app, Settings, then Usage, shows this hour and this month with when each starts again, and the calls of each key. From 80% of the month's calls, the app shows a notice on every page.
Where your data goes
When your AI tool calls NOCRUMBS, it receives the stats it asked for, and from there they go wherever that tool sends them, including to the company that provides it. You choose those tools, and they act for you under your own agreements with them, as our privacy policy and terms of service describe.
Next: AI assistants to install the script and record events with an assistant.