Atribusi docs

Atribusi is a first-party analytics product. This guide covers install, goals, custom events, and the MCP server for AI agents.

Install the tracker

Add this snippet before </body> on every page:

<script
  async
  id="a-tracker"
  data-api-key="YOUR_API_KEY"
  data-api-host="https://app.atribusi.com/api"
          src="https://atribusi.com/tracker/tracker.min.js"
></script>

Replace YOUR_API_KEY with the key from Websites → [your site].

Optional attributes:

• data-track-local-host="true" — also track localhost
• data-scl="true" — show a small “Powered by Atribusi” badge

The tracker auto-starts on load (unless the visitor is a bot). It:

• Creates a visitor cookie and session
• Sends pageviews on load and SPA navigations
• Tracks outbound link clicks by default

JavaScript API

When the script loads, window.atribusi exposes:

const { trackEvent, trackPageview, enableAutoPageviews, enableAutoOutboundTracking } =
  window.atribusi;

trackEvent(name, options?, eventData?)

Send a custom event (or goal event):

window.atribusi.trackEvent('signup');
window.atribusi.trackEvent('purchase', {
  props: { plan: 'pro', value: 49 },
});

props must be a JSON-serializable object. Props show in Deep Insights → Custom events (and property breakdowns when enabled).

trackPageview()

Send a pageview for the current path. Rarely needed — auto pageviews are on by default.

Goals

In the app, open Websites → [site] → Goals.

Atribusi records one conversion per goal per session.

Reports

• Overview — traffic, audience, devices, pages, sources
• Insights — conversion KPIs, channels, entry pages, UTM campaigns, custom events, CSV export
• Real-time — live visitors and session journeys

MCP server

The Atribusi MCP server lets an AI agent read your analytics and manage goals. Ask questions such as how many visitors you had today, which channel led last week, or how the most active campaign is doing.

The agent can:

• Read overview KPIs, visitors, pages, referrers, and live traffic
• Rank acquisition channels and UTM campaigns
• Create, update, and delete PATH or EVENT goals

Run the server from the repo after you build apps/mcp. Point it at the API with env vars:

ATTRIBUSI_API_URL=https://app.atribusi.com
ATTRIBUSI_EMAIL=you@example.com
ATTRIBUSI_PASSWORD=your-password
ATTRIBUSI_TIMEZONE=America/New_York

You can pass ATTRIBUSI_ACCESS_TOKEN instead of email and password. Add this to your MCP host config (for example Cursor mcp.json):

{
  "mcpServers": {
    "atribusi": {
      "command": "node",
      "args": ["/absolute/path/to/atribusi/apps/mcp/dist/index.js"],
      "env": {
        "ATTRIBUSI_API_URL": "https://app.atribusi.com",
        "ATTRIBUSI_EMAIL": "you@example.com",
        "ATTRIBUSI_PASSWORD": "your-password"
      }
    }
  }
}

Team sharing

Owners can invite users from Websites → Shared Websites:

• Viewer — read analytics
• Editor — read analytics and manage goals

Privacy

From Account Settings you can export your account data or delete site analytics / your account (when those controls are enabled for your plan).

Cookieless mode

Pass data-cookieless="true" on the tracker script (when enabled) to keep visitor IDs in memory only for the current tab. See the cookieless release notes for limits.