Skip to Content
Dashboard FeaturesMCP Server

MCP Server

Betterlytics exposes your analytics data through a Model Context Protocol (MCP)  server. This lets you ask AI agents about your website’s traffic in natural language — and connect real analytics data to your UI, UX, and code to make data-driven optimizations directly from your development workflow. No dashboards or manual queries needed.

Creating an API Token

  1. Navigate to Dashboard > Settings > MCP
  2. Enter a name for your token (e.g. “Claude Desktop”)
  3. Click Create token
  4. Copy the token immediately, it is only shown once

Setup

Claude Desktop

Go to Settings > Connectors, add a new connector with the following URL and your authorization token:

https://betterlytics.io/api/mcp

Claude Code

claude mcp add betterlytics https://betterlytics.io/api/mcp \
  --transport http \
  --header "Authorization: Bearer btl_your_token_here"

Cursor

Add to .cursor/mcp.json in your project directory:

{
  "mcpServers": {
    "betterlytics": {
      "url": "https://betterlytics.io/api/mcp",
      "headers": {
        "Authorization": "Bearer btl_your_token_here"
      }
    }
  }
}

Windsurf

Add to your MCP config  (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "betterlytics": {
      "serverUrl": "https://betterlytics.io/api/mcp",
      "headers": {
        "Authorization": "Bearer btl_your_token_here"
      }
    }
  }
}

Antigravity

Add to your MCP config  (~/.gemini/antigravity/mcp_config.json):

{
  "mcpServers": {
    "betterlytics": {
      "serverUrl": "https://betterlytics.io/api/mcp",
      "headers": {
        "Authorization": "Bearer btl_your_token_here"
      }
    }
  }
}

Codex

Add to ~/.codex/config.toml:

[mcp_servers.betterlytics]
url = "https://betterlytics.io/api/mcp"
http_headers = { "Authorization" = "Bearer btl_your_token_here" }

Replace btl_your_token_here with the token you copied in all examples above.

What You Can Ask About

Once connected, your AI assistant has access to your analytics data. You can query it conversationally, or let your agent use it to inform UI, UX, and code changes. Here are some of the things you can explore:

  • Traffic overview: visitors, sessions, and pageviews over any time period
  • Page performance: top pages, specific URL analysis, scroll depth
  • Devices and browsers: desktop vs mobile vs tablet, browser breakdown
  • Geographic distribution: visitor counts by country
  • Traffic sources: where your visitors are coming from (search, social, direct, referrers)
  • UTM campaign tracking: analyze traffic by source, medium, campaign, term, and content
  • Custom events: track and analyze custom events you’ve set up
  • Trends over time: daily or hourly breakdowns to spot patterns
  • Funnels: list saved funnels with step-by-step conversion data, or run ad-hoc funnel analyses with custom steps
  • User journeys: analyze navigation paths through your site, showing page-to-page transitions with traffic volumes

Example Questions

Here are some questions you can try:

Traffic analysis

  • “Compare my daily visitors this week vs last week. Is traffic trending up or down?”
  • “What percentage of my traffic comes from search vs social vs direct over the last 90 days?”
  • “Which countries had the most visitors this month, and what devices do they use?”

Content performance

  • “Which pages have the highest pageviews but lowest scroll depth? I might need to improve them.”
  • “Show me the top 10 landing pages by sessions, broken down by traffic source.”
  • “What’s the average scroll depth on my blog posts vs my product pages?”

Conversion and events

  • “How many cart-checkout events happened on mobile vs desktop this month?”
  • “What’s my product-clicked to cart-checkout ratio, and is it better on desktop or mobile?”
  • “Show me a daily trend of custom events for the past 28 days, any spikes?”

Campaign attribution

  • “Break down visitors by UTM campaign for Q1. Which campaigns drove the most traffic?”
  • “How did traffic from my spring-sale UTM campaign perform compared to organic search?”

Funnels

  • “How did my funnels perform last month?”
  • “What’s my signup conversion rate? Show me the drop-off at each step.”
  • “Run a funnel from /pricing to /signup to /dashboard — how many visitors make it through?”

User journeys

  • “What are the most common navigation paths on my site?”
  • “Show me user journeys from last month — where do visitors go after the landing page?”
  • “What pages do visitors explore after viewing the demo?”

Cross-dimensional

  • “What browsers do my mobile visitors from Germany use?”
  • “Show me the hourly traffic pattern for today. When is my peak hour?”
  • “Which referrer sources bring visitors that scroll the deepest on my pages?”

Managing Tokens

View and manage your tokens from Dashboard > Settings > MCP. Each token shows its creation date and when it was last used. You can delete tokens at any time. Deleted tokens are immediately revoked.

Security

  • Each token is scoped to a single dashboard
  • Requests are rate-limited to 60 per minute per site

Questions? Join our Discord community  for help!

Metrics GlossaryPricing Overview