Connectors

Clickbase exposes its analytics over the Model Context Protocol (MCP) so AI agents can read your data and manage your sites through tools. The connectors are the AI twin of the REST API: they call the exact same server-side Actions and Resources, so a number a tool returns is the same number the dashboard and the REST API return.

Two servers

The read/write split is by server, not by scope:

Server	URL	Purpose
Reader	https://clickbase.so/mcp/reader	Read-only. List sites and their traffic, view a site overview, list goals and funnels. Safe for reporting, analytics and Q&A agents.
Writer	https://clickbase.so/mcp/writer	Mutations. Create sites, update tracking mode and sharing, manage goals and funnels.

A reporting agent connects the Reader; an agent that manages your account connects the Writer.

Authentication

Both servers are protected by OAuth 2.1, advertised via discovery and dynamic client registration (Mcp::oauthRoutes()). laravel/mcp advertises a single mcp:use scope — custom scopes are not used, which is why the read/write separation lives in which server you connect, not in the token's scope.

Tenancy is identical to the REST API: the same team.token binding applies. An OAuth token acts within its bound (or the user's current) team, fails closed with 403 if you leave that team, and can never reach another team's data. See REST Authentication for the full binding rules.

Referencing a site

Every tool that targets a site takes a site parameter that accepts either the site's domain or its id. A site not in your current team fails with a clear, AI-actionable message rather than a raw error.

Connecting

Point your MCP client at a server URL and complete the OAuth flow. A typical client config:

{
  "mcpServers": {
    "clickbase-reader": {
      "url": "https://clickbase.so/mcp/reader"
    },
    "clickbase-writer": {
      "url": "https://clickbase.so/mcp/writer"
    }
  }
}

Connect only the Reader for read-only agents; add the Writer when the agent needs to make changes.

See the full tool reference for each server: Reader tools and Writer tools.