Betterlytics
Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http betterlytics 'https://betterlytics.io/api/mcp' --header 'Authorization: <Bearer token created in Dashboard > Settings > MCP. Enter the full value including the scheme, e.g. '\''Bearer btl_...'\''>'{
"mcpServers": {
"betterlytics": {
"type": "http",
"url": "https://betterlytics.io/api/mcp",
"headers": {
"Authorization": "<Bearer token created in Dashboard > Settings > MCP. Enter the full value including the scheme, e.g. 'Bearer btl_...'>"
}
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
Web analytics, session replay, error tracking, Core Web Vitals and uptime monitoring in one open-source tool
Website | Demo | Docs | Features | Contribute
Why Betterlytics?
Most teams piece together how their website is doing from four or five tools: one for traffic, one for session replay, one for errors, one for uptime and one for performance. Betterlytics puts all of it in one dashboard, on one data model and one bill. It runs without cookies, is hosted in the EU or on your own servers, and never shares data with third parties. It is built on Rust and ClickHouse and open source under AGPL-3.0.
Want to see it in action? Explore the live demo.
Features
| Category | Features |
|---|---|
| Core Analytics | Page views, visitors, bounce rate, traffic sources, geographic insights, device analytics, real-time data, custom events |
| Advanced Analytics | Session replay, user journeys, funnels, time period comparisons, annotations, outbound link tracking |
| Performance Monitoring | Core Web Vitals (LCP, INP, CLS, TTFB), uptime monitoring, SSL certificate monitoring, public status pages with custom domain support |
| Error Tracking | Client-side errors captured and grouped automatically, with stack traces and links to the session replay |
| Privacy & Compliance | Cookieless tracking, GDPR/CCPA/PECR ready, EU hosting, data anonymization, open source |
| Access & Security | Role-based access control, two-factor authentication, OAuth (Google, GitHub) |
| Developer Experience | Simple script tag, framework SDKs (React, Next.js), self-hosting option, ~3.5KB payload |
| AI Agents | Built-in MCP server, so Claude, Codex or any MCP client can query your traffic, funnels, errors and uptime |
Getting Started
Betterlytics can be used as a managed cloud service or self-hosted on your own infrastructure.
| Cloud | Self-Hosted | |
|---|---|---|
| Get started free | Setup guide | |
| Setup | Instant, ready in 30 seconds | Manual installation via Docker |
| Infrastructure | Managed by us (EU-based) | Managed by you |
| Updates | Automatic | Manual |
| Data location | EU cloud infrastructure | Your own servers |
| Cost | Free tier available, paid plans to scale | Your infrastructure costs only |
| Support | Included | Community |
Dashboard Preview
Overview
Geography Insights
User Journey Diagram
Events and Live Event Insights
Core Web Vitals
Uptime & SSL Monitoring
... and much more
Ideas & Suggestions
Have an idea for Betterlytics? We'd love to hear it!
- Start a discussion to share ideas or ask questions
- Found a bug? Open an issue
- Want to contribute code? Check out CONTRIBUTING.md
License & Attribution
This project is licensed under the AGPL-3.0 License.
Third-Party Components
Betterlytics includes components from other open source projects. See THIRD-PARTY-LICENSES.md for detailed attribution and license information.
Community
Join our small community of developers and privacy advocates:
- Discord - Get help, share ideas, and connect with other users and developers
- Bluesky - Follow us for updates and announcements
- GitHub Issues - Report bugs and request features
- GitHub Discussions - Ask questions and share feedback
If you find Betterlytics useful, consider giving it a star!
Frequently asked questions
What is Betterlytics?
Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.
How do I install Betterlytics?
It runs as a remote server. In Claude Code: claude mcp add --transport http betterlytics 'https://betterlytics.io/api/mcp' --header 'Authorization: <Bearer token created in Dashboard > Settings > MCP. Enter the full value including the scheme, e.g. '\''Bearer btl_...'\''>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Betterlytics need an API key?
Yes. It expects Authorization, which you set in its configuration.
Is Betterlytics open source?
Yes. Its code is on GitHub under the AGPL-3.0 license.
Who maintains Betterlytics?
It is published by betterlytics. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.