# PureStats

> Free cookieless web analytics with unlimited sites and tracked traffic. AI coding agents can create sites, install the normal tracker, verify installation and query analytics through scoped OAuth APIs. Public documentation is readable without JavaScript, authentication or cookies.

Public overview: https://purestats.io/for-ai-agents
Availability: machine registration, browser-approved delegation and the management API are live. Public MCP, ChatGPT and Claude plugins are not published or enabled. Safety rate limits and human approval for destructive actions still apply.

Start with the agent quickstart. Treat the OpenAPI document as the canonical machine contract; do not infer machine endpoints from browser dashboard routes. Never put secrets in URLs, tracker snippets, logs or chat output.

## Agent Guides

- [PureStats agent documentation](https://purestats.io/docs/agents/index.md): Public discovery and documentation entry points.
- [Agent quickstart](https://purestats.io/docs/agents/quickstart.md): Register, prove domain control, create a site, install and verify tracking.
- [Authentication and delegation](https://purestats.io/docs/agents/authentication.md): Client credentials, browser consent, recovery and secret handling.
- [Machine API contract](https://purestats.io/docs/agents/api.md): Canonical operations, schemas and safe request handling.
- [Framework installation guides](https://purestats.io/docs/agents/frameworks.md): HTML, React, Next.js and Laravel tracker installation.
- [Agent proxy installation](https://purestats.io/docs/agents/proxy.md): Install agent-managed tracking proxies with safe asset caching and trusted client IP forwarding.
- [Verification and local testing](https://purestats.io/docs/agents/testing.md): Deterministic tests without synthetic production traffic.

## Machine Contracts

- [OpenAPI JSON](https://purestats.io/openapi.json): Canonical live operation IDs and schemas.
- [Setup contract](https://purestats.io/openapi/setup.json): Authentication, site creation, installation and tests only.
- [Analytics contract](https://purestats.io/openapi/analytics.json): Read and analysis workflows without unrelated management operations.
- [Documentation manifest](https://purestats.io/docs/agents/index.json): Markdown document URLs and availability.
- [Full documentation](https://purestats.io/llms-full.txt): Complete live documentation, not search excerpts.

## Product Documentation

- [PureStats documentation](https://purestats.io/docs/index.md): Learn how to set up PureStats, install the tracker, understand your analytics dashboard, manage privacy settings, and operate teams securely.
- [Verify installation](https://purestats.io/docs/getting-started/verify-installation.md): Confirm that the tracker exists, loads and sends the first pageview.
- [Consent mode](https://purestats.io/docs/privacy/consent-mode.md): Configure PureStats to wait for analytics consent before tracking.
- [Tracking script reference](https://purestats.io/docs/reference/tracking-script.md): Reference for the PureStats pf.js tracker and script attributes.
- [JavaScript API](https://purestats.io/docs/reference/javascript-api.md): Trigger pageviews, custom events and consent changes from client-side code.

Every product guide has a clean `.md` version listed in the documentation manifest.

## Optional

- [Future integration requirements](https://purestats.io/docs/agents/future-integrations.md): Not live: OAuth metadata, PKCE, resource audience and preregistered clients.