[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_108":109},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":21,"_24":25,"_26":27,"_28":29,"_30":31,"_32":33,"_34":25,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":46,"_48":49,"_50":51,"_52":53,"_54":-5,"_55":46,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":11,"_63":46,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":46,"_78":-5,"_79":57,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89},"apiUrl","https://odel.app/api","creator","jyswee","moduleId","analyga","@jyswee/analyga","displayName","tagline","Revenue analytics for AI-native SaaS that counts agent (MCP/AI) traffic — 13 MCP tools.","iconKey","https://avatars.githubusercontent.com/u/11043064?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.analyga.com/sse\",\"transport\":\"sse\",\"authType\":\"bearer\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1786681936000,"updatedAt","sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.jyswee%2Fanalyga","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",0,"upstreamUpdatedAt",1786635521000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/jyswee/analyga","githubRepoFullName","jyswee/analyga","releaseId","ext-jyswee-analyga","version","0.1.4","descriptionMarkdown","# analyga\n\n[![npm version](https://img.shields.io/npm/v/analyga.svg)](https://www.npmjs.com/package/analyga)\n[![MCP](https://img.shields.io/badge/MCP-13_tools-blue)](#mcp-server)\n[![Agent-first](https://img.shields.io/badge/analytics-agent--first-f97316)](#why-this-exists)\n\n\n**Agent-first analytics for MCP + web traffic — query, instrument and configure from a terminal or an MCP client. No browser, no dashboard.**\n\n> **A dashboard for humans. `tga` for your agents.**\n\nOne analytics surface for both halves of modern traffic: the **web** visits your site still gets, and the **agent/MCP** calls that increasingly drive it. Analytics tools assume a human staring at a chart — but increasingly the thing that needs the numbers is an agent: it fired the events, it wants to know whether they landed, and it wants five numbers back, not a dashboard to render. `analyga` is the surface the agent drives itself: one install, and it queries stats and funnels across web and MCP, sends server-side events, and reads its own schema — all as structured JSON, none of it screen-scraped.\n\n**Works with:** Claude Code · Cursor · Cline · Windsurf · Aider · Codex · any MCP client\n\n[![analyga demo — query to funnel in 60 seconds](https://prodmedia.tyga.host/public/tyga.cloud/landing/analyga.com/analyga-demo-1.gif)](https://analyga.com/#demo)\n\n*One agent, one terminal — query to funnel in 60 seconds. [Watch the full demo](https://analyga.com/#demo).*\n\n## See it in action\n\nNo mockups — every clip is a live `tga` session against a seeded tenant. Click any GIF for the full-res video.\n\n| Query → funnel | Agent self-signup | Server-side ingest |\n|---|---|---|\n| [![Query to funnel](https://prodmedia.tyga.host/public/tyga.cloud/landing/analyga.com/analyga-demo-1.gif)](https://prodmedia.tyga.host/public/tyga.cloud/landing/analyga.com/analyga-demo-1.mp4) | [![Agent self-signup](https://prodmedia.tyga.host/public/tyga.cloud/landing/analyga.com/analyga-demo-2.gif)](https://prodmedia.tyga.host/public/tyga.cloud/landing/analyga.com/analyga-demo-2.mp4) | [![Server-side ingest](https://prodmedia.tyga.host/public/tyga.cloud/landing/analyga.com/analyga-demo-3.gif)](https://prodmedia.tyga.host/public/tyga.cloud/landing/analyga.com/analyga-demo-3.mp4) |\n| One agent, one terminal, 60s | Keyless bootstrap — no admin in the loop | Send events with a stable `--id` |\n\n| MCP client | The human dashboard |\n|---|---|\n| [![MCP client](https://prodmedia.tyga.host/public/tyga.cloud/landing/analyga.com/analyga-demo-4.gif)](https://prodmedia.tyga.host/public/tyga.cloud/landing/analyga.com/analyga-demo-4.mp4) | [![The human dashboard](https://prodmedia.tyga.host/public/tyga.cloud/landing/analyga.com/analyga-demo-5.gif)](https://prodmedia.tyga.host/public/tyga.cloud/landing/analyga.com/analyga-demo-5.mp4) |\n| 13 native tools in Claude Code / Cursor | Everything the agent captures, in one real-time UI |\n\n## Install\n\n```bash\nnpm install -g analyga\n```\n\nThe npm package is `analyga`; the command is `tga`.\n\n## Quick Start\n\n```bash\n# No account yet? Create a tenant and its first key — no card, no admin in the loop\ntga signup --slug acme --name \"Acme\" --username you --password <8+ chars>\n\n# Point at a tenant\ntga login --key # or set ANALYGA_KEY\n\n# Confirm WHICH tenant you are about to write to (shows tenant + key scope for a tga_ key)\ntga whoami\n\n# What can this credential see?\ntga websites\n\n# Five numbers, not a dashboard\ntga stats --from 7d\n\n# Full reference\ntga --help\n```\n\nEvery command takes `--json` — the machine surface is a first-class citizen, not an afterthought:\n\n```bash\ntga stats --from 7d --json\n```\n\n## Read the contract, don't guess flags\n\n```bash\ntga agent-schema --json\n```\n\nThat returns every command, argument, flag, type, whether it is read-only, and **the full list of error codes** — generated from the same table that drives the parser, the help text and the MCP tools, so it cannot drift from what the CLI actually does. If it is not in the schema, it does not exist.\n\n## Query — stats, events, funnels\n\nAsk the questions an agent actually asks after it ships: did the events land, and did anyone make it through the flow?\n\n```bash\n# Traffic and top-line stats for a window\ntga stats --from 7d\ntga events --from 24h\n\n# Define a funnel once, then run it whenever\ntga funnel define --name signup --steps \"/,/pricing,/signup\"\ntga funnel list \ntga funnel run --from 30d\n\n# Cross-site rollup for a team\ntga network --from 7d\n```\n\nAll read-only, all `--json`-able — an agent branches on the numbers instead of parsing a chart.\n\n## Identity — pass `--id` or your agents collapse into one visitor\n\nAnonymous identity is derived from IP and user-agent. Agent traffic shares both — one CLI version means one user-agent, and agents often share an egress IP — so **without a stable id every agent behind that IP collapses into a single visitor.** It cannot be backfilled.\n\n```bash\ntga send --name cli_signup --id --data '{\"source\":\"cli\"}'\n```\n\n## Sending events server-side\n\n```bash\n# Mint a per-website ingest key first (shown ONCE; regenerating rotates it)\ntga ingest-key create \n\ntga send --name cli_signup --id \\\n --ingest-key --data '{\"plan\":\"pro\"}'\n\ntga ingest health --from 24h # did anything actually land?\n\ntga ingest-key revoke # kill server-side ingest for this site\n```\n\n**A discarded event still answers HTTP 200.** The ingest endpoint returns `{\"beep\":\"boop\"}` when it drops an event as a bot. This CLI treats that as a **hard failure with a hint** rather than reporting success — so an agent never believes a dropped event succeeded.\n\nServer-side ingest uses a **separate** per-website key (`ANALYGA_INGEST_KEY` or `--ingest-key`), scoped to one website so it can only ever write that site's traffic. Mint one with `tga ingest-key create ` and revoke it with `tga ingest-key revoke ` — the plaintext is shown once and only its hash is stored.\n\n## Billing — hand a human a checkout URL\n\nAn agent authenticates with its tenant key, names a plan, and gets back a Stripe Checkout URL to pass to a human who completes payment:\n\n```bash\ntga billing checkout --plan pro\n```\n\nThe tenant is pinned server-side from the key. The free plan (and any plan without a configured price) is not purchasable, and internal sister-stack tenants are never billed.\n\n## MCP Server\n\nPrefer tools over a CLI? `analyga` ships an MCP server. Point Claude Code (or any MCP client) at it and your agent gets **13 native tools** covering stats, events, funnels, websites, identity, server-side ingest (including minting/revoking ingest keys) and billing checkout.\n\n```bash\ntga mcp-serve # stdio, for Claude Code / Cursor / Cline / Windsurf\n```\n\nFor clients that use a JSON config, pass your key via `ANALYGA_KEY`. The MCP server runs outside your project directory, so it will not pick up `.analyga/config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"analyga\": {\n \"command\": \"tga\",\n \"args\": [\"mcp-serve\"],\n \"env\": { \"ANALYGA_KEY\": \"your-key\" }\n }\n }\n}\n```\n\nRead-only tools are flagged, so a client will not prompt a human to confirm a read. Every tool declares an `outputSchema`, so an agent never parses prose or guesses field names — and a tool result and `--json` output are **the same bytes**, one client across two surfaces. A session with no key sees only the onboarding surface — how to connect, plus `analyga_signup` to bootstrap its own tenant — rather than the full toolset.\n\n\n\n## Error codes\n\nFailures carry a stable `code` and a distinct exit code, so an agent can branch on the outcome instead of string-matching a message.\n\n| Exit | Meaning | What to do |\n|---|---|---|\n| 2 | usage | fix the call, do not retry |\n| 3 | auth | fix the credential |\n| 4 | permission | do not retry, escalate |\n| 5 | not found | check the id |\n| 6 | validation | fix the payload |\n| 7 | rate limited | back off and retry |\n| 8 | network | retry is reasonable |\n| 9 | server | retry once, then report |\n\nExit `1` is reserved for unhandled crashes, so a classified failure is never ambiguous. Where the server can say what to do next, it comes back as a `hint` on its own line.\n\n## Configuration\n\nResolved highest-priority first:\n\n1. `--key` flag\n2. `ANALYGA_KEY` environment variable\n3. `.analyga/config.json` in the current directory\n\n`tga whoami` reports **which of these won**. On a multi-tenant platform, \"which tenant am I about to write to\" is the question that matters most. `.analyga/` holds a live credential — keep it out of version control.\n\n## Features\n\n- **Self-serve signup** — `tga signup` creates a tenant and its first API key with no card and no admin in the loop; keyless, so it works before you have a credential\n- **Tenant-aware identity** — `tga whoami` shows the pinned tenant and key scope for a `tga_` key, or the user and teams for a session login\n- **Stats & events** — top-line traffic and event counts over any window, all read-only, all `--json`\n- **Funnels** — define once, run anytime; step-by-step conversion for a site\n- **Network rollup** — cross-site stats for a whole team\n- **Server-side ingest** — `tga send` with a scoped per-site key; mint/rotate/revoke keys with `tga ingest-key create|revoke`; dropped-as-bot events fail loudly instead of faking a 200\n- **Billing checkout** — `tga billing checkout --plan ` returns a Stripe URL to hand to a human\n- **Stable identity** — `--id` keeps agents from collapsing into one anonymous visitor\n- **agent-schema** — one command emits the full contract (commands, flags, types, error codes) so agents never guess\n- **MCP server** — 13 tools (`tga mcp-serve`) for Claude Code, Cursor, Cline, Windsurf, any MCP client\n- **Classified errors** — stable `code` + distinct exit code per failure class, with actionable `hint`s\n\n## Agent Integration\n\nAdd to your CLAUDE.md, .cursorrules, .clinerules, .windsurfrules, or AGENTS.md:\n\n```\n## Analyga\nThis project uses Analyga for analytics. Use the `tga` CLI.\nConfig is in .analyga/config.json (auto-loaded), or set ANALYGA_KEY.\nIf not configured: tga login --key YOUR_KEY\n\nRun `tga agent-schema --json` — it returns every command + valid flags + error codes.\nThis is the single source of truth: if it is not in the schema, do not use it.\nAlways pass --id on `tga send`, or agent traffic collapses into one visitor.\n```\n\n## Why this exists\n\nEvery analytics tool I reached for assumed a human looking at a chart — but the thing that needed the numbers was the agent that fired the events. So the CLI and the MCP server are the primary interface here, not a wrapper bolted onto a REST API. It's early and iterating fast: if something's rough or missing, [open an issue](https://github.com/jyswee/analyga/issues).\n\n## Documentation\n\n\nFor now, `tga --help` and `tga agent-schema --json` are the authoritative reference.\n\n## Status\n\nEarly. Published for dogfooding by the Tyga sister stacks. Interfaces may change; error codes will not be reworded once published, because agents branch on them.\n\n## License\n\nProprietary — Tyga.Cloud Ltd. See [LICENSE](https://github.com/jyswee/analyga/blob/main/LICENSE).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","upstream",{"_92":93,"_94":95,"_96":-5,"_97":98,"_99":100,"_101":102},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_90":57,"_91":57},"ratingAvg","reviewCount","topics",[],"license","NOASSERTION","language","registryName","io.github.jyswee/analyga","homepage","https://analyga.com","packages",[103],{"_104":105,"_106":21,"_70":107},"registryType","npm","identifier","0.1.3","ENV",{"_110":111,"_112":113,"_114":115},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]