An open-source, privacy-first web analytics platform that tracks site visitors, mentions, AI recommendations, and revenue attribution.
Also known as trckable/trckable
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 16, 2026
- License
- AGPL-3.0
What is trckable MCP?
trckable is an open-source, privacy-first web analytics platform that tracks site visitors, mentions, AI recommendations, and revenue attribution.
Summary generated from the project's README
About trckable MCP server
Monitoring website traffic, brand mentions, and revenue attribution is what trckable enables for developers and marketing teams. This privacy-first analytics platform tracks site visitors, identifies where your brand is mentioned on platforms like Hacker News or Product Hunt, and checks if AI models like Claude or ChatGPT are recommending your site. It also connects directly to payment providers to credit sales to specific visitor sessions.
Users can deploy the platform as a single self-hosted container or use the managed cloud version. The system is designed to be lightweight, using a small 2.1 KB script and requiring minimal memory. For those using AI-driven development environments, the built-in MCP server provides read-only access to your analytics data, allowing tools like Cursor or Claude to interact with your site metrics directly. To enable AI recommendation tracking, you must provide an API key for OpenAI, Perplexity, or Anthropic.
What you can do with it
- 1Analyze AI recommendation impactAsk your AI client to determine if ChatGPT or Perplexity are mentioning your site to potential buyers.
- 2Track revenue attributionIdentify which specific website visits resulted in successful sales through your payment processor.
- 3Monitor brand mentionsFind out where your website is being discussed across news sites and blogs.
- 4Integrate analytics into IDEsUse read-only tools within your coding environment to query your website's performance data.
Written from the project's README. Every use case is checked against a quote from it.
How to install trckable MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall trckable MCP in Claude Code
$ claude mcp add trckable -- npx -y trckableInstall trckable MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"trckable": {
"command": "npx",
"args": [
"-y",
"trckable"
]
}
}
}Install trckable MCP in VS Code
.vscode/mcp.json
{
"servers": {
"trckable": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"trckable"
]
}
}
}Install trckable MCP in VS Code CLI
$ code --add-mcp '{"name":"trckable","type":"stdio","command":"npx","args":["-y","trckable"]}'Install trckable MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"trckable": {
"command": "npx",
"args": [
"-y",
"trckable"
]
}
}
}Install trckable MCP in Codex
$ codex mcp add trckable -- npx -y trckableInstall trckable MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.trckable] command = "npx" args = ["-y", "trckable"]
Install trckable MCP in Gemini CLI
$ gemini mcp add -s user trckable npx -- -y trckableInstall trckable MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"trckable": {
"command": "npx",
"args": [
"-y",
"trckable"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachabletrckable/trckable is public and reachablegithub.com/trckable/trckable ↗Pass
- Package names this repository as its sourcetrckable names trckable/trckable as sourcenpmjs.com/package/trckable ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for trckablenpmjs.com/package/trckable/v/0.8.0#provenance ↗Pass
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/trckable/trckable ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from trckablePass
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubtrckable
The only analytics you need. Private, free and open source.
Your day in plain words, who's on your site right now, where people mention you, whether AI recommends you, alerts when something breaks, and revenue from your payment provider: one open-source tool for your whole team. Cookieless, open source (AGPL-3.0) and self-hosted in one container. Self-host it free with every feature, or let trckable Cloud run it.
Website · Live demo · Cloud · Quick start · How it compares · What it does · Gallery · Docs · Changelog
The demo site, recorded from the real dashboard: the comparison, the day under the pointer, Share, the money trail from Search, Full (F) and Replay.
Early preview. Tracking, the dashboard, revenue for all five providers, Full mode, the MCP server and the self-hosting tools are built and tested. Still to come: live sandbox runs against each payment provider, the in-app assistant, and v1.0.
Two ways to use it
Self-host: one container, on your own server. Free and open source (AGPL-3.0), every feature. trckable Cloud: we run it, with updates and backups, after a 14-day free trial. Same product either way, and the same 2 KB script.
Quick start
docker run -d --name trckable -p 8080:8080 -v trckable-data:/data ghcr.io/trckable/trckable
docker logs trckable # a one-time setup link: open it, create your account, add your site
Then add the script tag from Settings → Install to your site's <head>; most sites are set up in under 3 minutes:
<script
defer
data-site="tkb_a1b2c3d4"
data-domain="example.com"
src="https://stats.example.com/js/tkb_a1b2c3d4.js">
</script>
Or npm i trckable for React and Next.js, or the WordPress plugin. The image runs as an unprivileged user and works on x86-64 and arm64; details and upgrades are in the install guide.
Early users wanted
trckable is new, and I'm looking for the first 50 people to run it. If you install it, I'll help you set it up, and I want to hear what's confusing or missing: open a discussion or email hello@trckable.com. If it's useful to you, a ⭐ helps other people find it.
Deploy
Compose, Railway, Coolify, Dokploy, Umbrel and Helm, all the same image with a data volume and a health check: deploy/README.md and the self-hosting docs.
How it compares
The free, self-hostable tools, plus DataFast (paid, hosted only) for script size, all measured the same way. Tables, sources and caveats: How it compares.
Where it is not the right pick: with pageviews only, Plausible CE's script is smaller (1,283 B against 1,651 B). Session replay and A/B tests are out of scope on purpose; if you need those, use Matomo.
What it does
Nothing is paid, limited or held back. The complete list: features.
- Mentions. See where your site is talked about (Hacker News, the news and blogs, Product Hunt) and the visitors each mention brought: mentions. A self-hosted server sends your site's address and the words you add to Algolia, Google News and GDELT to search, nothing about your visitors; it is off until
TRCKABLE_MENTIONS=on. - Answers. Whether ChatGPT, Perplexity and Claude name you for your buyers' questions, and the visitors and revenue the pages they link to bring: answers. A self-hosted server sends your questions and an approximate country to OpenAI, Perplexity and Anthropic, nothing about your visitors; it is off until an AI key is set.
- Revenue from your payment provider. Every sale is credited to the visit that earned it, for Stripe, Lemon Squeezy, Polar, Paddle and Dodo: revenue.
- Install anywhere. A script tag, an npm package, WordPress and more: platforms.
- API and MCP server. Read-only tools for Claude, Cursor or ChatGPT, and an HTTP API: API, MCP.
- Sign in with Google, Microsoft or OIDC. Free on every install: sign-in.
- Privacy by default. Cookieless, no IP address ever stored: privacy, and a printable privacy report for every site.
- Heatmaps without recording anyone. An opt-in module of about 1.5 KB: heatmaps.
- Widgets for your own pages. Live now, revenue, a privacy seal and Online, with no script and no cookie: widgets.
- Client reports. Weekly or monthly email and PDF for the people who pay for them: client reports.
- Your own look on share links. Your logo and colour on shared pages: share links.
- Keeps counting when your server is down. Browsers hold what they could not send: offline queue.
- Keyboard first. Every key can be changed: shortcuts, plus the little things.
Gallery
How it's built
Go, embedded DuckDB and SQLite, React with an in-house SVG chart kit. Every event is fsynced before it's acknowledged, every webhook is stored raw before it's processed, and both replay exactly once. How each number was measured: By the numbers.
Roadmap
- Mobile analytics: track your iOS and Android apps (coming soon)
- Live sandbox runs against each payment provider
- Peek: an optional in-app assistant on the same read-only tools, with your own AI key
- A mobile app (iOS and Android) to see your dashboard on your phone
- Public v1.0: a one-click deploy template, a public demo
What is already done: CHANGELOG.md.
Contributing
Contributions are welcome: how to build, test and send a change is in CONTRIBUTING.md. Found a security problem? Please report it privately, as SECURITY.md explains.
License
Server and dashboard AGPL-3.0 · tracker and the trckable npm package MIT · WordPress plugin GPL-2.0-or-later · geolocation by DB-IP (CC BY 4.0)
The name trckable and the logo are not part of those licenses: a fork is welcome, under its own name. See TRADEMARKS.md.
trckable MCP questions
How do I add trckable MCP to Claude Code?
Run claude mcp add trckable -- npx -y trckable in your terminal. Add --scope user to make it available in every project.
How do I add trckable MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I self-host trckable?
You can self-host it using a single Docker container by running a docker run command with a data volume.
Can I use trckable with my payment provider to track revenue?
Yes, it provides revenue attribution for Stripe, Lemon Squeezy, Polar, Paddle, and Dodo.
What AI models can I track mentions for?
The tool can track whether ChatGPT, Perplexity, and Claude are recommending your site to users.