AI agents

Let Cursor, Claude Code, Codex, or another MCP-compatible agent inspect and manage Kobbe.

Limit dangerous permissions

Only give danger:write to agents you fully trust. That scope can delete sites or reset analytics data.

Kobbe exposes a scoped API for local AI agents. Use it when you want Cursor, Claude Code, Codex, or another MCP-compatible tool to inspect analytics, check setup health, or manage sites.

Agent access uses the same @kobbe/cli package as the CLI, but runs it in MCP server mode.

Cursor Marketplace

The fastest way to use Kobbe in Cursor is the official plugin:

Open Customize in Cursor
Search for Kobbe
Install the plugin
Open Plugins → Configure and paste your kbpat_ API token

Plugin repository: github.com/michael-andreuzza/kobbe-cursor-plugin

The plugin includes focused commands such as /kobbe-overview, /kobbe-revenue, /kobbe-health, and /kobbe-next-actions.

Manual MCP setup

Use manual MCP setup if you are not using the Cursor plugin, or if you use another MCP-compatible client.

Create a token

Open profile menu → Agent access (or go to app.kobbe.io/settings/agent-access)
Copy the token immediately (shown once)
Workspace owners and managers only

Agent access is included on every plan.

kobbe login --token kbpat_YOUR_TOKEN

Or provide the token through the KOBBE_TOKEN environment variable.

MCP mode

Run Kobbe in MCP server mode directly, or use one of the client examples below:

kobbe mcp

Available tools

MCP tools include:

Tool	What it does
`list_sites`	List sites the token can access.
`get_overview`	Read headline traffic KPIs for one site.
`get_revenue`	Read revenue totals and attribution health for one site.
`get_top_pages`	Inspect top pages for a site and time range.
`get_sources`	Inspect referrers, channels, and source breakdowns.
`get_setup_health`	Check whether tracking and optional features are configured correctly.
`get_next_actions`	Ask Kobbe for suggested follow-up work.
`create_site`	Create a new site when the token has write access.
`update_site`	Update site details when the token has write access.
`rotate_site_token`	Rotate a site tracker token.
`delete_site`	Delete a site with dangerous write access and confirmation.
`reset_site_stats`	Reset analytics data with dangerous write access and confirmation.

Token scopes

API tokens are workspace-scoped and can be revoked any time from profile menu → Agent access.

Scopes:

Scope	Allows
`sites:read`	List and inspect sites.
`analytics:read`	Read overview, pages, sources, setup health, and next actions.
`sites:write`	Create or update sites.
`tokens:write`	Rotate tracker tokens.
`danger:write`	Delete sites or reset analytics data.

Safety notes

Kobbe API tokens are management credentials. Treat them like passwords.

Store tokens in your local environment or the kobbe login config, not in source control.
Revoke tokens when an agent, machine, or project no longer needs access.
Use the smallest scope set that works.
Destructive actions still require typed confirmation, even when the token has danger:write.
Site tracker tokens are separate from API tokens. A tracker token can send analytics events, but it cannot manage a workspace.

Good prompts

“What changed on my site today?”
“Which page should I improve next?”
“List my sites and tell me which one needs setup.”
“Rotate the tracker token for this test site.”

For destructive actions, include the exact confirmation only after you have reviewed the agent’s proposed action.

MCP client examples

Pick the client you use. For Cursor, install the Marketplace plugin first. Manual examples assume you already ran kobbe login or set KOBBE_TOKEN.

# Recommended for Cursor
1. Open Customize in Cursor
2. Search for "Kobbe"
3. Install the plugin
4. Open Plugins → Configure
5. Paste your kbpat_ API token

Plugin repo:
https://github.com/michael-andreuzza/kobbe-cursor-plugin

{
  "mcpServers": {
    "kobbe": {
      "command": "npx",
      "args": ["-y", "@kobbe/cli@latest", "mcp"],
      "env": {
        "KOBBE_TOKEN": "kbpat_YOUR_TOKEN"
      }
    }
  }
}

{
  "servers": {
    "kobbe": {
      "command": "npx",
      "args": ["-y", "@kobbe/cli@latest", "mcp"]
    }
  }
}

{
  "mcpServers": {
    "kobbe": {
      "command": "npx",
      "args": ["-y", "@kobbe/cli@latest", "mcp"]
    }
  }
}

{
  "mcpServers": {
    "kobbe": {
      "command": "npx",
      "args": ["-y", "@kobbe/cli@latest", "mcp"]
    }
  }
}

[mcp_servers.kobbe]
command = "npx"
args = ["-y", "@kobbe/cli@latest", "mcp"]