@zgeoff/umami-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Geoff Whatley
+Portions derived from umami-mcp-server, Copyright (c) 2026 Alessandro Ferrini
+
+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,51 @@
+# @zgeoff/umami-mcp
+
+A [Model Context Protocol](https://modelcontextprotocol.io/) server exposing [Umami](https://umami.is/) analytics — Cloud and self-hosted — as read-only tools.
+
+> A TypeScript port of [Alurith/umami-mcp-server](https://github.com/Alurith/umami-mcp-server) (Python, MIT) by Alessandro Ferrini — tool surface and behaviour mirror the original; all credit for the design to its author.
+
+## Tools
+
+All tools are read-only.
+
+- `get_websites` — list websites, with pagination and search
+- `get_stats` — summary statistics for a time range
+- `get_pageviews` — pageview/session series bucketed by hour/day/month/year
+- `get_metrics` — ranked breakdowns (url, referrer, browser, country, event, …)
+- `get_active` — visitors active in the last 5 minutes
+
+## Configuration
+
+Auth is one of two modes:
+
+| Variable | Mode | Notes |
+| --- | --- | --- |
+| `UMAMI_API_KEY` | Umami Cloud | required for Cloud; wins when both modes are set |
+| `UMAMI_USERNAME` + `UMAMI_PASSWORD` | self-hosted | rejected against Umami Cloud |
+| `UMAMI_API_BASE` | both | API root; defaults to `https://api.umami.is/v1`. Self-hosted: `https://your-umami.example/api` |
+
+## Usage
+
+```json
+{
+  "mcpServers": {
+    "umami": {
+      "command": "npx",
+      "args": ["-y", "@zgeoff/umami-mcp"],
+      "env": {
+        "UMAMI_API_BASE": "https://your-umami.example/api",
+        "UMAMI_USERNAME": "admin",
+        "UMAMI_PASSWORD": "…"
+      }
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+npm install
+npm test
+npm run build
+```

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,189 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { loadSettings } from './settings.js';
+import { UmamiClient } from './umami-client.js';
+/**
+ * Query filters shared by the stats, pageviews, and metrics tools. Mirrors the fields the Umami
+ * API accepts; absent fields are simply omitted from the request.
+ */
+const filtersShape = {
+    path: z.string().optional().describe('Filter by URL path'),
+    referrer: z.string().optional().describe('Filter by referrer'),
+    title: z.string().optional().describe('Filter by page title'),
+    query: z.string().optional().describe('Filter by query string'),
+    browser: z.string().optional().describe('Filter by browser'),
+    os: z.string().optional().describe('Filter by operating system'),
+    device: z.string().optional().describe('Filter by device type'),
+    country: z.string().optional().describe('Filter by country code'),
+    region: z.string().optional().describe('Filter by region'),
+    city: z.string().optional().describe('Filter by city'),
+    hostname: z.string().optional().describe('Filter by hostname'),
+    tag: z.string().optional().describe('Filter by tag'),
+    segment: z.string().optional().describe('Filter by segment id'),
+    cohort: z.string().optional().describe('Filter by cohort id'),
+};
+const filtersSchema = z.object(filtersShape).optional().describe('Optional result filters');
+const startAtSchema = z
+    .string()
+    .datetime({ offset: true })
+    .optional()
+    .describe('Range start as an ISO 8601 timestamp; defaults to 7 days before the range end');
+const endAtSchema = z
+    .string()
+    .datetime({ offset: true })
+    .optional()
+    .describe('Range end as an ISO 8601 timestamp; defaults to now');
+/**
+ * Umami expects epoch-millisecond `startAt`/`endAt` query params; tools accept ISO strings and
+ * default to the trailing 7 days.
+ */
+function toTimerangeQuery(startAt, endAt) {
+    const end = endAt !== undefined ? new Date(endAt).getTime() : Date.now();
+    const start = startAt !== undefined ? new Date(startAt).getTime() : end - 7 * 24 * 3600 * 1000;
+    if (end <= start) {
+        throw new Error('end_at must be after start_at');
+    }
+    return { startAt: String(start), endAt: String(end) };
+}
+function toFiltersQuery(filters) {
+    return Object.fromEntries(Object.entries(filters ?? {}).filter(([, value]) => value !== undefined));
+}
+function toToolResult(payload) {
+    return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
+}
+function toErrorResult(error) {
+    return {
+        content: [{ type: 'text', text: error instanceof Error ? error.message : String(error) }],
+        isError: true,
+    };
+}
+const READ_ONLY = { readOnlyHint: true, destructiveHint: false, openWorldHint: true };
+async function main() {
+    const settings = loadSettings();
+    const client = new UmamiClient(settings);
+    const server = new McpServer({ name: 'umami-mcp', version: '0.1.0' });
+    server.registerTool('get_websites', {
+        title: 'List websites',
+        description: 'List the websites the account can access, with pagination and search.',
+        annotations: READ_ONLY,
+        inputSchema: {
+            include_teams: z.boolean().default(false).describe('Include team websites'),
+            search: z.string().optional().describe('Search term to filter websites'),
+            page: z.number().int().min(1).default(1).describe('Page number'),
+            page_size: z.number().int().min(1).max(200).default(10).describe('Results per page'),
+        },
+    }, async ({ include_teams, search, page, page_size }) => {
+        try {
+            return toToolResult(await client.getWebsites({
+                includeTeams: include_teams,
+                search,
+                page,
+                pageSize: page_size,
+            }));
+        }
+        catch (error) {
+            return toErrorResult(error);
+        }
+    });
+    server.registerTool('get_stats', {
+        title: 'Get visitor statistics',
+        description: 'Summary statistics for a website over a time range: pageviews, visitors, visits, bounces, total time.',
+        annotations: READ_ONLY,
+        inputSchema: {
+            website_id: z.string().describe('Website id (from get_websites)'),
+            start_at: startAtSchema,
+            end_at: endAtSchema,
+            filters: filtersSchema,
+        },
+    }, async ({ website_id, start_at, end_at, filters }) => {
+        try {
+            return toToolResult(await client.getStats(website_id, {
+                ...toTimerangeQuery(start_at, end_at),
+                ...toFiltersQuery(filters),
+            }));
+        }
+        catch (error) {
+            return toErrorResult(error);
+        }
+    });
+    server.registerTool('get_pageviews', {
+        title: 'Get pageviews over time',
+        description: 'Pageview and session series for a website, bucketed by hour, day, month, or year.',
+        annotations: READ_ONLY,
+        inputSchema: {
+            website_id: z.string().describe('Website id (from get_websites)'),
+            start_at: startAtSchema,
+            end_at: endAtSchema,
+            unit: z.enum(['hour', 'day', 'month', 'year']).default('day').describe('Bucket size'),
+            timezone: z.string().default('UTC').describe('IANA timezone for bucketing'),
+            compare: z.enum(['prev', 'yoy']).optional().describe('Comparison window: previous period or year-over-year'),
+            filters: filtersSchema,
+        },
+    }, async ({ website_id, start_at, end_at, unit, timezone, compare, filters }) => {
+        try {
+            return toToolResult(await client.getPageviews(website_id, {
+                ...toTimerangeQuery(start_at, end_at),
+                unit,
+                timezone,
+                ...(compare !== undefined ? { compare } : {}),
+                ...toFiltersQuery(filters),
+            }));
+        }
+        catch (error) {
+            return toErrorResult(error);
+        }
+    });
+    server.registerTool('get_metrics', {
+        title: 'Get metrics breakdown',
+        description: 'Ranked metrics for a website over a time range: type is one of url, referrer, browser, os, device, country, region, city, language, screen, event, hostname, tag.',
+        annotations: READ_ONLY,
+        inputSchema: {
+            website_id: z.string().describe('Website id (from get_websites)'),
+            type: z.string().describe('Metric type, e.g. url, referrer, browser, country, event'),
+            start_at: startAtSchema,
+            end_at: endAtSchema,
+            limit: z.number().int().min(1).max(500).default(500).describe('Maximum results'),
+            offset: z.number().int().min(0).default(0).describe('Result offset'),
+            expanded: z.boolean().default(false).describe('Use the expanded metrics endpoint'),
+            filters: filtersSchema,
+        },
+    }, async ({ website_id, type, start_at, end_at, limit, offset, expanded, filters }) => {
+        try {
+            return toToolResult(await client.getMetrics(website_id, expanded, {
+                ...toTimerangeQuery(start_at, end_at),
+                type,
+                limit: String(limit),
+                offset: String(offset),
+                ...toFiltersQuery(filters),
+            }));
+        }
+        catch (error) {
+            return toErrorResult(error);
+        }
+    });
+    server.registerTool('get_active', {
+        title: 'Get active visitors',
+        description: 'Number of visitors active on the website within the last 5 minutes.',
+        annotations: READ_ONLY,
+        inputSchema: {
+            website_id: z.string().describe('Website id (from get_websites)'),
+        },
+    }, async ({ website_id }) => {
+        try {
+            return toToolResult(await client.getActive(website_id));
+        }
+        catch (error) {
+            return toErrorResult(error);
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('umami-mcp connected over stdio');
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/settings.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Umami connection settings resolved from the environment.
+ *
+ * Two auth modes exist and are mutually exclusive:
+ * - `api_key` — Umami Cloud (or any deployment issuing API keys); `UMAMI_API_KEY`.
+ * - `login` — self-hosted username/password; `UMAMI_USERNAME` + `UMAMI_PASSWORD`, with
+ *   `UMAMI_API_BASE` pointing at the instance API root (e.g. `https://umami.example.com/api`).
+ */
+export interface Settings {
+    apiBase: string;
+    auth: {
+        mode: 'api_key';
+        apiKey: string;
+    } | {
+        mode: 'login';
+        username: string;
+        password: string;
+    };
+}
+export declare function loadSettings(env?: NodeJS.ProcessEnv): Settings;

package/dist/settings.js

@@ -0,0 +1,35 @@
+const CLOUD_DEFAULT_API_BASE = 'https://api.umami.is/v1';
+export function loadSettings(env = process.env) {
+    const apiKey = env.UMAMI_API_KEY?.trim() || undefined;
+    const username = env.UMAMI_USERNAME?.trim() || undefined;
+    const password = env.UMAMI_PASSWORD?.trim() || undefined;
+    const apiBase = (env.UMAMI_API_BASE?.trim() || CLOUD_DEFAULT_API_BASE).replace(/\/+$/, '');
+    if (apiKey) {
+        return { apiBase, auth: { mode: 'api_key', apiKey } };
+    }
+    if (Boolean(username) !== Boolean(password)) {
+        throw new Error('Invalid Umami auth configuration. Provide either UMAMI_API_KEY (Umami Cloud) ' +
+            'or both UMAMI_USERNAME and UMAMI_PASSWORD (self-hosted).');
+    }
+    if (!username || !password) {
+        throw new Error('Missing Umami credentials. Provide UMAMI_API_KEY (Umami Cloud) or both ' +
+            'UMAMI_USERNAME and UMAMI_PASSWORD (self-hosted). Note: Umami Cloud only ' +
+            'supports API keys.');
+    }
+    const host = safeHostname(apiBase);
+    if (host === 'api.umami.is') {
+        throw new Error('UMAMI_USERNAME/UMAMI_PASSWORD are only supported for self-hosted Umami. ' +
+            'Umami Cloud requires UMAMI_API_KEY. For self-hosted, set UMAMI_API_BASE to ' +
+            'your instance API root (e.g. https://your-umami.example/api).');
+    }
+    return { apiBase, auth: { mode: 'login', username, password } };
+}
+function safeHostname(url) {
+    try {
+        return new URL(url).hostname.toLowerCase();
+    }
+    catch {
+        throw new Error(`UMAMI_API_BASE is not a valid URL: ${url}`);
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAaA,MAAM,sBAAsB,GAAG,yBAAyB,CAAC;AAEzD,MAAM,UAAU,YAAY,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC/D,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IACtD,MAAM,QAAQ,GAAG,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IACzD,MAAM,QAAQ,GAAG,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IACzD,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,sBAAsB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAE3F,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACxD,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,+EAA+E;YAC7E,0DAA0D,CAC7D,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,yEAAyE;YACvE,0EAA0E;YAC1E,oBAAoB,CACvB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,0EAA0E;YACxE,6EAA6E;YAC7E,+DAA+D,CAClE,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/umami-client.d.ts

@@ -0,0 +1,28 @@
+import type { Settings } from './settings.js';
+export declare class UmamiError extends Error {
+}
+/**
+ * Thin fetch client over the Umami HTTP API.
+ *
+ * Auth: `api_key` mode sends `x-umami-api-key` on every request; `login` mode lazily exchanges
+ * username/password for a bearer token at `/auth/login` and caches it for the process. Transport
+ * failures and 429s retry up to three times with exponential backoff; auth failures and other
+ * HTTP errors surface as `UmamiError` with a message that points at the misconfigured setting.
+ */
+export declare class UmamiClient {
+    private readonly settings;
+    private token;
+    constructor(settings: Settings);
+    getWebsites(params: {
+        includeTeams: boolean;
+        search?: string | undefined;
+        page: number;
+        pageSize: number;
+    }): Promise<unknown>;
+    getStats(websiteID: string, query: Record<string, string>): Promise<unknown>;
+    getPageviews(websiteID: string, query: Record<string, string>): Promise<unknown>;
+    getMetrics(websiteID: string, expanded: boolean, query: Record<string, string>): Promise<unknown>;
+    getActive(websiteID: string): Promise<unknown>;
+    private ensureToken;
+    private request;
+}

package/dist/umami-client.js

@@ -0,0 +1,125 @@
+export class UmamiError extends Error {
+}
+const MAX_RETRIES = 3;
+/**
+ * Thin fetch client over the Umami HTTP API.
+ *
+ * Auth: `api_key` mode sends `x-umami-api-key` on every request; `login` mode lazily exchanges
+ * username/password for a bearer token at `/auth/login` and caches it for the process. Transport
+ * failures and 429s retry up to three times with exponential backoff; auth failures and other
+ * HTTP errors surface as `UmamiError` with a message that points at the misconfigured setting.
+ */
+export class UmamiClient {
+    settings;
+    token;
+    constructor(settings) {
+        this.settings = settings;
+    }
+    async getWebsites(params) {
+        return this.request('/websites', {
+            includeTeams: String(params.includeTeams),
+            page: String(params.page),
+            pageSize: String(params.pageSize),
+            ...(params.search ? { search: params.search } : {}),
+        });
+    }
+    async getStats(websiteID, query) {
+        return this.request(`/websites/${encodeURIComponent(websiteID)}/stats`, query);
+    }
+    async getPageviews(websiteID, query) {
+        return this.request(`/websites/${encodeURIComponent(websiteID)}/pageviews`, query);
+    }
+    async getMetrics(websiteID, expanded, query) {
+        const path = expanded
+            ? `/websites/${encodeURIComponent(websiteID)}/metrics/expanded`
+            : `/websites/${encodeURIComponent(websiteID)}/metrics`;
+        return this.request(path, query);
+    }
+    async getActive(websiteID) {
+        return this.request(`/websites/${encodeURIComponent(websiteID)}/active`, {});
+    }
+    async ensureToken() {
+        if (this.token !== undefined) {
+            return this.token;
+        }
+        if (this.settings.auth.mode !== 'login') {
+            throw new UmamiError('ensureToken called outside login auth mode');
+        }
+        let response;
+        try {
+            response = await fetch(`${this.settings.apiBase}/auth/login`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+                body: JSON.stringify({
+                    username: this.settings.auth.username,
+                    password: this.settings.auth.password,
+                }),
+            });
+        }
+        catch (error) {
+            throw new UmamiError(`Login request failed: ${String(error)}`);
+        }
+        if (response.status === 401 || response.status === 403) {
+            throw new UmamiError('Authentication failed (check UMAMI_USERNAME/UMAMI_PASSWORD). Note: Umami Cloud only supports UMAMI_API_KEY.');
+        }
+        if (!response.ok) {
+            throw new UmamiError(`Login failed (${response.status}): ${await response.text()}`);
+        }
+        const data = await response.json();
+        const token = typeof data === 'object' && data !== null && 'token' in data ? data.token : undefined;
+        if (typeof token !== 'string' || token.length === 0) {
+            throw new UmamiError('Login succeeded but no token was returned by Umami');
+        }
+        this.token = token;
+        return token;
+    }
+    async request(path, query) {
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            const headers = { Accept: 'application/json' };
+            if (this.settings.auth.mode === 'api_key') {
+                headers['x-umami-api-key'] = this.settings.auth.apiKey;
+            }
+            else {
+                headers.Authorization = `Bearer ${await this.ensureToken()}`;
+            }
+            const url = new URL(`${this.settings.apiBase}${path}`);
+            for (const [key, value] of Object.entries(query)) {
+                url.searchParams.set(key, value);
+            }
+            let response;
+            try {
+                response = await fetch(url, { headers });
+            }
+            catch (error) {
+                lastError = error;
+                await sleep(250 * 2 ** attempt);
+                continue;
+            }
+            if (response.status === 401 || response.status === 403) {
+                throw new UmamiError(this.settings.auth.mode === 'api_key'
+                    ? 'Authentication failed (check UMAMI_API_KEY)'
+                    : 'Authentication failed (check UMAMI_USERNAME/UMAMI_PASSWORD). Note: Umami Cloud only supports UMAMI_API_KEY.');
+            }
+            if (response.status === 429) {
+                await sleep(500 * 2 ** attempt);
+                continue;
+            }
+            if (!response.ok) {
+                throw new UmamiError(`Umami API error ${response.status}: ${await response.text()}`);
+            }
+            if (response.status === 204) {
+                return null;
+            }
+            return response.json();
+        }
+        if (lastError !== undefined) {
+            throw new UmamiError(`Request failed after retries: ${String(lastError)}`);
+        }
+        throw new UmamiError('Request rate-limited (429) after retries');
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=umami-client.js.map

package/dist/umami-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"umami-client.js","sourceRoot":"","sources":["../src/umami-client.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,UAAW,SAAQ,KAAK;CAAG;AAExC,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB;;;;;;;GAOG;AACH,MAAM,OAAO,WAAW;IACL,QAAQ,CAAW;IAC5B,KAAK,CAAqB;IAElC,YAAY,QAAkB;QAC5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAKjB;QACC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE;YAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;YACzC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;YACjC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,KAA6B;QAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,kBAAkB,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAiB,EAAE,KAA6B;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,kBAAkB,CAAC,SAAS,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,UAAU,CACd,SAAiB,EACjB,QAAiB,EACjB,KAA6B;QAE7B,MAAM,IAAI,GAAG,QAAQ;YACnB,CAAC,CAAC,aAAa,kBAAkB,CAAC,SAAS,CAAC,mBAAmB;YAC/D,CAAC,CAAC,aAAa,kBAAkB,CAAC,SAAS,CAAC,UAAU,CAAC;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,SAAiB;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,kBAAkB,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC/E,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACxC,MAAM,IAAI,UAAU,CAAC,4CAA4C,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,aAAa,EAAE;gBAC5D,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE;gBAC3E,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ;oBACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ;iBACtC,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CAAC,yBAAyB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvD,MAAM,IAAI,UAAU,CAClB,6GAA6G,CAC9G,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,UAAU,CAAC,iBAAiB,QAAQ,CAAC,MAAM,MAAM,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,IAAI,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,KAAK,GACT,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAExF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,UAAU,CAAC,oDAAoD,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,KAA6B;QAC/D,IAAI,SAAkB,CAAC;QAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,MAAM,OAAO,GAA2B,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;YAEvE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC1C,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;YACzD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,aAAa,GAAG,UAAU,MAAM,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YAC/D,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC,CAAC;YACvD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC;YAED,IAAI,QAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,CAAC;gBAClB,MAAM,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC;gBAChC,SAAS;YACX,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACvD,MAAM,IAAI,UAAU,CAClB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS;oBACnC,CAAC,CAAC,6CAA6C;oBAC/C,CAAC,CAAC,6GAA6G,CAClH,CAAC;YACJ,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC;gBAChC,SAAS;YACX,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,UAAU,CAAC,mBAAmB,QAAQ,CAAC,MAAM,KAAK,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACvF,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;QAED,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,UAAU,CAAC,iCAAiC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,IAAI,UAAU,CAAC,0CAA0C,CAAC,CAAC;IACnE,CAAC;CACF;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@zgeoff/umami-mcp",
+  "version": "0.1.0",
+  "description": "MCP server exposing Umami analytics (Cloud + self-hosted) via typed read-only tools",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "umami-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "format": "prettier --write src/",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "umami",
+    "analytics"
+  ],
+  "author": "Geoff Whatley <me@geoffwhatley.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zgeoff/umami-mcp.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "zod": "3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "22.18.13",
+    "prettier": "3.6.2",
+    "tsx": "4.20.6",
+    "typescript": "5.9.3",
+    "vitest": "3.2.4"
+  }
+}