@databrainhq/mcp-server 0.2.17 → 0.3.0-rc.2

package/.claude-plugin/marketplace.json

@@ -0,0 +1,21 @@
+{
+  "name": "databrain",
+  "owner": {
+    "name": "Databrain"
+  },
+  "metadata": {
+    "description": "Agent workflows for Databrain analytics."
+  },
+  "plugins": [
+    {
+      "name": "databrain",
+      "description": "Author, style, and embed Databrain dashboards from an agent conversation, and render them as interactive tiles in chat.",
+      "version": "0.2.17",
+      "source": {
+        "source": "npm",
+        "package": "@databrainhq/mcp-server",
+        "version": "0.2.17"
+      }
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "databrain",
+  "version": "0.2.17",
+  "description": "Author, style, and embed Databrain dashboards from an agent conversation, and render them as interactive tiles in chat.",
+  "author": {
+    "name": "Databrain",
+    "url": "https://usedatabrain.com"
+  },
+  "homepage": "https://usedatabrain.com",
+  "repository": "https://github.com/databrainhq/mcp-server",
+  "license": "UNLICENSED",
+  "keywords": ["analytics", "dashboard", "databrain", "embed", "mcp-apps"]
+}

package/.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "databrain": {
+      "command": "npx",
+      "args": ["-y", "-p", "@databrainhq/mcp-server@latest", "databrain-mcp-chart-apps"],
+      "env": {
+        "DATABRAIN_SERVICE_TOKEN": "${DATABRAIN_SERVICE_TOKEN}"
+      }
+    }
+  }
+}

package/README.md

@@ -125,6 +125,25 @@ npx @databrainhq/mcp-server
 ```
 </details>
 
+### Interactive chart tiles (opt-in)
+
+The installed package also exposes an MCP Apps entry for hosts that render inline app resources. Select it explicitly with:
+
+```bash
+npx --yes --package @databrainhq/mcp-server databrain-mcp-chart-apps
+```
+
+In an MCP client configuration, use `npx` as the command and these arguments:
+
+```json
+{
+  "command": "npx",
+  "args": ["--yes", "--package", "@databrainhq/mcp-server", "databrain-mcp-chart-apps"]
+}
+```
+
+This opt-in entry adds the chart and KPI app resources plus their read-only interaction tools. The default `databrain-mcp-server` entry remains unchanged for existing clients that do not render MCP Apps.
+
 ### Self-hosted Databrain
 
 Running Databrain on your own infrastructure? Point the MCP server at your instance by setting `DATABRAIN_API_URL` alongside your token:

package/dist/apps/server.d.ts

@@ -0,0 +1,323 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+
+declare const configSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    serviceToken: z.ZodOptional<z.ZodString>;
+    apiToken: z.ZodOptional<z.ZodString>;
+    oauth: z.ZodOptional<z.ZodObject<{
+        issuer: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+        resource: z.ZodEffects<z.ZodString, string, string>;
+        scope: z.ZodOptional<z.ZodString>;
+        authMethod: z.ZodDefault<z.ZodEnum<["client_secret_basic", "client_secret_post"]>>;
+    }, "strip", z.ZodTypeAny, {
+        issuer: string;
+        clientId: string;
+        clientSecret: string;
+        resource: string;
+        authMethod: "client_secret_basic" | "client_secret_post";
+        scope?: string | undefined;
+    }, {
+        issuer: string;
+        clientId: string;
+        clientSecret: string;
+        resource: string;
+        scope?: string | undefined;
+        authMethod?: "client_secret_basic" | "client_secret_post" | undefined;
+    }>>;
+    apiUrl: z.ZodDefault<z.ZodString>;
+    demoDomain: z.ZodDefault<z.ZodString>;
+    posthogApiKey: z.ZodOptional<z.ZodString>;
+    posthogHost: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    apiUrl: string;
+    demoDomain: string;
+    serviceToken?: string | undefined;
+    apiToken?: string | undefined;
+    oauth?: {
+        issuer: string;
+        clientId: string;
+        clientSecret: string;
+        resource: string;
+        authMethod: "client_secret_basic" | "client_secret_post";
+        scope?: string | undefined;
+    } | undefined;
+    posthogApiKey?: string | undefined;
+    posthogHost?: string | undefined;
+}, {
+    serviceToken?: string | undefined;
+    apiToken?: string | undefined;
+    oauth?: {
+        issuer: string;
+        clientId: string;
+        clientSecret: string;
+        resource: string;
+        scope?: string | undefined;
+        authMethod?: "client_secret_basic" | "client_secret_post" | undefined;
+    } | undefined;
+    apiUrl?: string | undefined;
+    demoDomain?: string | undefined;
+    posthogApiKey?: string | undefined;
+    posthogHost?: string | undefined;
+}>, {
+    apiUrl: string;
+    demoDomain: string;
+    serviceToken?: string | undefined;
+    apiToken?: string | undefined;
+    oauth?: {
+        issuer: string;
+        clientId: string;
+        clientSecret: string;
+        resource: string;
+        authMethod: "client_secret_basic" | "client_secret_post";
+        scope?: string | undefined;
+    } | undefined;
+    posthogApiKey?: string | undefined;
+    posthogHost?: string | undefined;
+}, {
+    serviceToken?: string | undefined;
+    apiToken?: string | undefined;
+    oauth?: {
+        issuer: string;
+        clientId: string;
+        clientSecret: string;
+        resource: string;
+        scope?: string | undefined;
+        authMethod?: "client_secret_basic" | "client_secret_post" | undefined;
+    } | undefined;
+    apiUrl?: string | undefined;
+    demoDomain?: string | undefined;
+    posthogApiKey?: string | undefined;
+    posthogHost?: string | undefined;
+}>, {
+    apiUrl: string;
+    demoDomain: string;
+    serviceToken?: string | undefined;
+    apiToken?: string | undefined;
+    oauth?: {
+        issuer: string;
+        clientId: string;
+        clientSecret: string;
+        resource: string;
+        authMethod: "client_secret_basic" | "client_secret_post";
+        scope?: string | undefined;
+    } | undefined;
+    posthogApiKey?: string | undefined;
+    posthogHost?: string | undefined;
+}, {
+    serviceToken?: string | undefined;
+    apiToken?: string | undefined;
+    oauth?: {
+        issuer: string;
+        clientId: string;
+        clientSecret: string;
+        resource: string;
+        scope?: string | undefined;
+        authMethod?: "client_secret_basic" | "client_secret_post" | undefined;
+    } | undefined;
+    apiUrl?: string | undefined;
+    demoDomain?: string | undefined;
+    posthogApiKey?: string | undefined;
+    posthogHost?: string | undefined;
+}>;
+type Config = z.infer<typeof configSchema>;
+
+declare const referenceSchema: z.ZodObject<{
+    embedId: z.ZodString;
+    clientId: z.ZodString;
+    widgetId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    clientId: string;
+    embedId: string;
+    widgetId: string;
+}, {
+    clientId: string;
+    embedId: string;
+    widgetId: string;
+}>;
+type ChartReference = z.infer<typeof referenceSchema>;
+declare const viewSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    dateRange: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        from: string;
+        to: string;
+    }, {
+        from: string;
+        to: string;
+    }>, {
+        from: string;
+        to: string;
+    }, {
+        from: string;
+        to: string;
+    }>>;
+    drillId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    cursor?: string | undefined;
+    drillId?: string | undefined;
+    dateRange?: {
+        from: string;
+        to: string;
+    } | undefined;
+}, {
+    cursor?: string | undefined;
+    drillId?: string | undefined;
+    dateRange?: {
+        from: string;
+        to: string;
+    } | undefined;
+}>;
+declare const pageSchema: z.ZodEffects<z.ZodObject<{
+    kind: z.ZodEnum<["chart", "kpi"]>;
+    title: z.ZodString;
+    chartSpec: z.ZodObject<{
+        type: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: string;
+    }, {
+        type: string;
+    }>;
+    rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, "many">;
+    columns: z.ZodArray<z.ZodString, "many">;
+    svg: z.ZodOptional<z.ZodString>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    points: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+        value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        drillId: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        value: string | number | boolean | null;
+        label: string;
+        key: string;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        drillId?: string | undefined;
+    }, {
+        value: string | number | boolean | null;
+        label: string;
+        key: string;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        drillId?: string | undefined;
+    }>, "many">;
+    value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+    nextCursor: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "chart" | "kpi";
+    title: string;
+    columns: string[];
+    width: number;
+    height: number;
+    chartSpec: {
+        type: string;
+    };
+    rows: Record<string, string | number | boolean | null>[];
+    points: {
+        value: string | number | boolean | null;
+        label: string;
+        key: string;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        drillId?: string | undefined;
+    }[];
+    value?: string | number | boolean | null | undefined;
+    svg?: string | undefined;
+    nextCursor?: string | undefined;
+}, {
+    kind: "chart" | "kpi";
+    title: string;
+    columns: string[];
+    width: number;
+    height: number;
+    chartSpec: {
+        type: string;
+    };
+    rows: Record<string, string | number | boolean | null>[];
+    points: {
+        value: string | number | boolean | null;
+        label: string;
+        key: string;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        drillId?: string | undefined;
+    }[];
+    value?: string | number | boolean | null | undefined;
+    svg?: string | undefined;
+    nextCursor?: string | undefined;
+}>, {
+    kind: "chart" | "kpi";
+    title: string;
+    columns: string[];
+    width: number;
+    height: number;
+    chartSpec: {
+        type: string;
+    };
+    rows: Record<string, string | number | boolean | null>[];
+    points: {
+        value: string | number | boolean | null;
+        label: string;
+        key: string;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        drillId?: string | undefined;
+    }[];
+    value?: string | number | boolean | null | undefined;
+    svg?: string | undefined;
+    nextCursor?: string | undefined;
+}, {
+    kind: "chart" | "kpi";
+    title: string;
+    columns: string[];
+    width: number;
+    height: number;
+    chartSpec: {
+        type: string;
+    };
+    rows: Record<string, string | number | boolean | null>[];
+    points: {
+        value: string | number | boolean | null;
+        label: string;
+        key: string;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        drillId?: string | undefined;
+    }[];
+    value?: string | number | boolean | null | undefined;
+    svg?: string | undefined;
+    nextCursor?: string | undefined;
+}>;
+type ChartPage = z.infer<typeof pageSchema>;
+type ChartView = z.infer<typeof viewSchema>;
+
+type ChartAction = 'render_chart' | 'refresh_widget' | 'drill_down' | 'change_date_range';
+interface ChartBackend {
+    execute(action: ChartAction, reference: ChartReference, view: ChartView): Promise<ChartPage>;
+}
+
+/** Reviewable composition seam; hosted owners must retain their principal-bound client/policy. */
+declare function createChartAppServer(config: Config, backend?: ChartBackend): McpServer;
+
+export { createChartAppServer };

package/dist/apps/server.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import {
+  createChartAppServer
+} from "../chunk-SG7F7PRY.js";
+import "../chunk-3AFT7S6E.js";
+export {
+  createChartAppServer
+};
+//# sourceMappingURL=server.js.map

package/dist/apps/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/apps/stdio.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/apps/stdio.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import {
+  loadConfig
+} from "../chunk-4OFVDEFU.js";
+import {
+  createChartAppServer
+} from "../chunk-SG7F7PRY.js";
+import "../chunk-3AFT7S6E.js";
+
+// src/apps/stdio.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+var server = createChartAppServer(loadConfig());
+await server.connect(new StdioServerTransport());
+//# sourceMappingURL=stdio.js.map

package/dist/apps/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/apps/stdio.ts"],"sourcesContent":["import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { loadConfig } from '../utils/config.js';\nimport { createChartAppServer } from './server.js';\n\n// Separate opt-in command until the owners integrate both shared entrypoints.\nconst server = createChartAppServer(loadConfig());\nawait server.connect(new StdioServerTransport());\n"],"mappings":";;;;;;;;;;AAAA,SAAS,4BAA4B;AAKrC,IAAM,SAAS,qBAAqB,WAAW,CAAC;AAChD,MAAM,OAAO,QAAQ,IAAI,qBAAqB,CAAC;","names":[]}