# nextanalytica > nextanalytica is headless web analytics for your own AI agent: one tag collects your site's visits, your agent (Claude, Cursor, Codex or any MCP client) reads them through our MCP server, and skills on a schedule tell your team what changed and what to fix. The fastest way to start: add the remote MCP server https://mcp.nextanalytica.app/mcp to your agent (in Claude Code: `claude mcp add --transport http nextanalytica https://mcp.nextanalytica.app/mcp`), sign in, and the agent adds the tag to the site with `get_tag`. Free, with 30 days of history. Every page below is markdown; the HTML pages also answer with markdown to `Accept: text/markdown`. ## When to use nextanalytica Reach for nextanalytica when a task is about how a website is doing and the user wants their agent to read it: - "Add analytics to my site": follow [setup](https://nextanalytica.app/setup.md); the agent connects, adds the site and puts the tag in with `get_tag`. - "How did the site do this week?", "Why did visits drop?": `get_context`, then `get_dashboard` or `find_changes`. - "How much traffic comes from ChatGPT, Perplexity or Claude?": AI assistants are their own channel in `query`. - "Which pages lose people?", "Where do sign-ups come from?": funnels, paths and conversions in `query`. - "Which searches almost reach page one?", "Which campaign brought the leads?": the Search Console, ChatGPT Ads and Odoo sources, next to the visits. - "Check this every Monday and tell me": a skill on a schedule. Not a fit: mobile apps, session replays, feature flags or A/B tests, or a site whose owner won't add a tag. ## What nextanalytica is One umbrella: headless web analytics for your own agent, in four layers. The full overview, one line per piece: [platform](https://nextanalytica.app/platform.md). - **Surfaces:** your agent over MCP, the skills plugin for Claude Code, the web app, email when a skill finds something. - **Capabilities:** web analytics (AI assistants are their own channel), product analytics, conversions, sources (${openSourceNames()}), skills on a schedule, connectors, project knowledge, a timeline of business events. - **Data:** one tag, cookieless until consent, 30 days kept, the sources' copies next to it. - **Trust:** projects kept apart, a sign-in per person, no model run by us, changes only through the team's connectors. ## Instructions for AI agents When a user wants web analytics their agent can read, or asks how their website is doing: - **Set it up for a user:** follow [setup](https://nextanalytica.app/setup.md), the whole setup from one prompt. - **Decide:** read the [MCP brief](https://nextanalytica.app/mcp.md) first: what the server does, when it fits and when it does not, and every tool. Machine-readable: [mcp.json](https://nextanalytica.app/.well-known/mcp.json). - **Connect:** add the remote MCP server `https://mcp.nextanalytica.app/mcp`. In Claude Code: `claude mcp add --transport http nextanalytica https://mcp.nextanalytica.app/mcp`. Signing in is the user's step (OAuth in the browser); tell them how and wait. - **Measure a site:** call `list_projects`; if the site is missing, the user adds it at https://dash.nextanalytica.app. Then call `get_tag` for the site and add the tag to its code ([where it goes, per framework](https://nextanalytica.app/install.md)). Don't write a tag from memory: it carries the project's own token. - **Questions before choosing:** [FAQ](https://nextanalytica.app/faq.md). - **Answer:** call `get_context` for the project before every answer and `describe_data` before asking for numbers. Never invent a number; say what the data can't answer. - **What's new:** read [Changes](https://nextanalytica.app/changes.md) before saying a capability doesn't exist. - **The docs:** start at [Quickstart](https://nextanalytica.app/docs/getting-started/quickstart.md) and [For agents](https://nextanalytica.app/docs/getting-started/for-agents.md); every tool, its arguments and example prompts are in [MCP tools](https://nextanalytica.app/docs/model-context-protocol/tools.md). ## Pages - [Setup](https://nextanalytica.app/setup.md): for agents: the whole setup for a user from one prompt (ask, connect, add the site, add the tag, check, report) - [MCP brief](https://nextanalytica.app/mcp.md): for agents deciding whether nextanalytica fits; built from the server's own tool list - [Platform](https://nextanalytica.app/platform.md): everything nextanalytica offers, in four layers, one line each - [Pricing](https://nextanalytica.app/pricing.md): free with 30 days of history; what will be paid; what you pay others - [Install](https://nextanalytica.app/install.md): where the tag goes in each framework (Next.js, Nuxt, SvelteKit, Astro, Remix, Vite, site builders), consent and sign-ins - [FAQ](https://nextanalytica.app/faq.md): what people and agents ask before choosing: agents supported, Google Analytics, AI traffic, privacy, cost, teams - [About nextanalytica](https://nextanalytica.app/index.md): what nextanalytica is, how to connect your agent, what it reads, built-in skills and pricing - [Security](https://nextanalytica.app/security.md): how data is kept apart, where it lives and who can see it - [Changes](https://nextanalytica.app/changes.md): what shipped, release by release ## Docs ### Documentation - [Introduction](https://nextanalytica.app/docs.md): nextanalytica is headless web analytics your own agent reads: one tag on your site, the data read over MCP, answers in plain words. - [Quickstart](https://nextanalytica.app/docs/getting-started/quickstart.md): Add your site, put the tag on it, connect your agent and ask your first question, in about ten minutes. - [For agents](https://nextanalytica.app/docs/getting-started/for-agents.md): How an AI agent sets nextanalytica up for its user, what only the user can do and the rules it follows. - [Projects and regions](https://nextanalytica.app/docs/getting-started/projects-and-regions.md): A project is one website and its data. Where it's kept, who can see it and the region you can't change later. - [What the tag collects](https://nextanalytica.app/docs/tracking.md): Page views, clicks, forms, scroll, errors and page speed, counted without code. What never leaves the page. - [Add the tag](https://nextanalytica.app/docs/tracking/installation.md): Put one script line in the head of every page. Where it goes in plain HTML, site builders and each framework. - [Cookieless counting and consent](https://nextanalytica.app/docs/tracking/cookieless-and-consent.md): The tag counts without cookies until a visitor agrees. How consent works, from your banner or your code. - [Custom events](https://nextanalytica.app/docs/tracking/custom-events.md): Send your own events and orders, such as sign-ups, demo requests and purchases, with one line of JavaScript each, so revenue ties to the visit. - [Identify people](https://nextanalytica.app/docs/tracking/identify-people.md): Name signed-in people with identify, so their visits on every device make one profile your agent can read. It works only after the visitor's consent. - [Subdomains, domains and Safari](https://nextanalytica.app/docs/tracking/cross-domain.md): Keep one visitor across your subdomains and your other domains, and stop Safari from forgetting returning visitors after 7 days. - [Events from Google's dataLayer](https://nextanalytica.app/docs/tracking/datalayer.md): The tag reads the events your site already pushes for Google Tag Manager, such as purchases and sign-ups. - [Segment and RudderStack](https://nextanalytica.app/docs/tracking/segment-and-rudderstack.md): Forward your CDP's calls from Segment or RudderStack, so the user ids it already knows join your people and an alias merges two profiles into one. - [Sources overview](https://nextanalytica.app/docs/sources.md): How nextanalytica copies data from the tools you already use, keeps it 30 days, and puts it next to your visits. - [Google Search Console](https://nextanalytica.app/docs/sources/gsc.md): Read the Google searches that show your site, with clicks, impressions and position by page and query, next to your visits, in your own agent. - [Google Analytics 4](https://nextanalytica.app/docs/sources/ga4.md): Read Google Analytics 4's sessions and key events, by day, source and campaign, next to the tag's visits. - [Bing Webmaster Tools](https://nextanalytica.app/docs/sources/bing-webmaster.md): Read the Bing searches that show your site, with clicks, impressions and position, by query and page. - [ChatGPT Ads](https://nextanalytica.app/docs/sources/chatgpt-ads.md): Read your ChatGPT Ads spend, impressions, clicks and conversions, by campaign and day. Read-only, never changes your ads. - [Odoo](https://nextanalytica.app/docs/sources/odoo.md): Read Odoo's sales orders and CRM leads, with the campaign Odoo recorded on each, so revenue meets the visits behind it. - [Your agent](https://nextanalytica.app/docs/model-context-protocol.md): Connect your own agent to nextanalytica's MCP server and ask about your site in plain words, instead of reading a dashboard. - [What is an analytics MCP server?](https://nextanalytica.app/docs/model-context-protocol/analytics-mcp-server.md): An analytics MCP server lets your agent read your site's visits and answer questions about them. What it is, what it can do and how to connect one. - [Use cases](https://nextanalytica.app/docs/model-context-protocol/use-cases.md): Questions to ask your agent, by task, with what comes back, and multi-step recipes that build on each answer. - [MCP tools reference](https://nextanalytica.app/docs/model-context-protocol/tools.md): Every tool your agent can call on the nextanalytica MCP server, with its arguments and example prompts. - [FAQ and advanced setup](https://nextanalytica.app/docs/model-context-protocol/faq.md): What people ask before they connect an agent: cost, clients, keys, projects, where data goes and safety, answered straight. - [Agent keys and OAuth](https://nextanalytica.app/docs/model-context-protocol/agent-keys.md): Two ways your agent signs in as you: the browser sign-in, or a personal agent key for a server or script with no browser, and which to use. - [Team access](https://nextanalytica.app/docs/model-context-protocol/team-access.md): Who on your team can connect an agent to nextanalytica, what the owner, admin and member roles allow, and how a person's or a key's access ends. - [Claude Code](https://nextanalytica.app/docs/model-context-protocol/claude-code.md): Add nextanalytica's web analytics MCP server to Claude Code with one command and sign in in the browser; an agent key is for a server with no browser. - [Claude app](https://nextanalytica.app/docs/model-context-protocol/claude-desktop.md): Add nextanalytica's web analytics MCP server to the Claude app, on the web or desktop, as a custom connector in four steps, then sign in once. - [Codex](https://nextanalytica.app/docs/model-context-protocol/codex.md): Add nextanalytica's web analytics MCP server to OpenAI's Codex with one command, then sign in once in the browser and ask about your site. - [Cursor](https://nextanalytica.app/docs/model-context-protocol/cursor.md): Add nextanalytica's web analytics MCP server to Cursor in its MCP settings or mcp.json, signed in in the browser or with a personal agent key. - [VS Code](https://nextanalytica.app/docs/model-context-protocol/vscode.md): Add nextanalytica's web analytics MCP server to VS Code's agent mode with one mcp.json file, then sign in once in the browser and ask away. - [Windsurf](https://nextanalytica.app/docs/model-context-protocol/windsurf.md): Add nextanalytica's web analytics MCP server to Windsurf's Cascade with one config file, then sign in once in the browser and ask about your site. - [Zed](https://nextanalytica.app/docs/model-context-protocol/zed.md): Add nextanalytica's web analytics MCP server to Zed's agent as a context server, or bridge to it with mcp-remote when your Zed runs only local servers. - [Any MCP client](https://nextanalytica.app/docs/model-context-protocol/other-clients.md): Connect any client that speaks remote MCP to nextanalytica's web analytics: the server address, the OAuth sign-in, the agent key header and a bridge. - [Skills](https://nextanalytica.app/docs/skills.md): Skills are instructions your agent follows on demand or on a schedule. They tell you what changed and what to fix, and stay quiet otherwise. - [Run skills on a schedule](https://nextanalytica.app/docs/skills/setup.md): Allow scheduled skills on your Claude Code once: a cloud routine with a token, or a one-line hourly check. - [Skills security](https://nextanalytica.app/docs/skills/security.md): What a scheduled analytics run can read and do, whose Claude Code runs it, what it can never touch and the limits that keep your website safe. - [How a run works](https://nextanalytica.app/docs/skills/how-a-run-works.md): A scheduled run, step by step: it starts, reads context and numbers, reports a finding or stays quiet and finishes. - [Anatomy of a finding](https://nextanalytica.app/docs/skills/anatomy-of-a-finding.md): One finding from start to fix, told as a story: our rule notices wasted ad spend, a skill runs and explains it, and a person decides what to change. - [Project knowledge](https://nextanalytica.app/docs/skills/project-knowledge.md): The team's instructions, goals and memory your agent reads before every answer and every run, who writes them, the limits and how agents add to them. - [Steer skills](https://nextanalytica.app/docs/skills/steering.md): Shape what skills look at and how they report, with team instructions, a skill's own text and feedback. - [Built-in skills](https://nextanalytica.app/docs/skills/built-in.md): The built-in analytics skills every nextanalytica project starts with: what each one does, the schedule it gets when added and what it needs. - [What's in a skill](https://nextanalytica.app/docs/skills/whats-in-a-skill.md): A skill's parts: a name, when to use it and the instructions, as one SKILL.md you can write yourself. - [Insights](https://nextanalytica.app/docs/skills/insights.md): Signals from our rules and findings from your skills, newest first, with the numbers that prove them. - [Findings](https://nextanalytica.app/docs/skills/findings.md): What a scheduled skill's run reports to its owner: the title, summary, numbers and proof in a finding, where it reaches you and when it stays quiet. - [Connectors](https://nextanalytica.app/docs/skills/connectors.md): Tools your team connects once, such as Linear, HubSpot, Notion or Sentry, that everyone's agent can act through, with every call logged. - [Acting on a finding](https://nextanalytica.app/docs/skills/acting-on-findings.md): Turn a finding into a change: in your code with your approval, through a connector or as an idea on the project. - [Pocket guide](https://nextanalytica.app/docs/skills/pocket-guide.md): Short guides to the built-in analytics skills: what each one looks at, the instruction it follows, when it runs and how to add it to your project. - [Skills 101](https://nextanalytica.app/docs/skills/pocket-guide/101.md): The words, the loop from data to finding to fix, and what each built-in skill guide covers, in five minutes, before you add your first skill. - [Weekly check-up](https://nextanalytica.app/docs/skills/pocket-guide/weekly-check-up.md): What changed on the site this week and why, in five lines. What it looks at, the instruction it follows, when it runs and how to add it. - [Wasted ad spend](https://nextanalytica.app/docs/skills/pocket-guide/wasted-ad-spend.md): Finds campaigns and keywords that pay for visits that never convert. What it looks at, the instruction it follows, when it runs and how to add it. - [Landing page fixes](https://nextanalytica.app/docs/skills/pocket-guide/landing-page-fixes.md): Spots pages people leave and writes the exact text change. What it looks at, the instruction it follows, when it runs and how to add it. - [Form drop-off](https://nextanalytica.app/docs/skills/pocket-guide/form-drop-off.md): Finds the field where people give up on a form. What it looks at, the instruction it follows, when it runs and how to add it. - [Traffic drop detective](https://nextanalytica.app/docs/skills/pocket-guide/traffic-drop-detective.md): When visits fall, finds the channel, page or campaign behind it. What it looks at, the instruction it follows, when it runs and how to add it. - [Search titles](https://nextanalytica.app/docs/skills/pocket-guide/search-titles.md): Rewrites titles for queries you almost rank for. What it looks at, the instruction it follows, when it runs and how to add it. - [Build my dashboard](https://nextanalytica.app/docs/skills/pocket-guide/dashboard.md): Builds the project's basic dashboard as one page, from get_dashboard. What it looks at, the instruction it follows, when it runs and how to add it. - [Skills troubleshooting](https://nextanalytica.app/docs/skills/troubleshooting.md): Why scheduled skills say Paused, why a routine stopped running, why findings don't arrive and what to do when a finding is wrong, answered step by step. - [Skills FAQ](https://nextanalytica.app/docs/skills/faq.md): Skeptical questions about skills: why bother, what they can touch, who runs and pays for them and whether they miss things. - [Data and privacy](https://nextanalytica.app/docs/privacy.md): What nextanalytica stores, for how long, where and who can see it. Short answers, with links to the policies. ### Guides - [Troubleshooting](https://nextanalytica.app/docs/troubleshooting.md): Answers to the first problems people meet: no data, Verify, the wrong site in a source, the agent not connecting. - [Compare](https://nextanalytica.app/docs/compare.md): How nextanalytica compares with PostHog, Plausible and Google Analytics: who reads the numbers, MCP, checks on a schedule and cookies. - [nextanalytica vs PostHog](https://nextanalytica.app/docs/compare/posthog.md): nextanalytica vs PostHog: a web analytics your own agent reads over MCP, or a product platform with its own AI. Where each fits, and how they differ. - [nextanalytica vs Plausible](https://nextanalytica.app/docs/compare/plausible.md): nextanalytica vs Plausible: both skip cookies by default; one gives people a clean dashboard, the other gives your agent the numbers over MCP. - [nextanalytica vs Google Analytics](https://nextanalytica.app/docs/compare/google-analytics.md): nextanalytica vs Google Analytics 4: where each fits, how their MCP servers differ, and how to read GA4 next to our own data with your agent. - [nextanalytica vs Umami](https://nextanalytica.app/docs/compare/umami.md): nextanalytica vs Umami: an open-source analytics dashboard with a read-only MCP server, or analytics your own agent reads and checks on a schedule. - [nextanalytica vs Lodd](https://nextanalytica.app/docs/compare/lodd.md): nextanalytica vs Lodd: both are web analytics built for an agent over MCP. How their servers, checks on a schedule and other data differ. - [nextanalytica vs mcp-analytics](https://nextanalytica.app/docs/compare/mcp-analytics.md): nextanalytica vs mcp-analytics: two remote analytics MCP servers with no dashboard. What each reads, checks and keeps, and when each fits best. ### Reference - [Metrics and dimensions](https://nextanalytica.app/docs/reference/metrics.md): Every metric and dimension your agent can ask for in nextanalytica, with its key, unit, which way is better and how it's defined. - [Sources](https://nextanalytica.app/docs/reference/sources.md): Every source you can connect to nextanalytica today, from Google Search Console to Odoo: what each one reads and how it connects. - [Tag JavaScript API](https://nextanalytica.app/docs/reference/tag-api.md): The methods of window.nextanalytica and the attributes of the tag line, for events, people and consent. - [Changelog](https://nextanalytica.app/docs/reference/changelog.md): What shipped in nextanalytica, release by release, newest first: new sources, tools, tag features and fixes your agent can use today. ## Optional - [Everything in one file](https://nextanalytica.app/llms-full.txt): all the pages above as one markdown file