BuddyStat for developers

Analytics that behaves like good software.

One script tag, or one npm package. A REST API for everything the dashboard shows, an MCP server your agents can operate, and a codebase you can read, audit, and run on your own server.

Start for $0Live demo

7-day free trial, or self-host free forever.

Install

One tag. Or one package.

Drop the script on any site, or install @buddystat/js and initialize it in two lines. Autocapture starts immediately; custom events are there when you want them.

Script docs
index.html
<script
  src="https://app.buddystat.com/api/script.js"
  data-site-id="YOUR_SITE_ID"
  async
></script>
app.ts
npm install @buddystat/js

import buddystat from "@buddystat/js";

await buddystat.init({
  analyticsHost: "https://app.buddystat.com/api",
  siteId: "YOUR_SITE_ID",
});

Stats API

Everything in the dashboard, over HTTP.

Every metric BuddyStat shows is available from the REST API with a bearer key. Pull traffic into your own tools, build a live feed, or export events to a warehouse. An API playground in the dashboard generates ready-to-use snippets.

API reference
terminal
curl "https://app.buddystat.com/api/sites/123/metric?parameter=country&start_date=2026-06-01&end_date=2026-06-30" \
  -H "Authorization: Bearer YOUR_API_KEY"
response.json
{
  "data": {
    "data": [
      { "value": "US", "count": 8420, "percentage": 54.63 },
      { "value": "GB", "count": 2150, "percentage": 13.95 }
    ],
    "totalCount": 87
  }
}

Organization keys or personal keys, rate-limited per plan. Sessions, metrics, funnels, goals, errors, and events are all endpoints. See the reference for the full surface.

MCP

Your agent already knows how to use it.

A hosted MCP server sits on top of the full REST API. Your agent reads live traffic, debugs errors, and manages goals, with the same permissions as a teammate.

Set up MCP
terminal
claude mcp add --transport http buddystat \
  https://app.buddystat.com/api/mcp

Open source

Read the code. Run the code.

Every line of BuddyStat is on GitHub under AGPL v3, including the cloud and enterprise features. Clone it, audit it, and run the full stack on your own VPS with Docker.

Self-hosting guide
terminal
git clone https://github.com/iliasgnrs/buddystat.git
cd buddystat
./setup.sh your.domain.name

The setup script brings up the full stack with Docker Compose. Self-hosting is free for personal and business use.

Developer questions, answered plainly.

More ways teams use BuddyStat.

For agenciesOne workspace for every client site, with dashboards clients can read on their own.White labelEmbed dashboards, build on the API, or self-host: analytics under your own brand.For startupsAnswers about your traffic and product without hiring a data team.For SaaSSignup funnels, retention cohorts, and the sessions behind every drop-off.For ecommerceCheckout funnels, campaign tracking, and full traffic with no consent banner.For small businessesThe handful of numbers that matter, with no GA4 setup and no cookie banner.For creators & publishersWhat resonates, where readers come from, and a dashboard you can share.For European companiesEU-hosted cloud, cookieless compliance, and a self-host option for full control.EnterpriseSSO, dedicated instances, on-premise installation, and infinite retention.Compare BuddyStatSide-by-side with Google Analytics, Plausible, Matomo, PostHog, and more.

Ship analytics in the next ten minutes.

One script tag now. The API, the MCP server, and self-hosting whenever you want them.

Start for €0Live demo

7-day free trial. Cancel anytime.