@framedash/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Crane Valley LLC
+
+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,98 @@
+# @framedash/mcp-server
+
+MCP (Model Context Protocol) server for the Framedash game telemetry platform. Provides 12 read-only tools and 4 resources for querying analytics data from LLM-powered tools.
+
+## Setup
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "framedash": {
+      "command": "npx",
+      "args": ["@framedash/mcp-server"],
+      "env": {
+        "FRAMEDASH_API_KEY": "fd_admin_xxx",
+        "FRAMEDASH_PROJECT_ID": "your-project-uuid"
+      }
+    }
+  }
+}
+```
+
+### VS Code (Claude Extension)
+
+Add to your VS Code settings:
+
+```json
+{
+  "claude.mcpServers": {
+    "framedash": {
+      "command": "npx",
+      "args": ["@framedash/mcp-server"],
+      "env": {
+        "FRAMEDASH_API_KEY": "fd_admin_xxx",
+        "FRAMEDASH_PROJECT_ID": "your-project-uuid"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `FRAMEDASH_API_KEY` | Yes | Admin API key (`fd_admin_` prefix) |
+| `FRAMEDASH_PROJECT_ID` | No | Default project UUID for project-scoped tools |
+| `FRAMEDASH_BASE_URL` | No | API base URL (default: `https://app.framedash.dev`) |
+
+If `FRAMEDASH_PROJECT_ID` is omitted, project-scoped tools still work but
+require an explicit `project_id` argument per call.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `query` | Execute SQL analytics query (SELECT only, limit default 100) |
+| `get_dashboard` | Project KPI summary (DAU, MAU, sessions, events) |
+| `get_retention` | Cohort retention data |
+| `get_funnel` | Funnel analysis for event steps |
+| `get_insights` | Event insights with grouping |
+| `get_heatmap` | Heatmap grid data for a map |
+| `list_projects` | Show the project bound to the API key |
+| `get_project_status` | Project health overview |
+| `list_maps` | List maps in a project |
+| `list_content` | List content registry entries |
+| `list_alerts` | List alert rules |
+| `get_alert_history` | Alert trigger history |
+
+## Resources
+
+| URI | Description |
+|-----|-------------|
+| `framedash://projects` | Project bound to the API key |
+| `framedash://projects/{projectId}/maps` | Map list with bounds |
+| `framedash://projects/{projectId}/content` | Content registry |
+| `framedash://projects/{projectId}/status` | Project health status |
+
+## Development
+
+Run from the repository root:
+
+```bash
+pnpm install
+pnpm --filter @framedash/mcp-server... build
+pnpm --filter @framedash/mcp-server test
+```
+
+With pnpm 9, the trailing `...` selects the MCP package plus its workspace
+dependencies, including `@framedash/api-client`, before compiling from a clean
+checkout.
+
+## License
+
+MIT

package/dist/helpers.d.ts

@@ -0,0 +1,21 @@
+import type { ApiClient } from "@framedash/api-client";
+/** Truncate large responses to protect LLM context windows. */
+export declare function truncate(data: unknown): string;
+export declare function textResult(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/** Extract a human-readable message from an unknown error value. */
+export declare function getErrorMessage(err: unknown): string;
+export declare function errorResult(err: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+};
+/** Create an ApiClient with an optional project_id override. */
+export declare function projectClient(base: ApiClient, overrideProjectId?: string): ApiClient;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAIvD,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAe9C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO;;;;;EAEvC;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO;;;;;;EAKvC;AAID,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAMpF"}

package/dist/helpers.js

@@ -0,0 +1,42 @@
+const MAX_RESPONSE_SIZE = 50 * 1024; // 50 KB
+/** Truncate large responses to protect LLM context windows. */
+export function truncate(data) {
+    const text = JSON.stringify(data, null, 2) ?? "null";
+    if (text.length <= MAX_RESPONSE_SIZE)
+        return text;
+    if (Array.isArray(data)) {
+        const total = data.length;
+        for (let keep = Math.min(total, 50); keep > 0; keep--) {
+            const slice = JSON.stringify(data.slice(0, keep), null, 2);
+            const footer = `\n\n[truncated: showing first ${keep} rows of ${total} total]`;
+            if (slice.length + footer.length <= MAX_RESPONSE_SIZE) {
+                return slice + footer;
+            }
+        }
+    }
+    return `${text.slice(0, MAX_RESPONSE_SIZE)}\n\n[truncated]`;
+}
+export function textResult(data) {
+    return { content: [{ type: "text", text: truncate(data) }] };
+}
+/** Extract a human-readable message from an unknown error value. */
+export function getErrorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+export function errorResult(err) {
+    return {
+        content: [{ type: "text", text: getErrorMessage(err) }],
+        isError: true,
+    };
+}
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** Create an ApiClient with an optional project_id override. */
+export function projectClient(base, overrideProjectId) {
+    if (!overrideProjectId)
+        return base;
+    if (!UUID_RE.test(overrideProjectId)) {
+        throw new Error("Invalid project_id: must be a valid UUID");
+    }
+    return base.withProject(overrideProjectId);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,QAAQ;AAE7C,+DAA+D;AAC/D,MAAM,UAAU,QAAQ,CAAC,IAAa;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC;IACrD,IAAI,IAAI,CAAC,MAAM,IAAI,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAElD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,KAAK,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;YACvD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,iCAAiC,IAAI,YAAY,KAAK,SAAS,CAAC;YAC/E,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,iBAAiB,EAAE,CAAC;gBACvD,OAAO,KAAK,GAAG,MAAM,CAAC;YACvB,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,iBAAiB,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAa;IACvC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,GAAY;IAC3C,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAY;IACvC,OAAO;QACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QAChE,OAAO,EAAE,IAAa;KACtB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,GAAG,iEAAiE,CAAC;AAElF,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAAC,IAAe,EAAE,iBAA0B;IACxE,IAAI,CAAC,iBAAiB;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;AAC5C,CAAC"}

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,32 @@
+#!/usr/bin/env node
+import { ApiClient } from "@framedash/api-client";
+import { createServer } from "./server.js";
+import { StrictStdioServerTransport } from "./transport.js";
+const apiKey = process.env.FRAMEDASH_API_KEY;
+if (!apiKey) {
+    process.stderr.write("Error: FRAMEDASH_API_KEY environment variable is required\n");
+    process.exit(1);
+}
+const projectId = process.env.FRAMEDASH_PROJECT_ID ?? "";
+if (!projectId) {
+    process.stderr.write("Warning: FRAMEDASH_PROJECT_ID is not set. Project-scoped tools will require a project_id argument.\n");
+}
+const baseUrl = process.env.FRAMEDASH_BASE_URL || "https://app.framedash.dev";
+try {
+    const client = new ApiClient({
+        baseUrl,
+        apiKey,
+        projectId,
+        onError(err) {
+            throw err;
+        },
+    });
+    const server = createServer(client);
+    const transport = new StrictStdioServerTransport();
+    await server.connect(transport);
+}
+catch (err) {
+    process.stderr.write(`Failed to start MCP server: ${err}\n`);
+    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":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;IACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC;AACzD,IAAI,CAAC,SAAS,EAAE,CAAC;IAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,sGAAsG,CACtG,CAAC;AACH,CAAC;AACD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,2BAA2B,CAAC;AAE9E,IAAI,CAAC;IACJ,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC5B,OAAO;QACP,MAAM;QACN,SAAS;QACT,OAAO,CAAC,GAAG;YACV,MAAM,GAAG,CAAC;QACX,CAAC;KACD,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,0BAA0B,EAAE,CAAC;IACnD,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,4 @@
+import type { ApiClient } from "@framedash/api-client";
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerResources(server: McpServer, apiClient: ApiClient): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAG3F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CA+E/E"}

package/dist/resources.js

@@ -0,0 +1,64 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getErrorMessage, projectClient, truncate } from "./helpers.js";
+export function registerResources(server, apiClient) {
+    server.registerResource("projects", "framedash://projects", {
+        title: "Projects",
+        description: "Project bound to the current API key",
+        mimeType: "application/json",
+    }, async () => {
+        try {
+            const data = await apiClient.get("/api/v1/projects");
+            return { contents: [{ uri: "framedash://projects", text: truncate(data) }] };
+        }
+        catch (err) {
+            const msg = getErrorMessage(err);
+            return { contents: [{ uri: "framedash://projects", text: msg }] };
+        }
+    });
+    server.registerResource("project-maps", new ResourceTemplate("framedash://projects/{projectId}/maps", { list: undefined }), {
+        title: "Project Maps",
+        description: "Maps in a project with coordinates",
+        mimeType: "application/json",
+    }, async (uri, params) => {
+        try {
+            const client = projectClient(apiClient, String(params.projectId));
+            const data = await client.get(client.projectPath("maps"));
+            return { contents: [{ uri: uri.href, text: truncate(data) }] };
+        }
+        catch (err) {
+            const msg = getErrorMessage(err);
+            return { contents: [{ uri: uri.href, text: msg }] };
+        }
+    });
+    server.registerResource("project-content", new ResourceTemplate("framedash://projects/{projectId}/content", { list: undefined }), {
+        title: "Content Registry",
+        description: "Content entries (event names, display labels)",
+        mimeType: "application/json",
+    }, async (uri, params) => {
+        try {
+            const client = projectClient(apiClient, String(params.projectId));
+            const data = await client.get(client.projectPath("content"));
+            return { contents: [{ uri: uri.href, text: truncate(data) }] };
+        }
+        catch (err) {
+            const msg = getErrorMessage(err);
+            return { contents: [{ uri: uri.href, text: msg }] };
+        }
+    });
+    server.registerResource("project-status", new ResourceTemplate("framedash://projects/{projectId}/status", { list: undefined }), {
+        title: "Project Status",
+        description: "Project status and event statistics",
+        mimeType: "application/json",
+    }, async (uri, params) => {
+        try {
+            const client = projectClient(apiClient, String(params.projectId));
+            const data = await client.get(client.projectPath("status"));
+            return { contents: [{ uri: uri.href, text: truncate(data) }] };
+        }
+        catch (err) {
+            const msg = getErrorMessage(err);
+            return { contents: [{ uri: uri.href, text: msg }] };
+        }
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import type { ApiClient } from "@framedash/api-client";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(apiClient: ApiClient): 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,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAa5D"}

package/dist/server.js

@@ -0,0 +1,19 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerResources } from "./resources.js";
+import { registerAlertTools } from "./tools/alerts.js";
+import { registerAnalyticsTools } from "./tools/analytics.js";
+import { registerProjectTools } from "./tools/project.js";
+import { registerQueryTools } from "./tools/query.js";
+export function createServer(apiClient) {
+    const server = new McpServer({
+        name: "framedash",
+        version: "0.1.0",
+    });
+    registerQueryTools(server, apiClient);
+    registerAnalyticsTools(server, apiClient);
+    registerProjectTools(server, apiClient);
+    registerAlertTools(server, apiClient);
+    registerResources(server, apiClient);
+    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":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,UAAU,YAAY,CAAC,SAAoB;IAChD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC5B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KAChB,CAAC,CAAC;IAEH,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,sBAAsB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1C,oBAAoB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxC,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAErC,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/tools/alerts.d.ts

@@ -0,0 +1,4 @@
+import type { ApiClient } from "@framedash/api-client";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAlertTools(server: McpServer, apiClient: ApiClient): void;
+//# sourceMappingURL=alerts.d.ts.map

package/dist/tools/alerts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../src/tools/alerts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAkDhF"}

package/dist/tools/alerts.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { errorResult, projectClient, textResult } from "../helpers.js";
+export function registerAlertTools(server, apiClient) {
+    server.registerTool("list_alerts", {
+        title: "List Alerts",
+        description: "List all alert rules in the project.",
+        inputSchema: {
+            project_id: z.string().uuid().optional().describe("Override the default project ID"),
+        },
+    }, async (args) => {
+        try {
+            const client = projectClient(apiClient, args.project_id);
+            const data = await client.get(client.projectPath("alerts"));
+            return textResult(data);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    server.registerTool("get_alert_history", {
+        title: "Get Alert History",
+        description: "Get alert event history (trigger/resolve events).",
+        inputSchema: {
+            project_id: z.string().uuid().optional().describe("Override the default project ID"),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe("Max events to return (default 50)"),
+        },
+    }, async (args) => {
+        try {
+            const client = projectClient(apiClient, args.project_id);
+            const params = new URLSearchParams();
+            if (args.limit)
+                params.set("limit", String(args.limit));
+            const qs = params.toString() ? `?${params}` : "";
+            const data = await client.get(client.projectPath(`alerts/history${qs}`));
+            return textResult(data);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+}
+//# sourceMappingURL=alerts.js.map

package/dist/tools/alerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.js","sourceRoot":"","sources":["../../src/tools/alerts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEvE,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,SAAoB;IACzE,MAAM,CAAC,YAAY,CAClB,aAAa,EACb;QACC,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,sCAAsC;QACnD,WAAW,EAAE;YACZ,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;SACpF;KACD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACd,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACzD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC5D,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACF,CAAC,CACD,CAAC;IAEF,MAAM,CAAC,YAAY,CAClB,mBAAmB,EACnB;QACC,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,mDAAmD;QAChE,WAAW,EAAE;YACZ,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YACpF,KAAK,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,mCAAmC,CAAC;SAC/C;KACD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACd,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACxD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,CAAC;YACzE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACF,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/tools/analytics.d.ts

@@ -0,0 +1,4 @@
+import type { ApiClient } from "@framedash/api-client";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAnalyticsTools(server: McpServer, apiClient: ApiClient): void;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/tools/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/tools/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+BzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAsIpF"}

package/dist/tools/analytics.js

@@ -0,0 +1,149 @@
+import { z } from "zod";
+import { errorResult, projectClient, textResult } from "../helpers.js";
+// The REST API rejects values outside these sets with HTTP 400. They mirror the
+// web app's constants (ALLOWED_DAYS / ALLOWED_LIMITS in lib/analytics/constants,
+// VALID_DAYS / VALID_CELL_SIZES in lib/heatmap-constants). The MCP server is a
+// separate package and cannot import them, so keep these in sync if the API changes.
+// Constraining the input schema lets the MCP client reject invalid values up front
+// instead of after a server round-trip.
+const ANALYTICS_DAYS = [7, 14, 30, 90];
+const INSIGHTS_LIMITS = [10, 20, 50];
+const HEATMAP_DAYS = [1, 7, 14, 30];
+const HEATMAP_CELL_SIZES = [5, 10, 25, 50];
+/**
+ * Optional value constrained to an allowed set, mirroring the REST API. Built from
+ * z.union(z.literal(...)) rather than z.number().refine(...) so the allowed values
+ * serialize into the JSON Schema the MCP SDK publishes -- `refine` runs opaque JS
+ * and is dropped by the schema converter, which would leave the LLM unable to see
+ * the constraint and reject out-of-set values before a server round-trip.
+ */
+function allowedIntEnum(values, description) {
+    const literals = values.map((v) => z.literal(v));
+    return z.union(literals).optional().describe(description);
+}
+export function registerAnalyticsTools(server, apiClient) {
+    server.registerTool("get_dashboard", {
+        title: "Get Dashboard",
+        description: "Get project dashboard metrics (KPIs, daily active users, top events).",
+        inputSchema: {
+            project_id: z.string().uuid().optional().describe("Override the default project ID"),
+            days: allowedIntEnum(ANALYTICS_DAYS, "Time period: 7, 14, 30, or 90 days (default 30)"),
+        },
+    }, async (args) => {
+        try {
+            const client = projectClient(apiClient, args.project_id);
+            const params = new URLSearchParams();
+            if (args.days)
+                params.set("days", String(args.days));
+            const qs = params.toString() ? `?${params}` : "";
+            const data = await client.get(client.projectPath(`dashboard${qs}`));
+            return textResult(data);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    server.registerTool("get_retention", {
+        title: "Get Retention",
+        description: "Get player retention cohort analysis.",
+        inputSchema: {
+            project_id: z.string().uuid().optional().describe("Override the default project ID"),
+            days: allowedIntEnum(ANALYTICS_DAYS, "Time period: 7, 14, 30, or 90 days (default 30)"),
+        },
+    }, async (args) => {
+        try {
+            const client = projectClient(apiClient, args.project_id);
+            const params = new URLSearchParams();
+            if (args.days)
+                params.set("days", String(args.days));
+            const qs = params.toString() ? `?${params}` : "";
+            const data = await client.get(client.projectPath(`retention${qs}`));
+            return textResult(data);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    server.registerTool("get_funnel", {
+        title: "Get Funnel",
+        description: "Analyze event funnels. Requires 2-8 event names as steps.",
+        inputSchema: {
+            project_id: z.string().uuid().optional().describe("Override the default project ID"),
+            steps: z.string().describe("Comma-separated event names (2-8 steps)"),
+            days: allowedIntEnum(ANALYTICS_DAYS, "Time period: 7, 14, 30, or 90 days (default 30)"),
+        },
+    }, async (args) => {
+        try {
+            const client = projectClient(apiClient, args.project_id);
+            const params = new URLSearchParams({ steps: args.steps });
+            if (args.days)
+                params.set("days", String(args.days));
+            const data = await client.get(client.projectPath(`funnels?${params}`));
+            return textResult(data);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    server.registerTool("get_insights", {
+        title: "Get Insights",
+        description: "Get aggregated insights for a metric grouped by a dimension.",
+        inputSchema: {
+            project_id: z.string().uuid().optional().describe("Override the default project ID"),
+            metric: z.string().describe("Metric to aggregate: count or unique_players"),
+            group_by: z.string().describe("Dimension to group by (e.g. event_name, platform)"),
+            days: allowedIntEnum(ANALYTICS_DAYS, "Time period: 7, 14, 30, or 90 days (default 30)"),
+            limit: allowedIntEnum(INSIGHTS_LIMITS, "Max groups to return: 10, 20, or 50"),
+            event_name: z.string().optional().describe("Filter by event name"),
+        },
+    }, async (args) => {
+        try {
+            const client = projectClient(apiClient, args.project_id);
+            const params = new URLSearchParams({
+                metric: args.metric,
+                groupBy: args.group_by,
+            });
+            if (args.days)
+                params.set("days", String(args.days));
+            if (args.limit)
+                params.set("limit", String(args.limit));
+            if (args.event_name)
+                params.set("eventName", args.event_name);
+            const data = await client.get(client.projectPath(`insights?${params}`));
+            return textResult(data);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    server.registerTool("get_heatmap", {
+        title: "Get Heatmap",
+        description: "Get heatmap grid data for a map. Returns performance metrics per cell.",
+        inputSchema: {
+            project_id: z.string().uuid().optional().describe("Override the default project ID"),
+            map_id: z
+                .string()
+                .describe("Map ID to query (accepts the row UUID or slug from list_maps)"),
+            cell_size: allowedIntEnum(HEATMAP_CELL_SIZES, "Cell size: 5, 10, 25, or 50 (default 25)"),
+            days: allowedIntEnum(HEATMAP_DAYS, "Time period: 1, 7, 14, or 30 days (default 7)"),
+            event_name: z.string().optional().describe("Filter by event name"),
+        },
+    }, async (args) => {
+        try {
+            const client = projectClient(apiClient, args.project_id);
+            const params = new URLSearchParams({ mapId: args.map_id });
+            if (args.cell_size)
+                params.set("cellSize", String(args.cell_size));
+            if (args.days)
+                params.set("days", String(args.days));
+            if (args.event_name)
+                params.set("eventName", args.event_name);
+            const data = await client.get(client.projectPath(`heatmap?${params}`));
+            return textResult(data);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+}
+//# sourceMappingURL=analytics.js.map

package/dist/tools/analytics.js.map

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

package/dist/tools/project.d.ts

@@ -0,0 +1,4 @@
+import type { ApiClient } from "@framedash/api-client";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerProjectTools(server: McpServer, apiClient: ApiClient): void;
+//# sourceMappingURL=project.d.ts.map

package/dist/tools/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/tools/project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAgFlF"}

package/dist/tools/project.js

@@ -0,0 +1,70 @@
+import { z } from "zod";
+import { errorResult, projectClient, textResult } from "../helpers.js";
+export function registerProjectTools(server, apiClient) {
+    server.registerTool("list_projects", {
+        title: "List Projects",
+        description: "Show the project bound to the current API key.",
+    }, async () => {
+        try {
+            const data = await apiClient.get("/api/v1/projects");
+            return textResult(data);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    server.registerTool("get_project_status", {
+        title: "Get Project Status",
+        description: "Get the status of a project (event counts, last event time, etc.).",
+        inputSchema: {
+            project_id: z.string().uuid().optional().describe("Override the default project ID"),
+        },
+    }, async (args) => {
+        try {
+            const client = projectClient(apiClient, args.project_id);
+            const data = await client.get(client.projectPath("status"));
+            return textResult(data);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    server.registerTool("list_maps", {
+        title: "List Maps",
+        description: "List all maps in the project.",
+        inputSchema: {
+            project_id: z.string().uuid().optional().describe("Override the default project ID"),
+        },
+    }, async (args) => {
+        try {
+            const client = projectClient(apiClient, args.project_id);
+            const data = await client.get(client.projectPath("maps"));
+            return textResult(data);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    server.registerTool("list_content", {
+        title: "List Content",
+        description: "List content registry entries (event names, display labels, etc.).",
+        inputSchema: {
+            project_id: z.string().uuid().optional().describe("Override the default project ID"),
+            type: z.string().optional().describe("Filter by content type"),
+        },
+    }, async (args) => {
+        try {
+            const client = projectClient(apiClient, args.project_id);
+            const params = new URLSearchParams();
+            if (args.type)
+                params.set("type", args.type);
+            const qs = params.toString() ? `?${params}` : "";
+            const data = await client.get(`/api/v1/content${qs}`);
+            return textResult(data);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+}
+//# sourceMappingURL=project.js.map

package/dist/tools/project.js.map

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

package/dist/tools/query.d.ts

@@ -0,0 +1,4 @@
+import type { ApiClient } from "@framedash/api-client";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerQueryTools(server: McpServer, apiClient: ApiClient): void;
+//# sourceMappingURL=query.d.ts.map

package/dist/tools/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/tools/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAiChF"}

package/dist/tools/query.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { errorResult, projectClient, textResult } from "../helpers.js";
+export function registerQueryTools(server, apiClient) {
+    server.registerTool("query", {
+        title: "Query Events",
+        description: "Execute a read-only SQL query against the ClickHouse events table. Returns up to `limit` rows (default 100, max 1000).",
+        inputSchema: {
+            sql: z.string().describe("SQL query to execute"),
+            project_id: z.string().uuid().optional().describe("Override the default project ID"),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(1000)
+                .optional()
+                .describe("Max rows to return (default 100)"),
+        },
+    }, async (args) => {
+        try {
+            const client = projectClient(apiClient, args.project_id);
+            const data = await client.post("/api/v1/query", {
+                project_id: client.currentProjectId,
+                sql: args.sql,
+                limit: args.limit ?? 100,
+            });
+            return textResult(data);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+}
+//# sourceMappingURL=query.js.map

package/dist/tools/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/tools/query.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEvE,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,SAAoB;IACzE,MAAM,CAAC,YAAY,CAClB,OAAO,EACP;QACC,KAAK,EAAE,cAAc;QACrB,WAAW,EACV,wHAAwH;QACzH,WAAW,EAAE;YACZ,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YAChD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YACpF,KAAK,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,kCAAkC,CAAC;SAC9C;KACD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACd,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACzD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;gBAC/C,UAAU,EAAE,MAAM,CAAC,gBAAgB;gBACnC,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG;aACxB,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACF,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/transport.d.ts

@@ -0,0 +1,43 @@
+import { Buffer } from "node:buffer";
+import type { Readable, Writable } from "node:stream";
+import type { Transport, TransportSendOptions } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { JSONRPCMessage, MessageExtraInfo } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Stdio transport for an MCP server that responds with a JSON-RPC `Parse error`
+ * envelope (-32700, id null) on stdout when stdin contains a non-JSON line.
+ *
+ * The upstream `StdioServerTransport` forwards parse failures to an optional
+ * `onerror` hook but never replies on the wire, so a client sending a malformed
+ * frame never learns it was dropped. JSON-RPC 2.0 requires an error response
+ * with id=null for unparseable input.
+ */
+export declare class StrictStdioServerTransport implements Transport {
+    private readonly _stdin;
+    private readonly _stdout;
+    private _chunks;
+    private _chunksLen;
+    private _discardingFrame;
+    private _stdoutSaturated;
+    private _drainAttached;
+    private _writeChain;
+    private _started;
+    private _closed;
+    onclose?: () => void;
+    onerror?: (error: Error) => void;
+    onmessage?: <T extends JSONRPCMessage>(message: T, extra?: MessageExtraInfo) => void;
+    constructor(stdin?: Readable, stdout?: Writable);
+    start(): Promise<void>;
+    send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void>;
+    close(): Promise<void>;
+    private _ondata;
+    private _onstdinError;
+    private _onstdinEnd;
+    private _resetChunks;
+    private _handleLine;
+    private _emitParseError;
+    private _markSaturated;
+    private _writeStdout;
+    /** Test helper: feed bytes through the same path as live stdin data. */
+    feedForTest(chunk: Buffer | string): void;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EACX,SAAS,EACT,oBAAoB,EACpB,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAK3F;;;;;;;;GAQG;AACH,qBAAa,0BAA2B,YAAW,SAAS;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;IAInC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,UAAU,CAAK;IAIvB,OAAO,CAAC,gBAAgB,CAAS;IAKjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,cAAc,CAAS;IAI/B,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;gBAEzE,KAAK,GAAE,QAAwB,EAAE,MAAM,GAAE,QAAyB;IAKxE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,OAAO,CAAC,OAAO,CAmEb;IAEF,OAAO,CAAC,aAAa,CAEnB;IAEF,OAAO,CAAC,WAAW,CAEjB;IAEF,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,YAAY;IAsCpB,wEAAwE;IACxE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAIzC"}

package/dist/transport.js

@@ -0,0 +1,237 @@
+import { Buffer } from "node:buffer";
+import process from "node:process";
+/** Hard cap on a single JSON-RPC frame: 4 MB. Lines larger than this are rejected. */
+const MAX_LINE_BYTES = 4 * 1024 * 1024;
+/**
+ * Stdio transport for an MCP server that responds with a JSON-RPC `Parse error`
+ * envelope (-32700, id null) on stdout when stdin contains a non-JSON line.
+ *
+ * The upstream `StdioServerTransport` forwards parse failures to an optional
+ * `onerror` hook but never replies on the wire, so a client sending a malformed
+ * frame never learns it was dropped. JSON-RPC 2.0 requires an error response
+ * with id=null for unparseable input.
+ */
+export class StrictStdioServerTransport {
+    _stdin;
+    _stdout;
+    // Pending bytes for the in-flight (unterminated) line. We accumulate them in an
+    // array and only call Buffer.concat once a newline arrives, so a peer that
+    // streams a big payload in many small chunks pays linear cost instead of O(N^2).
+    _chunks = [];
+    _chunksLen = 0;
+    // When an oversized frame is detected, we throw away the rest of that frame
+    // (everything up to and including the next newline) so the trailing bytes of
+    // a too-large line cannot be parsed as a fresh JSON-RPC message.
+    _discardingFrame = false;
+    // True while stdout has signaled backpressure (write returned false). We
+    // drop best-effort parse-error envelopes while saturated so a peer that
+    // floods malformed input without reading stdout cannot pin unbounded reply
+    // bytes in Node's internal buffer.
+    _stdoutSaturated = false;
+    _drainAttached = false;
+    // Serialize send() writes through a single promise chain so concurrent
+    // callers do not stack drain/close/error listeners on stdout (which would
+    // trip Node's MaxListenersExceededWarning at >10 in flight).
+    _writeChain = Promise.resolve();
+    _started = false;
+    _closed = false;
+    onclose;
+    onerror;
+    onmessage;
+    constructor(stdin = process.stdin, stdout = process.stdout) {
+        this._stdin = stdin;
+        this._stdout = stdout;
+    }
+    async start() {
+        if (this._started) {
+            throw new Error("StrictStdioServerTransport already started");
+        }
+        this._started = true;
+        this._stdin.on("data", this._ondata);
+        this._stdin.on("error", this._onstdinError);
+        // stdin EOF (peer disconnect) must propagate to onclose so the MCP server
+        // shuts down instead of lingering as a zombie process.
+        this._stdin.on("end", this._onstdinEnd);
+    }
+    async send(message, _options) {
+        const json = `${JSON.stringify(message)}\n`;
+        const next = this._writeChain.then(() => this._writeStdout(json), () => this._writeStdout(json));
+        // Swallow the rejection on the chain so a single failed write does not
+        // poison every subsequent send. Callers still see the original rejection.
+        this._writeChain = next.catch(() => undefined);
+        return next;
+    }
+    async close() {
+        if (this._closed)
+            return;
+        this._closed = true;
+        this._stdin.off("data", this._ondata);
+        this._stdin.off("error", this._onstdinError);
+        this._stdin.off("end", this._onstdinEnd);
+        this._chunks = [];
+        this._chunksLen = 0;
+        this._discardingFrame = false;
+        this.onclose?.();
+    }
+    _ondata = (chunk) => {
+        // If we are discarding the tail of an oversized frame, skip ahead to the
+        // next newline before resuming normal framing.
+        if (this._discardingFrame) {
+            const nl = chunk.indexOf(0x0a);
+            if (nl === -1)
+                return;
+            this._discardingFrame = false;
+            chunk = chunk.subarray(nl + 1);
+            if (chunk.length === 0)
+                return;
+        }
+        const projected = this._chunksLen + chunk.length;
+        const nlInChunk = chunk.indexOf(0x0a);
+        // No frame boundary in this chunk: just queue and bail. We cap the pending
+        // buffer at MAX_LINE_BYTES so a peer that never sends a newline cannot
+        // exhaust memory or pin the event loop.
+        if (nlInChunk === -1) {
+            if (projected > MAX_LINE_BYTES) {
+                this._resetChunks();
+                this._discardingFrame = true;
+                this._emitParseError(new Error(`JSON-RPC frame exceeded ${MAX_LINE_BYTES} bytes without a newline`));
+                return;
+            }
+            this._chunks.push(chunk);
+            this._chunksLen = projected;
+            return;
+        }
+        // Newline present — flatten once and process all complete lines. If the
+        // pending data + this chunk exceeds the cap and we have no terminator
+        // before the cap, reset and report a parse error.
+        this._chunks.push(chunk);
+        this._chunksLen = projected;
+        let buf = Buffer.concat(this._chunks, this._chunksLen);
+        this._resetChunks();
+        while (true) {
+            const idx = buf.indexOf(0x0a);
+            if (idx === -1)
+                break;
+            if (idx > MAX_LINE_BYTES) {
+                // The frame before the newline is too large; drop it and resync to
+                // the byte after the newline.
+                buf = buf.subarray(idx + 1);
+                this._emitParseError(new Error(`JSON-RPC frame exceeded ${MAX_LINE_BYTES} bytes without a newline`));
+                continue;
+            }
+            const line = buf.toString("utf8", 0, idx).replace(/\r$/, "");
+            buf = buf.subarray(idx + 1);
+            this._handleLine(line);
+        }
+        if (buf.length > 0) {
+            if (buf.length > MAX_LINE_BYTES) {
+                this._discardingFrame = true;
+                this._emitParseError(new Error(`JSON-RPC frame exceeded ${MAX_LINE_BYTES} bytes without a newline`));
+                return;
+            }
+            this._chunks.push(buf);
+            this._chunksLen = buf.length;
+        }
+    };
+    _onstdinError = (error) => {
+        this.onerror?.(error);
+    };
+    _onstdinEnd = () => {
+        void this.close();
+    };
+    _resetChunks() {
+        this._chunks = [];
+        this._chunksLen = 0;
+    }
+    _handleLine(line) {
+        if (line.length === 0)
+            return;
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            this._emitParseError(error instanceof Error ? error : new Error(detail));
+            return;
+        }
+        this.onmessage?.(parsed);
+    }
+    _emitParseError(error) {
+        // Drop the envelope when stdout is saturated or already closed. Without
+        // this drop a peer that floods malformed lines without reading stdout
+        // could pin unbounded -32700 replies in Node's internal write buffer.
+        // The onerror hook still surfaces every parse failure.
+        if (!this._closed && !this._stdoutSaturated) {
+            const envelope = {
+                jsonrpc: "2.0",
+                id: null,
+                error: { code: -32700, message: "Parse error", data: error.message },
+            };
+            try {
+                const ok = this._stdout.write(`${JSON.stringify(envelope)}\n`);
+                if (!ok) {
+                    this._markSaturated();
+                }
+            }
+            catch (writeErr) {
+                this.onerror?.(writeErr instanceof Error ? writeErr : new Error(String(writeErr)));
+            }
+        }
+        this.onerror?.(error);
+    }
+    _markSaturated() {
+        this._stdoutSaturated = true;
+        if (this._drainAttached)
+            return;
+        this._drainAttached = true;
+        this._stdout.once("drain", () => {
+            this._stdoutSaturated = false;
+            this._drainAttached = false;
+        });
+    }
+    _writeStdout(json) {
+        return new Promise((resolve, reject) => {
+            let written;
+            try {
+                written = this._stdout.write(json);
+            }
+            catch (err) {
+                reject(err instanceof Error ? err : new Error(String(err)));
+                return;
+            }
+            if (written) {
+                resolve();
+                return;
+            }
+            this._stdoutSaturated = true;
+            const onDrain = () => {
+                this._stdoutSaturated = false;
+                cleanup();
+                resolve();
+            };
+            const onClose = () => {
+                cleanup();
+                reject(new Error("stdout closed before drain"));
+            };
+            const onError = (err) => {
+                cleanup();
+                reject(err);
+            };
+            const cleanup = () => {
+                this._stdout.off("drain", onDrain);
+                this._stdout.off("close", onClose);
+                this._stdout.off("error", onError);
+            };
+            this._stdout.once("drain", onDrain);
+            this._stdout.once("close", onClose);
+            this._stdout.once("error", onError);
+        });
+    }
+    /** Test helper: feed bytes through the same path as live stdin data. */
+    feedForTest(chunk) {
+        const buf = typeof chunk === "string" ? Buffer.from(chunk, "utf8") : chunk;
+        this._ondata(buf);
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@framedash/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for the Framedash analytics platform",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "framedash-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "zod": "^3.25.0",
+    "@framedash/api-client": "0.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^3.2.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.2.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist"
+  }
+}