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 and audit.

7-day free trial on every plan.

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. Audit the code.

Every line of BuddyStat is on GitHub under AGPL v3, including the cloud and enterprise features. Clone it, audit it, and verify exactly how your data is handled.

terminal
git clone https://github.com/iliasgnrs/buddystat.git

The full product, including the cloud and enterprise features, is on GitHub under the AGPL v3 license. Read it, audit it, and verify exactly how your data is handled.

Developer questions, answered plainly.

Ship analytics in the next ten minutes.

One script tag now. The API and the MCP server whenever you want them.

7-day free trial. Cancel anytime.