@clarvivo/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Clarvivo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,229 @@
+# `clarvivo-mcp`
+
+Install Clarvivo analytics without leaving your coding agent. The server detects the app framework, reuses or creates the right Clarvivo project, and returns the exact file and code edit. It can then verify real traffic and return compact analytics summaries.
+
+## The 60-second flow
+
+1. Create an API token at [app.clarvivo.com/dashboard/settings?tab=api-tokens](https://app.clarvivo.com/dashboard/settings?tab=api-tokens).
+2. Add this MCP server to your coding client with `CLARVIVO_API_TOKEN` in its environment.
+3. Ask the agent: **“Set up Clarvivo analytics for `example.com`.”**
+4. The agent detects the framework, calls `setup_analytics`, makes the returned edit, and deploys through your normal workflow.
+5. Visit the deployed site, then ask the agent to verify the installation.
+
+The tracker observes `history.pushState`, `history.replaceState`, and `popstate`, so client-side SPA route changes work automatically. Do not add router hooks.
+
+## Tools
+
+| Tool | Purpose |
+| --- | --- |
+| `setup_analytics` | Detect the framework, reuse a matching-domain project or create one, and return the exact installation edit. |
+| `get_install_snippet` | Get framework-specific instructions for an existing API key or project. |
+| `verify_installation` | Prove the deployed snippet works from a proof-of-life event count, without reading analytics. |
+| `list_projects` | List accessible projects and their public tracking API keys. |
+| `get_stats` | Return a small summary for 1–90 days, capped to the top five pages and referrers. |
+
+`setup_analytics` supports Next.js App Router, Next.js Pages Router, Vite (React/Vue/Svelte), Create React App, Astro, SvelteKit, Nuxt, Remix / React Router v7, Gatsby, Docusaurus, and static HTML.
+
+## Configuration
+
+Replace `clv_live_REPLACE_ME` below. Tokens are secrets; keep personal config files out of source control. The tracking API key returned by tools is intentionally public because it ships in page source.
+
+For local development or self-hosting, add `CLARVIVO_BASE_URL` (for example `http://127.0.0.1:5000`) beside the token.
+
+### Claude Code
+
+The official CLI accepts `--env` before the `--` separator. This user-scoped command works from every project:
+
+```bash
+claude mcp add clarvivo --scope user \
+  --env CLARVIVO_API_TOKEN=clv_live_REPLACE_ME \
+  -- npx -y @clarvivo/mcp
+```
+
+Check it with `claude mcp get clarvivo`. See [Claude Code MCP documentation](https://docs.anthropic.com/en/docs/claude-code/mcp).
+
+### Cursor
+
+Create `.cursor/mcp.json` in a project, or `~/.cursor/mcp.json` globally:
+
+```json
+{
+  "mcpServers": {
+    "clarvivo": {
+      "command": "npx",
+      "args": ["-y", "clarvivo-mcp"],
+      "env": {
+        "CLARVIVO_API_TOKEN": "clv_live_REPLACE_ME"
+      }
+    }
+  }
+}
+```
+
+One-click install with a placeholder token (review and replace it in Cursor before starting the server):
+
+[Add Clarvivo to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=clarvivo&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjbGFydml2by9tY3AiXSwiZW52Ijp7IkNMQVJWSVZPX0FQSV9UT0tFTiI6ImNsdl9saXZlX1JFUExBQ0VfTUUifX0)
+
+Cursor requires the single-server config to be JSON-stringified and base64-encoded in the `config` parameter. See [Cursor MCP configuration](https://cursor.com/docs/mcp) and [Cursor install links](https://cursor.com/docs/mcp/install-links).
+
+### Codex CLI
+
+Add this to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.clarvivo]
+command = "npx"
+args = ["-y", "clarvivo-mcp"]
+
+[mcp_servers.clarvivo.env]
+CLARVIVO_API_TOKEN = "clv_live_REPLACE_ME"
+```
+
+The equivalent command is:
+
+```bash
+codex mcp add clarvivo \
+  --env CLARVIVO_API_TOKEN=clv_live_REPLACE_ME \
+  -- npx -y @clarvivo/mcp
+```
+
+This was checked against the installed `codex mcp add --help` and the [official OpenAI Codex MCP documentation](https://developers.openai.com/codex/mcp/).
+
+### Windsurf
+
+Open `~/.codeium/windsurf/mcp_config.json` and add:
+
+```json
+{
+  "mcpServers": {
+    "clarvivo": {
+      "command": "npx",
+      "args": ["-y", "clarvivo-mcp"],
+      "env": {
+        "CLARVIVO_API_TOKEN": "clv_live_REPLACE_ME"
+      }
+    }
+  }
+}
+```
+
+Refresh the MCP list after saving. See [Windsurf’s MCP documentation](https://docs.windsurf.com/windsurf/cascade/mcp).
+
+### Cline
+
+Open Cline’s MCP Servers settings, choose **Configure MCP Servers**, and add this entry to `cline_mcp_settings.json` (normally under `~/.cline/data/settings/`):
+
+```json
+{
+  "mcpServers": {
+    "clarvivo": {
+      "command": "npx",
+      "args": ["-y", "clarvivo-mcp"],
+      "env": {
+        "CLARVIVO_API_TOKEN": "clv_live_REPLACE_ME"
+      },
+      "disabled": false
+    }
+  }
+}
+```
+
+See [Cline configuration locations](https://docs.cline.bot/getting-started/config).
+
+### Visual Studio Code / GitHub Copilot
+
+Create `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "clarvivo": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "clarvivo-mcp"],
+      "env": {
+        "CLARVIVO_API_TOKEN": "clv_live_REPLACE_ME"
+      }
+    }
+  }
+}
+```
+
+One-click install with a placeholder token:
+
+[Install Clarvivo in VS Code](vscode:mcp/install?%7B%22name%22%3A%22clarvivo%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40clarvivo%2Fmcp%22%5D%2C%22env%22%3A%7B%22CLARVIVO_API_TOKEN%22%3A%22clv_live_REPLACE_ME%22%7D%7D)
+
+VS Code’s URI uses URL-encoded JSON rather than Cursor’s base64 encoding. See the [VS Code MCP developer guide](https://code.visualstudio.com/api/extension-guides/ai/mcp) and [configuration reference](https://code.visualstudio.com/docs/agents/reference/mcp-configuration).
+
+### Zed
+
+Open your Zed settings file and merge:
+
+```json
+{
+  "context_servers": {
+    "clarvivo": {
+      "command": "npx",
+      "args": ["-y", "clarvivo-mcp"],
+      "env": {
+        "CLARVIVO_API_TOKEN": "clv_live_REPLACE_ME"
+      }
+    }
+  }
+}
+```
+
+See [MCP in Zed](https://zed.dev/docs/ai/mcp).
+
+### Generic MCP client
+
+For clients using the common `mcpServers` shape:
+
+```json
+{
+  "mcpServers": {
+    "clarvivo": {
+      "command": "npx",
+      "args": ["-y", "clarvivo-mcp"],
+      "env": {
+        "CLARVIVO_API_TOKEN": "clv_live_REPLACE_ME"
+      }
+    }
+  }
+}
+```
+
+Node.js 20 or newer is required.
+
+## Authentication and billing errors
+
+Every tool checks for `CLARVIVO_API_TOKEN` before doing work. If it is missing, the tool returns the token URL and a copy-pasteable environment variable name. The bearer token is never included in tool output or logs.
+
+Clarvivo has no free tier. If project creation returns `PROJECT_LIMIT_REACHED`, HTTP 402, or HTTP 403, the tool stops immediately and links to [billing](https://app.clarvivo.com/dashboard/billing). It does not retry or claim the project was created.
+
+## Development
+
+```bash
+cd mcp
+npm install
+npm run build
+npm test
+```
+
+Set `CLARVIVO_BASE_URL=http://127.0.0.1:5000` when using a local Clarvivo server. Tests mock HTTP and never call production.
+
+## Publishing checklist
+
+No submission happens automatically. Complete these after the package and public repository are ready:
+
+- [ ] **npm:** publish `clarvivo-mcp` publicly, confirm the `bin` is executable, and test a clean `npx -y @clarvivo/mcp` MCP initialize handshake. Use npm provenance/2FA and inspect `npm pack --dry-run` first.
+- [ ] **Official MCP Registry:** choose and add a verified `mcpName` to `package.json` (a GitHub-authenticated `io.github.<owner>/...` name or DNS-authenticated Clarvivo namespace), publish the matching npm version first, create `server.json` with stdio transport and required `CLARVIVO_API_TOKEN`, then run `mcp-publisher login`, `mcp-publisher validate`, and `mcp-publisher publish`. The registry stores metadata, not the package. Follow the [official registry quickstart](https://modelcontextprotocol.io/registry/quickstart).
+- [ ] **Smithery:** authenticate with the Smithery CLI and publish a local MCP bundle (`.mcpb`) under the Clarvivo namespace, or publish a hosted URL if an HTTP transport is added later: `smithery mcp publish <bundle.mcpb> -n clarvivo/clarvivo`. Smithery’s current publisher accepts hosted URLs or MCP bundles; see [Smithery CLI publishing](https://www.npmjs.com/package/@smithery/cli).
+- [ ] **mcp.so:** use the [server submission form](https://mcp.so/submit?type=server). It currently requires a public repository URL and name; the paid path is optional and advertises immediate publishing.
+- [ ] **PulseMCP:** use the site’s **Submit** flow and provide the public repository, npm install command, five-tool inventory, auth variable, license, and maintainer contact. Re-check the form at submission time because PulseMCP does not publish a stable submission schema.
+- [ ] **Glama:** click **Add Server** in the [Glama registry](https://glama.ai/mcp/servers), submit the public GitHub repository, and add `glama.json` if organization ownership/metadata verification requests it. Confirm Glama can inspect all five tools.
+- [ ] **Cursor Marketplace:** package the MCP config as an Agent Plugin or Cursor Plugin with a valid `plugin.json` / `.cursor-plugin/plugin.json`, public Git repository, README, and optional committed logo; declare the token variable in the manifest schema, then submit the repository at [cursor.com/marketplace/publish](https://cursor.com/marketplace/publish). Use the [official submission checklist](https://cursor.com/docs/reference/plugins).
+- [ ] **awesome-mcp-servers:** first ensure the Glama listing exists, then fork [punkpeye/awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers), add one alphabetized line in the appropriate category with repository link and concise description, and open a PR following its [contribution guide](https://github.com/punkpeye/awesome-mcp-servers/blob/main/CONTRIBUTING.md).
+- [ ] **Additional discovery:** submit the same canonical metadata to `mcpservers.org`, `MCP Central`, and `mcp-marketplace.io`; keep every listing pointed at the npm package and one canonical repository so versions and security notices do not drift.
+
+For every listing, use the same name, description, repository, license, token variable, Node requirement, five-tool inventory, and install snippets from this README.

package/dist/api.d.ts

@@ -0,0 +1,68 @@
+export interface ClarvivoProject {
+    id: number | string;
+    name: string;
+    domain: string;
+    apiKey: string;
+    [key: string]: unknown;
+}
+export interface AnalyticsRow {
+    date?: string;
+    pageviews?: number | string;
+    visitors?: number | string;
+    uniqueVisitors?: number | string;
+    sessions?: number | string;
+    topPages?: unknown;
+    pageDetails?: unknown;
+    topReferrers?: unknown;
+    trafficChannels?: unknown;
+    [key: string]: unknown;
+}
+export interface RealtimeSnapshot {
+    count?: number;
+    [key: string]: unknown;
+}
+export interface InstallStatus {
+    installed: boolean;
+    eventsReceived: number;
+    lastEventAt: string | null;
+    locked: boolean;
+    upgradeUrl?: string;
+}
+export interface ClarvivoApi {
+    listProjects(): Promise<ClarvivoProject[]>;
+    createProject(input: {
+        name: string;
+        domain: string;
+    }): Promise<ClarvivoProject>;
+    getInstallStatus(projectId: number | string): Promise<InstallStatus>;
+    getAnalytics(projectId: number | string, days: number): Promise<AnalyticsRow[]>;
+    getRealtime(projectId: number | string): Promise<RealtimeSnapshot>;
+}
+export declare class ClarvivoApiError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    constructor(message: string, status: number, code?: string | undefined);
+}
+export declare const DEFAULT_BASE_URL = "https://app.clarvivo.com";
+export declare function tokenSetupMessage(baseUrl?: string): string;
+export declare function planLimitMessage(baseUrl?: string): string;
+export declare function payToReadMessage(baseUrl?: string): string;
+export declare function requireToken(env?: NodeJS.ProcessEnv): string;
+export declare class HttpClarvivoApi implements ClarvivoApi {
+    private readonly fetchImpl;
+    private readonly baseUrl;
+    private readonly token;
+    constructor(env?: NodeJS.ProcessEnv, fetchImpl?: typeof fetch);
+    private request;
+    listProjects(): Promise<ClarvivoProject[]>;
+    createProject(input: {
+        name: string;
+        domain: string;
+    }): Promise<ClarvivoProject>;
+    getInstallStatus(projectId: number | string): Promise<InstallStatus>;
+    getAnalytics(projectId: number | string, days: number): Promise<AnalyticsRow[]>;
+    getRealtime(projectId: number | string): Promise<RealtimeSnapshot>;
+}
+export declare function isPlanLimit(error: unknown): boolean;
+export declare function isAnalyticsLockout(error: unknown): boolean;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/api.js

@@ -0,0 +1,85 @@
+export class ClarvivoApiError extends Error {
+    status;
+    code;
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = "ClarvivoApiError";
+    }
+}
+export const DEFAULT_BASE_URL = "https://app.clarvivo.com";
+export function tokenSetupMessage(baseUrl = process.env.CLARVIVO_BASE_URL || DEFAULT_BASE_URL) {
+    return `Clarvivo needs an API token. Open ${baseUrl.replace(/\/$/, "")}/dashboard/settings?tab=api-tokens, create a token, then set CLARVIVO_API_TOKEN=clv_live_<your-token> in this MCP server's environment and restart the client.`;
+}
+export function planLimitMessage(baseUrl = process.env.CLARVIVO_BASE_URL || DEFAULT_BASE_URL) {
+    return `Your Clarvivo plan cannot create another project. Open ${baseUrl.replace(/\/$/, "")}/dashboard/billing — checkout takes about 30 seconds — then re-run setup_analytics.`;
+}
+export function payToReadMessage(baseUrl = process.env.CLARVIVO_BASE_URL || DEFAULT_BASE_URL) {
+    return `Pay $1 to read your Clarvivo data. Open ${baseUrl.replace(/\/$/, "")}/dashboard/billing, then re-run get_stats.`;
+}
+export function requireToken(env = process.env) {
+    const token = env.CLARVIVO_API_TOKEN?.trim();
+    if (!token)
+        throw new Error(tokenSetupMessage(env.CLARVIVO_BASE_URL || DEFAULT_BASE_URL));
+    return token;
+}
+export class HttpClarvivoApi {
+    fetchImpl;
+    baseUrl;
+    token;
+    constructor(env = process.env, fetchImpl = fetch) {
+        this.fetchImpl = fetchImpl;
+        this.baseUrl = (env.CLARVIVO_BASE_URL || DEFAULT_BASE_URL).replace(/\/$/, "");
+        this.token = requireToken(env);
+    }
+    async request(pathname, init = {}) {
+        const response = await this.fetchImpl(`${this.baseUrl}${pathname}`, {
+            ...init,
+            headers: {
+                Accept: "application/json",
+                ...(init.body ? { "Content-Type": "application/json" } : {}),
+                ...init.headers,
+                Authorization: `Bearer ${this.token}`,
+            },
+        });
+        const text = await response.text();
+        let body;
+        try {
+            body = text ? JSON.parse(text) : undefined;
+        }
+        catch {
+            body = text;
+        }
+        if (!response.ok) {
+            const object = body && typeof body === "object" ? body : {};
+            throw new ClarvivoApiError(typeof object.message === "string" ? object.message : `Clarvivo API request failed (${response.status}).`, response.status, typeof object.code === "string" ? object.code : undefined);
+        }
+        return body;
+    }
+    listProjects() {
+        return this.request("/api/projects");
+    }
+    createProject(input) {
+        return this.request("/api/projects", { method: "POST", body: JSON.stringify(input) });
+    }
+    getInstallStatus(projectId) {
+        return this.request(`/api/projects/${encodeURIComponent(String(projectId))}/install-status`);
+    }
+    getAnalytics(projectId, days) {
+        return this.request(`/api/projects/${encodeURIComponent(String(projectId))}/analytics?days=${days}`);
+    }
+    getRealtime(projectId) {
+        return this.request(`/api/projects/${encodeURIComponent(String(projectId))}/realtime/active`);
+    }
+}
+export function isPlanLimit(error) {
+    return error instanceof ClarvivoApiError && (error.code === "PROJECT_LIMIT_REACHED" ||
+        error.code === "PAYMENT_REQUIRED_FOR_MORE_PROJECTS" ||
+        error.status === 402 ||
+        error.status === 403);
+}
+export function isAnalyticsLockout(error) {
+    return error instanceof ClarvivoApiError && error.status === 402;
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/frameworks.d.ts

@@ -0,0 +1,21 @@
+export declare const frameworkIds: readonly ["next-app", "next-pages", "vite", "create-react-app", "astro", "sveltekit", "nuxt", "remix", "gatsby", "docusaurus", "static-html"];
+export type FrameworkId = (typeof frameworkIds)[number];
+export interface FrameworkDetection {
+    framework: FrameworkId;
+    confidence: "high" | "medium";
+    evidence: string[];
+}
+export interface InstallInstructions {
+    framework: FrameworkId;
+    frameworkName: string;
+    file: string;
+    placement: string;
+    code: string;
+    snippet: string;
+    spaRouteTracking: string;
+}
+export declare function normalizeFramework(value: string): FrameworkId;
+export declare function detectFramework(root?: string): FrameworkDetection | undefined;
+export declare function trackingSnippet(apiKey: string, baseUrl?: string): string;
+export declare function getInstallInstructions(framework: FrameworkId, apiKey: string, baseUrl?: string, root?: string): InstallInstructions;
+//# sourceMappingURL=frameworks.d.ts.map

package/dist/frameworks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworks.d.ts","sourceRoot":"","sources":["../src/frameworks.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,+IAYf,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,WAAW,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,WAAW,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AA+CD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAS7D;AA4BD,wBAAgB,eAAe,CAAC,IAAI,SAAgB,GAAG,kBAAkB,GAAG,SAAS,CA6DpF;AAmBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,SAA6B,GAAG,MAAM,CAE5F;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,SAA6B,EACpC,IAAI,SAAgB,GACnB,mBAAmB,CAoCrB"}

package/dist/frameworks.js

@@ -0,0 +1,202 @@
+import fs from "node:fs";
+import path from "node:path";
+export const frameworkIds = [
+    "next-app",
+    "next-pages",
+    "vite",
+    "create-react-app",
+    "astro",
+    "sveltekit",
+    "nuxt",
+    "remix",
+    "gatsby",
+    "docusaurus",
+    "static-html",
+];
+const names = {
+    "next-app": "Next.js App Router",
+    "next-pages": "Next.js Pages Router",
+    vite: "Vite (React, Vue, or Svelte)",
+    "create-react-app": "Create React App",
+    astro: "Astro",
+    sveltekit: "SvelteKit",
+    nuxt: "Nuxt",
+    remix: "Remix / React Router v7",
+    gatsby: "Gatsby",
+    docusaurus: "Docusaurus",
+    "static-html": "Plain static HTML",
+};
+const aliases = {
+    "next-app": "next-app",
+    "next.js-app-router": "next-app",
+    "nextjs-app": "next-app",
+    "next-app-router": "next-app",
+    "next-pages": "next-pages",
+    "next.js-pages-router": "next-pages",
+    "nextjs-pages": "next-pages",
+    "next-pages-router": "next-pages",
+    vite: "vite",
+    react: "vite",
+    vue: "vite",
+    "vite-react": "vite",
+    "vite-vue": "vite",
+    "vite-svelte": "vite",
+    cra: "create-react-app",
+    "create-react-app": "create-react-app",
+    astro: "astro",
+    sveltekit: "sveltekit",
+    "svelte-kit": "sveltekit",
+    nuxt: "nuxt",
+    remix: "remix",
+    "react-router": "remix",
+    "react-router-v7": "remix",
+    gatsby: "gatsby",
+    docusaurus: "docusaurus",
+    html: "static-html",
+    static: "static-html",
+    "static-html": "static-html",
+};
+export function normalizeFramework(value) {
+    const normalized = value.trim().toLowerCase().replace(/[_\s]+/g, "-");
+    const framework = aliases[normalized];
+    if (!framework) {
+        throw new Error(`Unsupported framework "${value}". Use one of: ${frameworkIds.join(", ")}.`);
+    }
+    return framework;
+}
+function exists(root, relative) {
+    return fs.existsSync(path.join(root, relative));
+}
+function firstExisting(root, candidates) {
+    return candidates.find((candidate) => exists(root, candidate));
+}
+function readPackage(root) {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
+        return { ...pkg.dependencies, ...pkg.devDependencies };
+    }
+    catch {
+        return {};
+    }
+}
+function hasConfig(root, basename) {
+    return ["js", "mjs", "cjs", "ts", "mts", "cts"].some((ext) => exists(root, `${basename}.${ext}`));
+}
+export function detectFramework(root = process.cwd()) {
+    const deps = readPackage(root);
+    const evidence = [];
+    if (deps.next || hasConfig(root, "next.config")) {
+        if (deps.next)
+            evidence.push("package.json includes next");
+        if (hasConfig(root, "next.config"))
+            evidence.push("next.config.* exists");
+        const appMarker = firstExisting(root, [
+            "app/layout.tsx", "app/layout.jsx", "app/layout.js", "app/layout.ts",
+            "src/app/layout.tsx", "src/app/layout.jsx", "src/app/layout.js", "src/app/layout.ts",
+        ]);
+        if (appMarker) {
+            return { framework: "next-app", confidence: "high", evidence: [...evidence, `${appMarker} exists`] };
+        }
+        const pagesMarker = firstExisting(root, [
+            "pages/_app.tsx", "pages/_app.jsx", "pages/_app.js", "pages/index.tsx", "pages/index.jsx", "pages/index.js",
+            "src/pages/_app.tsx", "src/pages/_app.jsx", "src/pages/_app.js", "src/pages/index.tsx", "src/pages/index.jsx", "src/pages/index.js",
+        ]);
+        return {
+            framework: "next-pages",
+            confidence: pagesMarker ? "high" : "medium",
+            evidence: pagesMarker ? [...evidence, `${pagesMarker} exists`] : evidence,
+        };
+    }
+    if (deps["@sveltejs/kit"] || (exists(root, "svelte.config.js") && exists(root, "src/app.html"))) {
+        return {
+            framework: "sveltekit",
+            confidence: "high",
+            evidence: deps["@sveltejs/kit"] ? ["package.json includes @sveltejs/kit"] : ["svelte.config.js and src/app.html exist"],
+        };
+    }
+    if (deps.astro || hasConfig(root, "astro.config")) {
+        return { framework: "astro", confidence: "high", evidence: [deps.astro ? "package.json includes astro" : "astro.config.* exists"] };
+    }
+    if (deps.nuxt || hasConfig(root, "nuxt.config")) {
+        return { framework: "nuxt", confidence: "high", evidence: [deps.nuxt ? "package.json includes nuxt" : "nuxt.config.* exists"] };
+    }
+    if (deps["@docusaurus/core"] || hasConfig(root, "docusaurus.config")) {
+        return { framework: "docusaurus", confidence: "high", evidence: [deps["@docusaurus/core"] ? "package.json includes @docusaurus/core" : "docusaurus.config.* exists"] };
+    }
+    if (deps.gatsby || hasConfig(root, "gatsby.config")) {
+        return { framework: "gatsby", confidence: "high", evidence: [deps.gatsby ? "package.json includes gatsby" : "gatsby.config.* exists"] };
+    }
+    if (deps["@remix-run/react"] || deps["@react-router/dev"] || hasConfig(root, "react-router.config") || hasConfig(root, "remix.config")) {
+        return {
+            framework: "remix",
+            confidence: "high",
+            evidence: [deps["@remix-run/react"] ? "package.json includes @remix-run/react" : deps["@react-router/dev"] ? "package.json includes @react-router/dev" : "Remix/React Router config exists"],
+        };
+    }
+    if (deps["react-scripts"]) {
+        return { framework: "create-react-app", confidence: "high", evidence: ["package.json includes react-scripts"] };
+    }
+    if (deps.vite || hasConfig(root, "vite.config")) {
+        return { framework: "vite", confidence: "high", evidence: [deps.vite ? "package.json includes vite" : "vite.config.* exists"] };
+    }
+    if (exists(root, "index.html")) {
+        return { framework: "static-html", confidence: "medium", evidence: ["index.html exists and no supported framework marker was found"] };
+    }
+    return undefined;
+}
+function preferredFile(framework, root) {
+    const choices = {
+        "next-app": ["app/layout.tsx", "src/app/layout.tsx", "app/layout.jsx", "src/app/layout.jsx", "app/layout.js", "src/app/layout.js"],
+        "next-pages": ["pages/_app.tsx", "src/pages/_app.tsx", "pages/_app.jsx", "src/pages/_app.jsx", "pages/_app.js", "src/pages/_app.js"],
+        vite: ["index.html"],
+        "create-react-app": ["public/index.html"],
+        astro: ["src/layouts/Layout.astro", "src/layouts/BaseLayout.astro", "src/pages/index.astro"],
+        sveltekit: ["src/app.html"],
+        nuxt: ["nuxt.config.ts", "nuxt.config.js"],
+        remix: ["app/root.tsx", "app/root.jsx", "app/root.js"],
+        gatsby: ["gatsby-ssr.tsx", "gatsby-ssr.jsx", "gatsby-ssr.js"],
+        docusaurus: ["docusaurus.config.ts", "docusaurus.config.js"],
+        "static-html": ["index.html"],
+    };
+    return firstExisting(root, choices[framework]) ?? choices[framework][0];
+}
+export function trackingSnippet(apiKey, baseUrl = "https://app.clarvivo.com") {
+    return `<script defer src="${baseUrl.replace(/\/$/, "")}/js/${apiKey}/analytics.js"></script>`;
+}
+export function getInstallInstructions(framework, apiKey, baseUrl = "https://app.clarvivo.com", root = process.cwd()) {
+    const src = `${baseUrl.replace(/\/$/, "")}/js/${apiKey}/analytics.js`;
+    const snippet = trackingSnippet(apiKey, baseUrl);
+    const file = preferredFile(framework, root);
+    const common = {
+        framework,
+        frameworkName: names[framework],
+        file,
+        snippet,
+        spaRouteTracking: "No router hook is needed: the Clarvivo tracker automatically observes pushState, replaceState, and popstate route changes.",
+    };
+    switch (framework) {
+        case "next-app":
+            return { ...common, placement: "Import Script, then render it inside the root layout's <body>.", code: `import Script from "next/script";\n\n// Inside <body>, after {children}:\n<Script src="${src}" strategy="afterInteractive" />` };
+        case "next-pages":
+            return { ...common, placement: "Import Script in the custom App and render it after <Component />. Create the file if it does not exist.", code: `import type { AppProps } from "next/app";\nimport Script from "next/script";\n\nexport default function App({ Component, pageProps }: AppProps) {\n  return (\n    <>\n      <Component {...pageProps} />\n      <Script src="${src}" strategy="afterInteractive" />\n    </>\n  );\n}` };
+        case "vite":
+            return { ...common, placement: "Add this immediately before </head> in the root index.html.", code: snippet };
+        case "create-react-app":
+            return { ...common, placement: "Add this immediately before </head> in public/index.html.", code: snippet };
+        case "astro":
+            return { ...common, placement: "Add this inside <head> in the shared layout used by every page.", code: snippet };
+        case "sveltekit":
+            return { ...common, placement: "Add this inside <head>, directly after %sveltekit.head%.", code: `%sveltekit.head%\n    ${snippet}` };
+        case "nuxt":
+            return { ...common, placement: "Merge this app.head entry into defineNuxtConfig (preserve existing config keys).", code: `export default defineNuxtConfig({\n  app: {\n    head: {\n      script: [{ src: "${src}", defer: true }],\n    },\n  },\n});` };
+        case "remix":
+            return { ...common, placement: "Add this script inside <head> in the root document returned by app/root.tsx.", code: snippet };
+        case "gatsby":
+            return { ...common, placement: "Add this SSR hook (merge it with an existing onRenderBody export if present).", code: `import React from "react";\n\nexport const onRenderBody = ({ setHeadComponents }) => {\n  setHeadComponents([\n    <script key="clarvivo" defer src="${src}" />,\n  ]);\n};` };
+        case "docusaurus":
+            return { ...common, placement: "Merge this scripts entry into the exported Docusaurus config.", code: `scripts: [\n  { src: "${src}", defer: true },\n],` };
+        case "static-html":
+            return { ...common, placement: "Add this immediately before </head> on every page (or in the shared HTML template).", code: snippet };
+    }
+}
+//# sourceMappingURL=frameworks.js.map

package/dist/frameworks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworks.js","sourceRoot":"","sources":["../src/frameworks.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+const server = createServer();
+await server.connect(new StdioServerTransport());
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAC9B,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,YAAY,IAAI,SAAS,CAoDxC"}

package/dist/server.js

@@ -0,0 +1,51 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { createToolHandlers } from "./tools.js";
+export function createServer() {
+    const server = new McpServer({ name: "clarvivo", version: "0.1.0" });
+    const handlers = createToolHandlers();
+    const projectId = z.union([z.number(), z.string()]).describe("Clarvivo project ID");
+    server.registerTool("setup_analytics", {
+        title: "Set up Clarvivo analytics",
+        description: "Detect this repository's framework, reuse or create the Clarvivo project for a domain, and return the exact file and code edit. Use this first when asked to add analytics.",
+        inputSchema: {
+            name: z.string().min(1).optional().describe("Project name; defaults to a readable name derived from domain"),
+            domain: z.string().min(1).describe("Production hostname, for example example.com"),
+            framework: z.string().min(1).optional().describe("Optional override such as next-app, next-pages, vite, astro, sveltekit, nuxt, remix, gatsby, docusaurus, or static-html"),
+        },
+        annotations: { idempotentHint: true },
+    }, handlers.setupAnalytics);
+    server.registerTool("get_install_snippet", {
+        title: "Get framework install instructions",
+        description: "Return the exact tracking snippet, target file, placement, and framework-specific code for an existing Clarvivo API key or project.",
+        inputSchema: {
+            apiKey: z.string().min(1).optional().describe("Public Clarvivo tracking API key"),
+            projectId: projectId.optional(),
+            framework: z.string().min(1).describe("Target framework"),
+        },
+        annotations: { readOnlyHint: true, idempotentHint: true },
+    }, handlers.getInstallSnippet);
+    server.registerTool("verify_installation", {
+        title: "Verify analytics installation",
+        description: "Check Clarvivo's proof-of-life receipt to confirm that traffic from the deployed site has arrived, without reading analytics or sending synthetic events.",
+        inputSchema: { projectId },
+        annotations: { readOnlyHint: true, idempotentHint: true },
+    }, handlers.verifyInstallation);
+    server.registerTool("list_projects", {
+        title: "List Clarvivo projects",
+        description: "List accessible Clarvivo projects with their IDs, domains, and public tracking API keys.",
+        inputSchema: {},
+        annotations: { readOnlyHint: true, idempotentHint: true },
+    }, handlers.listProjects);
+    server.registerTool("get_stats", {
+        title: "Get compact traffic stats",
+        description: "Return a small pre-summarised traffic overview, active visitor count, and top five pages/referrers instead of raw daily analytics rows.",
+        inputSchema: {
+            projectId,
+            days: z.number().int().min(1).max(90).default(7).describe("Reporting window from 1 to 90 days"),
+        },
+        annotations: { readOnlyHint: true, idempotentHint: true },
+    }, handlers.getStats);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools.d.ts

@@ -0,0 +1,45 @@
+import { type AnalyticsRow, type ClarvivoApi } from "./api.js";
+export interface ToolContext {
+    env?: NodeJS.ProcessEnv;
+    cwd?: string;
+    api?: ClarvivoApi;
+}
+type ToolSuccess = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent: Record<string, unknown>;
+};
+type ToolFailure = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+};
+export type ToolResult = ToolSuccess | ToolFailure;
+export declare function summarizeStats(rows: AnalyticsRow[], realtimeCount: number, days: number): Record<string, unknown>;
+export declare function createToolHandlers(context?: ToolContext): {
+    setupAnalytics: (input: {
+        name?: string;
+        domain: string;
+        framework?: string;
+    }) => Promise<ToolResult>;
+    getInstallSnippet: (input: {
+        apiKey?: string;
+        projectId?: number | string;
+        framework: string;
+    }) => Promise<ToolResult>;
+    verifyInstallation: (input: {
+        projectId: number | string;
+    }) => Promise<ToolResult>;
+    listProjects: () => Promise<ToolResult>;
+    getStats: (input: {
+        projectId: number | string;
+        days?: number;
+    }) => Promise<ToolResult>;
+};
+export declare function workingDirectoryLabel(cwd?: string): string;
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,WAAW,EAOjB,MAAM,UAAU,CAAC;AAQlB,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,WAAW,CAAC;CACnB;AAED,KAAK,WAAW,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAClH,KAAK,WAAW,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC;AACrF,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAgFnD,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBjH;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,WAAgB;4BAK1B;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,UAAU,CAAC;+BAwBxE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,UAAU,CAAC;gCAmBxF;QAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,UAAU,CAAC;wBAyB9D,OAAO,CAAC,UAAU,CAAC;sBASnB;QAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,UAAU,CAAC;EAW9F;AAED,wBAAgB,qBAAqB,CAAC,GAAG,SAAgB,GAAG,MAAM,CAEjE"}

package/dist/tools.js

@@ -0,0 +1,198 @@
+import path from "node:path";
+import { HttpClarvivoApi, isAnalyticsLockout, isPlanLimit, payToReadMessage, planLimitMessage, requireToken, } from "./api.js";
+import { detectFramework, getInstallInstructions, normalizeFramework, } from "./frameworks.js";
+function success(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }], structuredContent: data };
+}
+function failure(error, env, mode) {
+    const message = mode === "project-limit" && isPlanLimit(error)
+        ? planLimitMessage(env.CLARVIVO_BASE_URL)
+        : mode === "analytics-lockout" && isAnalyticsLockout(error)
+            ? payToReadMessage(env.CLARVIVO_BASE_URL)
+            : error instanceof Error ? error.message : "Clarvivo request failed.";
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+function canonicalDomain(input) {
+    const value = input.trim();
+    if (!value)
+        throw new Error("domain is required.");
+    try {
+        const url = new URL(value.includes("://") ? value : `https://${value}`);
+        return url.hostname.toLowerCase().replace(/^www\./, "").replace(/\.$/, "");
+    }
+    catch {
+        throw new Error(`"${input}" is not a valid domain. Use a hostname such as example.com.`);
+    }
+}
+function defaultProjectName(domain) {
+    return domain.split(".")[0].replace(/[-_]+/g, " ").replace(/\b\w/g, (letter) => letter.toUpperCase());
+}
+function resolveApi(context) {
+    requireToken(context.env ?? process.env);
+    return context.api ?? new HttpClarvivoApi(context.env ?? process.env);
+}
+function baseUrl(context) {
+    return (context.env?.CLARVIVO_BASE_URL || process.env.CLARVIVO_BASE_URL || "https://app.clarvivo.com").replace(/\/$/, "");
+}
+function projectMatchesDomain(projectDomain, domain) {
+    try {
+        return canonicalDomain(projectDomain) === domain;
+    }
+    catch {
+        return projectDomain.trim().toLowerCase() === domain;
+    }
+}
+function chooseFramework(explicit, cwd) {
+    if (explicit)
+        return { framework: normalizeFramework(explicit) };
+    const detection = detectFramework(cwd);
+    if (!detection) {
+        throw new Error("Could not detect the framework. Pass framework explicitly (for example: next-app, vite, astro, or static-html). No project was created.");
+    }
+    return { framework: detection.framework, detection };
+}
+function number(value) {
+    const parsed = typeof value === "number" ? value : Number(value ?? 0);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+function array(value) {
+    return Array.isArray(value) ? value.filter((item) => Boolean(item) && typeof item === "object") : [];
+}
+function topEntries(rows, keys, labelKeys, valueKeys) {
+    const totals = new Map();
+    for (const row of rows) {
+        for (const key of keys) {
+            for (const item of array(row[key])) {
+                const name = labelKeys.map((candidate) => item[candidate]).find((value) => typeof value === "string");
+                if (!name)
+                    continue;
+                const count = valueKeys.map((candidate) => item[candidate]).find((value) => value !== undefined);
+                totals.set(name, (totals.get(name) ?? 0) + number(count));
+            }
+        }
+    }
+    return [...totals.entries()].map(([name, count]) => ({ name, count })).sort((a, b) => b.count - a.count).slice(0, 5);
+}
+export function summarizeStats(rows, realtimeCount, days) {
+    const totals = rows.reduce((acc, row) => ({
+        pageviews: acc.pageviews + number(row.pageviews),
+        uniqueVisitors: acc.uniqueVisitors + number(row.uniqueVisitors ?? row.visitors),
+        sessions: acc.sessions + number(row.sessions),
+    }), { pageviews: 0, uniqueVisitors: 0, sessions: 0 });
+    const channels = new Map();
+    for (const row of rows) {
+        if (!row.trafficChannels || typeof row.trafficChannels !== "object" || Array.isArray(row.trafficChannels))
+            continue;
+        for (const [name, count] of Object.entries(row.trafficChannels)) {
+            channels.set(name, (channels.get(name) ?? 0) + number(count));
+        }
+    }
+    return {
+        days,
+        ...totals,
+        activeNow: realtimeCount,
+        topPages: topEntries(rows, ["topPages", "pageDetails"], ["path", "page"], ["views", "pageviews"]),
+        topReferrers: topEntries(rows, ["topReferrers"], ["source", "referrer"], ["visitors", "visits", "count"]),
+        trafficChannels: [...channels.entries()].map(([name, count]) => ({ name, count })).sort((a, b) => b.count - a.count).slice(0, 6),
+    };
+}
+export function createToolHandlers(context = {}) {
+    const env = context.env ?? process.env;
+    const cwd = context.cwd ?? process.cwd();
+    return {
+        setupAnalytics: async (input) => {
+            try {
+                const api = resolveApi(context);
+                const domain = canonicalDomain(input.domain);
+                const selected = chooseFramework(input.framework, cwd);
+                const projects = await api.listProjects();
+                let project = projects.find((candidate) => projectMatchesDomain(candidate.domain, domain));
+                const reused = Boolean(project);
+                if (!project) {
+                    project = await api.createProject({ name: input.name?.trim() || defaultProjectName(domain), domain });
+                }
+                const install = getInstallInstructions(selected.framework, project.apiKey, baseUrl(context), cwd);
+                return success({
+                    project: { id: project.id, name: project.name, domain: project.domain, apiKey: project.apiKey },
+                    reusedExistingProject: reused,
+                    detection: selected.detection,
+                    install,
+                    nextStep: `Edit ${install.file} exactly as described, deploy the site, then run verify_installation with projectId ${project.id}.`,
+                });
+            }
+            catch (error) {
+                return failure(error, env, "project-limit");
+            }
+        },
+        getInstallSnippet: async (input) => {
+            try {
+                const api = resolveApi(context);
+                let apiKey = input.apiKey?.trim();
+                let projectId = input.projectId;
+                if (!apiKey) {
+                    if (projectId === undefined)
+                        throw new Error("Provide apiKey or projectId.");
+                    const project = (await api.listProjects()).find((candidate) => String(candidate.id) === String(projectId));
+                    if (!project)
+                        throw new Error(`Project ${projectId} was not found.`);
+                    apiKey = project.apiKey;
+                    projectId = project.id;
+                }
+                const framework = normalizeFramework(input.framework);
+                return success({ projectId, apiKey, install: getInstallInstructions(framework, apiKey, baseUrl(context), cwd) });
+            }
+            catch (error) {
+                return failure(error, env);
+            }
+        },
+        verifyInstallation: async (input) => {
+            try {
+                const api = resolveApi(context);
+                const status = await api.getInstallStatus(input.projectId);
+                const count = number(status.eventsReceived);
+                const upgradeUrl = status.upgradeUrl || `${baseUrl(context)}/dashboard/billing`;
+                const baseMessage = status.installed
+                    ? `Your tracking is live. ${count.toLocaleString("en-US")} pageviews recorded.`
+                    : "No real traffic has arrived yet. Deploy the snippet, visit the live site, navigate to another route, wait up to 90 seconds, then run this check again.";
+                return success({
+                    projectId: input.projectId,
+                    installed: status.installed,
+                    eventsReceived: count,
+                    lastEventAt: status.lastEventAt,
+                    locked: status.locked,
+                    ...(status.locked ? { upgradeUrl } : {}),
+                    message: status.locked
+                        ? `${baseMessage} Pay $1 to read your data: ${upgradeUrl}`
+                        : baseMessage,
+                });
+            }
+            catch (error) {
+                return failure(error, env, "analytics-lockout");
+            }
+        },
+        listProjects: async () => {
+            try {
+                const projects = await resolveApi(context).listProjects();
+                return success({ projects: projects.map(({ id, name, domain, apiKey }) => ({ id, name, domain, apiKey })), count: projects.length });
+            }
+            catch (error) {
+                return failure(error, env);
+            }
+        },
+        getStats: async (input) => {
+            try {
+                const api = resolveApi(context);
+                const days = Math.max(1, Math.min(90, Math.round(input.days ?? 7)));
+                const [rows, realtime] = await Promise.all([api.getAnalytics(input.projectId, days), api.getRealtime(input.projectId)]);
+                return success({ projectId: input.projectId, ...summarizeStats(rows, number(realtime.count), days) });
+            }
+            catch (error) {
+                return failure(error, env, "analytics-lockout");
+            }
+        },
+    };
+}
+export function workingDirectoryLabel(cwd = process.cwd()) {
+    return path.basename(cwd) || cwd;
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@clarvivo/mcp",
+  "version": "0.1.0",
+  "description": "Install Clarvivo analytics from your coding agent, then query compact traffic stats.",
+  "type": "module",
+  "bin": {
+    "clarvivo-mcp": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "clarvivo",
+    "analytics",
+    "mcp",
+    "model-context-protocol"
+  ],
+  "homepage": "https://app.clarvivo.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cracked-collective/clarvivo-mcp.git"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^22.18.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "mcpName": "io.github.cracked-collective/clarvivo-mcp"
+}