Skip to content

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

ToolWhat it does
list_sitesLists the sites the key reaches, with their domains and time zones
get_statsVisitors, 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_breakdownRanks pages, entry and exit pages, sources, campaigns, countries, devices, browsers, operating systems, events, or custom properties
get_live_visitorsVisitors in the last five minutes
list_goals, get_goal_statsThe site's goals, and each goal's visits, total, and conversion rate over a range
list_funnels, get_funnel_statsThe site's funnels, and how many visitors completed each step, with the drop between steps
create_goal, delete_goalAdds or deletes a goal. "Read and change" keys only
create_funnel, delete_funnelAdds 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:

PlanAPI keysCalls an hourAt onceCalls a month
Free16021,000
Starter5600525,000
Growth251,2005100,000
Scale1002,40010300,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.