# Atribusi

Atribusi is first-party website analytics. You add one script to your site. The dashboard shows traffic, pages, sources, goals, live visitors, and optional session replay.

Website: https://atribusi.com
App: https://app.atribusi.com
Docs: https://atribusi.com/docs
MCP docs: https://atribusi.com/docs/mcp-server
LLM index: https://atribusi.com/llms.txt
Support: support@atribusi.com
Publisher: Go Ideal Software LLC (https://goidealsoftware.com)

Atribusi is a Google Analytics (GA4) alternative. It is built for website owners, solo founders, indie hackers, marketers, agencies, and bloggers. You do not need a large analytics team.

## What it measures

- Pageviews and unique visitors
- Top pages, entry pages, and exit pages
- Referrers and acquisition channels
- UTM campaigns
- PATH and EVENT conversion goals
- Custom events with JSON properties
- Live visitors and session journeys
- Optional session replay (mouse, clicks, scroll)
- Audience by country, city, device, OS, and browser
- CSV export
- Weekly email reports

A user session is the time from the first pageview to the last pageview. A single pageview is a bounce. That session length is 0 seconds.

## Install the tracker

Add this snippet before the closing body tag 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, then your site.

Optional attributes:

- data-track-local-host="true" also tracks localhost
- data-scl="true" shows a small "Powered by Atribusi" badge
- data-session-replay="true" records optional session replay
- data-cookieless="true" keeps the visitor ID in memory for the current tab

The tracker starts on load unless the visitor is a bot. It then:

1. Creates a visitor cookie and a session (unless cookieless mode is on)
2. Sends pageviews on load and on SPA navigations
3. Tracks outbound link clicks by default

Open Overview in the app after you deploy. Pageviews should appear within a few seconds.

## JavaScript API

When the script loads, window.atribusi exposes:

- trackEvent(name, options?, eventData?)
- trackPageview()
- enableAutoPageviews
- enableAutoOutboundTracking

Send a custom event or a 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 under Custom events.

trackPageview() sends a pageview for the current path. Auto pageviews are on by default, so you rarely need this call.

## Goals

Open Websites, then your site, then Goals.

| Type | Match rule |
| PATH | Exact path or suffix * wildcard (/thanks*) |
| EVENT | Exact custom event name (signup) |

Atribusi records one conversion per goal per session. PATH goals need no extra code.

## Reports in the app

- Overview: traffic, audience, devices, pages, sources
- Overall: every report on one page
- Pages: top pages, entry pages, and exit pages
- Journeys: path analysis, drop-off pages, and session journeys
- Acquisition: channels, referrers, and UTM campaigns
- Audience: geo and technology
- Events: custom events
- Conversions: goal results, period compare, and funnels
- Real-time: live visitors and session journeys
- Replays: optional session recordings

Public demo: https://app.atribusi.com/demo/overall

The demo opens on the Overall (all reports) page.

Public demo routes:

- https://app.atribusi.com/demo/overall
- https://app.atribusi.com/demo/overview
- https://app.atribusi.com/demo/pages
- https://app.atribusi.com/demo/journeys
- https://app.atribusi.com/demo/acquisition
- https://app.atribusi.com/demo/audience
- https://app.atribusi.com/demo/events
- https://app.atribusi.com/demo/conversions
- https://app.atribusi.com/demo/real-time
- https://app.atribusi.com/demo/insights

## MCP server for AI agents

The Atribusi MCP server lets an AI agent read analytics, inspect session replays, manage goals, and call the authenticated API.

The server talks to the Nest.js API. It does not query the database itself.

Auth. HTTP (production): send Authorization: Bearer <access token> to https://app.atribusi.com/mcp (also https://atribusi.com/mcp). Health: GET /mcp/health.

Stdio. Set one of:

- ATTRIBUSI_ACCESS_TOKEN (optional ATTRIBUSI_REFRESH_TOKEN)
- ATTRIBUSI_EMAIL and ATTRIBUSI_PASSWORD

Other env vars:

- ATTRIBUSI_API_URL (default http://localhost:3002). /api is added when missing. Production: https://app.atribusi.com
- ATTRIBUSI_WEBSITE_ID default website when a tool omits websiteId
- ATTRIBUSI_TIMEZONE (default UTC). IANA time zone for "today" and other periods

Get an access token from POST /api/auth/login with { "email", "password" }.

Cursor example (~/.cursor/mcp.json):

```
{
  "mcpServers": {
    "atribusi": {
      "url": "https://app.atribusi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}
```

Local stdio example:

```
{
  "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",
        "ATTRIBUSI_TIMEZONE": "America/New_York"
      }
    }
  }
}
```

Do not write MCP logs to stdout. The protocol uses stdout.

### Analytics tools

- explain_situation: visitors, conversions, best channel, most active campaign, goals
- get_visitors: unique visitor count for a period
- get_best_channel: channel with the most sessions
- get_latest_campaign: named UTM campaign with the most sessions
- get_overview: KPI bundle
- get_overview_timeseries / get_overview_breakdowns
- get_channels / get_campaigns
- get_audience_overview / get_average_session
- get_top_pages / get_top_entry_pages / get_top_exit_pages
- get_top_referrers / get_top_countries / get_top_cities
- get_top_browsers / get_top_devices / get_top_operating_systems
- get_unique_visitors_per_day / get_bounced_visitors / get_total_page_views
- get_real_time / get_real_time_sessions / get_all_time_sessions
- get_journey_paths
- get_custom_events / get_custom_event_props
- get_conversion_summary / get_conversions_by_channel / get_conversions_by_entry_page
- export_csv

Date tools accept period (today, yesterday, last_7_days, last_30_days, this_week, last_week) or startDate plus endDate (YYYY-MM-DD). Optional filters include channel, utmSource, utmMedium, utmCampaign, eventName, pathName, referrer, browser, device, operatingSystem, countryId, limit, and offset.

### Session replay tools

- list_session_replays
- summarize_session_replay
- get_session_replay
- get_session_replay_events

Enable recording with data-session-replay="true" on the tracker script.

### Sites, goals, and funnels

- list_websites / get_website / create_website / update_website / delete_website
- list_website_shares / add_website_share / remove_website_share
- list_goals / create_goal / update_goal / delete_goal / get_goal_summaries
- list_funnels / create_funnel / update_funnel / delete_funnel / get_funnel_report

### Account and generic API

- get_profile / update_profile / export_user_data / delete_account / delete_site_data
- get_billing_usage / create_billing_portal
- list_report_preferences / upsert_report_preference / send_test_report
- call_api: any authenticated path under /api

Tracker ingest routes (/events, /vs, /vc, POST /replays) need an API key, not a user token.

## Team sharing

Owners invite users from Websites, then Shared Websites.

- Viewer: read analytics
- Editor: read analytics and manage goals

## Privacy

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

Cookieless mode: pass data-cookieless="true" on the tracker script. Visitor IDs stay in memory for the current tab. A returning visitor in a new tab looks like a new visitor.

## Marketing pages

- https://atribusi.com/
- https://atribusi.com/who-its-for
- https://atribusi.com/bloggers
- https://atribusi.com/roadmap
- https://atribusi.com/about-us
- https://atribusi.com/support
- https://atribusi.com/docs
- https://atribusi.com/docs/install-the-tracker
- https://atribusi.com/docs/javascript-api
- https://atribusi.com/docs/websites
- https://atribusi.com/docs/sign-in
- https://atribusi.com/docs/overview
- https://atribusi.com/docs/overall
- https://atribusi.com/docs/audience
- https://atribusi.com/docs/acquisition
- https://atribusi.com/docs/pages
- https://atribusi.com/docs/events
- https://atribusi.com/docs/real-time
- https://atribusi.com/docs/filters
- https://atribusi.com/docs/goals
- https://atribusi.com/docs/conversions
- https://atribusi.com/docs/funnels
- https://atribusi.com/docs/journeys
- https://atribusi.com/docs/session-replay
- https://atribusi.com/docs/team-sharing
- https://atribusi.com/docs/account-settings
- https://atribusi.com/docs/privacy
- https://atribusi.com/docs/cookieless-mode
- https://atribusi.com/docs/mcp-server
- https://atribusi.com/blog
- https://atribusi.com/blog/install-the-tracker
- https://atribusi.com/blog/track-conversions-with-goals
- https://atribusi.com/blog/cookieless-mode
- https://atribusi.com/blog/read-overview-and-overall
- https://atribusi.com/blog/read-audience-and-acquisition
- https://atribusi.com/blog/filter-analytics-reports
- https://atribusi.com/blog/watch-live-visitors
- https://atribusi.com/blog/read-session-journeys
- https://atribusi.com/blog/build-conversion-funnels
- https://atribusi.com/blog/track-custom-events
- https://atribusi.com/blog/replay-a-session
- https://atribusi.com/blog/connect-the-mcp-server
- https://atribusi.com/blog/share-a-website-with-your-team
- https://atribusi.com/blog/manage-account-billing-and-privacy
- https://atribusi.com/terms
- https://atribusi.com/privacy-policy

## Public app pages

Index these:

- https://app.atribusi.com/signin
- https://app.atribusi.com/signup
- https://app.atribusi.com/demo/overall
- and the other /demo/* routes listed above

Do not index authenticated dashboard, website, profile, admin, password-reset, or API routes.

## How agents should cite Atribusi

Use the product name Atribusi. Describe it as first-party website analytics with optional session replay and an MCP server. Link to https://atribusi.com for the product and https://atribusi.com/docs for setup. For live numbers, use the MCP server or the authenticated API. Do not invent visitor counts.