SkillFoxx

Betterlytics MCP

The Betterlytics web analytics MCP server: an agent reads traffic, funnels, JavaScript errors and uptime monitor state.

  • 180 ★ on the repository
  • Last commit
MCP serverOfficial

Extended access

Why this level

  • The token opens read access to visitor, page and error data of your site.
  • Agent queries go to the Betterlytics cloud or to your instance.
All reasons and checks

betterlytics/betterlyticsAuthor:Betterlytics

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/betterlytics-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The token opens read access to visitor, page and error data of your site.
  • Agent queries go to the Betterlytics cloud or to your instance.

This is third-party code. Review the repository files before installing.

What it does

Betterlytics is open-source cookieless web analytics with session replay, error tracking, Core Web Vitals and uptime monitoring. It has a built-in MCP server at `/api/mcp` of the cloud `https://betterlytics.io` and of any self-hosted instance. Access uses a personal token with the `btl_` prefix created in the MCP settings of the dashboard, or OAuth when it is enabled on the instance. Tools: `query` and `query_sessions` return metrics and session breakdowns (bounce rate, visit duration, entry and exit pages), `user_journeys` builds paths between pages, `funnel_preview` and `list_funnels` compute funnels, `list_errors` and `get_error` break down JavaScript errors with stack and event trail, `list_monitors`, `list_monitor_incidents` and `list_status_pages` show monitors and incidents, `list_global_properties` lists global properties. Before querying, the agent calls `describe` to learn the available metrics and filters.

Who it is for. Site owners, product managers and developers who use Betterlytics and want to ask the analytics questions in plain words through an agent.

Good fit when

  • Ask an agent which pages users leave most often over the last week.
  • Break down a JavaScript error: stack, browser and the event trail before the failure.
  • Build a funnel by steps, for example from the pricing page to checkout.
  • Assemble a weekly report on traffic, errors and uptime in one request.

Not a fit when

  • Changes to Betterlytics settings or data are needed: the tools only read.
  • Analytics lives in another service: the server connects to Betterlytics only.
  • There is no token and OAuth is off on the instance: access will not open.

Example request

Using Betterlytics, show the top pages by bounce rate for the last seven days and the JavaScript errors that hit the most sessions.

MCP

Transport
http
Authentication
API key

Limitations

Each token is tied to a site dashboard. Request rate limits apply. OAuth is enabled separately on an instance, and the same `/api/mcp` path serves the cloud and self-hosted setups. For a server on `localhost` over http, clients like mcp-remote need `--allow-http`. The project license is AGPL-3.0. Each token gives access to one site, so several sites need separate tokens. The tools are meant for data queries and do not replace the dashboard for tracking setup, and `describe` shows only the available metrics and filters.

How to disable. Remove the betterlytics entry from the client configuration and revoke the token on the MCP settings page of the dashboard.

FAQ

Where do I get the MCP token?

In the MCP settings of the site dashboard, where a personal token with the `btl_` prefix is created. On instances with OAuth enabled, sign-in happens in the browser.

Does it work with a self-hosted Betterlytics?

Yes, the address comes from your instance: `https://your-host/api/mcp`.

Which clients does the documentation cover?

Claude, Claude Code, Cursor, VS Code, Windsurf and Codex.

Can the agent change analytics data?

No, the tools return data and write nothing.

Which license does Betterlytics use?

AGPL-3.0. The cloud version is EU-hosted and a self-hosted instance is deployed by you.

Discussion

No questions or reviews yet.

MCP servers
Official

HitKeep is open source cookieless web analytics in one binary with a read-only MCP server that gives assistants aggregate data.

MCP serverExtended access106
Official

Humblytics MCP gives an agent live site analytics, funnels and A/B tests plus 12 marketing skills for finding conversion problems.

MCP serverExtended access85

An MCP server with SEO data: backlinks, keyword difficulty and traffic estimates from the free Ahrefs tools

MCP serverBroad access193

MCP Yandex Metrica with counter management

@theyahia/yandex-metrika-mcp

Russian stack

Yandex Metrica MCP server with 15 tools: reports and traffic plus creating, editing, and deleting counters and goals

MCP serverBroad access1
Needs a VPN

An MCP server for Google PageSpeed Insights and Chrome UX Report data: page audits, release comparison and a fix plan.

MCP serverMinimal access80
Official

crawlseo MCP compares the latest 28 days of site metrics with the preceding 28 days, alongside results from the latest crawl.

MCP serverExtended access694

README in short

The README describes Betterlytics: features (cookieless analytics, session replay, errors, Core Web Vitals, monitoring) and the cloud and self-hosted install options. MCP is mentioned as a built-in feature and connection details are on a documentation page.

README badge

Report a problem