ClickbaseClickbase
Get started

MCP

Introduction

Clickbase ships a built-in MCP (Model Context Protocol) integration that lets AI agents — Claude Code, Claude Desktop, Cursor, VS Code, or any other MCP client — work with your analytics directly. Instead of copying numbers out of the dashboard or scripting the REST API by hand, you can just ask: "What was my conversion rate last week?" or "Create a goal for signups on the pricing page."

What is MCP?

MCP is an open protocol that connects AI assistants to external tools and data sources. An MCP server exposes a set of typed tools an agent can call; the agent decides which tool to call and with what arguments based on your natural-language request.

What your agent can do

Clickbase exposes two MCP servers, split by what they do rather than by a token scope:

  • The Reader server is read-only — analytics, sessions and journeys, events and errors, realtime, people, revenue, Stripe status, Search Console and annotations. Safe to connect to a reporting or Q&A agent.
  • The Writer server mutates data — site CRUD and config, goals and funnels, annotations, tracking toggles, session-replay deletion and the Stripe integration.

Both servers call the exact same server-side Actions and Resources as the dashboard and the REST API, so a number your agent reports is the same number the dashboard shows. See the Connectors page for the full auth and tenancy model.

How it works

  1. Get an API token. Create one from the Developers settings page, or over the API — see API tokens.
  2. Add the server to your client. Point your MCP client at https://clickbase.so/mcp/reader and/or https://clickbase.so/mcp/writer, then complete the OAuth authorization in your browser.
  3. Ask in natural language. "List my sites", "What's my bounce rate this month?", "Create a goal for the checkout page" — your agent picks the right tool.

Connect your client

  • Claude Code — Anthropic's CLI coding assistant.
  • Cursor — AI-powered code editor.
  • VS Code — Visual Studio Code with an MCP-compatible extension.
  • Claude Desktop — Anthropic's desktop chat app.

Once connected, read the Connectors page for the two-server model and authentication details, or jump straight to the Reader tools and Writer tools references.