@databrainhq/mcp-server 0.2.15 → 0.2.16

package/dist/index.js

@@ -326,7 +326,7 @@ var DatabrainClient = class {
         }
         const text = await response.text();
         let data = text ? JSON.parse(text) : {};
-        if (data && typeof data === "object" && !Array.isArray(data) && "data" in data) {
+        if (!options.skipDataUnwrap && data && typeof data === "object" && !Array.isArray(data) && "data" in data) {
           const inner = data.data;
           if (inner !== null && inner !== void 0) {
             data = inner;
@@ -735,9 +735,10 @@ var TenantsApi = class {
     }
     return this.client.request({
       method: "POST",
-      path: "/hasuraActions/getClientData",
+      path: "/api/mcp/getClientData",
       auth: "service",
       body: { input: { input } },
+      skipDataUnwrap: true,
       cacheKey: `list_tenants:${JSON.stringify(input)}`,
       cacheTtlMs: 5 * 60 * 1e3
     });
@@ -6044,26 +6045,97 @@ function registerCreateOrUpdateMetricFromQuery(server, client) {
   );
 }
 
-// src/tools/widgets/validate-metric-spec.ts
+// src/tools/widgets/create-workspace-metric.ts
 import { z as z31 } from "zod";
+var modeSchema2 = z31.enum(["dry_run", "apply"]).default("dry_run");
+function registerCreateWorkspaceMetric(server, client) {
+  server.tool(
+    "create_workspace_metric",
+    "Create a workspace-level metric from validated SQL using the org service token. Scoped to the workspace, unpublished, and NOT attached to any dashboard. Defaults to dry-run; apply requires explicit confirmation.",
+    {
+      mode: modeSchema2.describe(
+        "dry_run validates the SQL only (no write); apply creates the metric after confirmation"
+      ),
+      confirm: z31.string().optional().describe(`Required for apply: ${APPLY_TO_PRODUCTION_CONFIRMATION}`),
+      workspaceName: z31.string().describe("Target workspace name"),
+      name: z31.string().describe("Metric display name"),
+      query: z31.string().describe("SQL query to validate and store"),
+      metricId: z31.string().optional().describe("Stable metric slug; generated from the name if omitted"),
+      description: z31.string().optional().describe("Metric description"),
+      datasourceId: z31.string().optional().describe("Datasource UUID override; defaults to the workspace datasource"),
+      isPublished: z31.boolean().optional().describe("Publish after apply. Defaults to false for safety")
+    },
+    WRITE_CREATE,
+    async (params) => {
+      try {
+        const mode = params.mode || "dry_run";
+        if (!params.name.trim()) return toolError("`name` cannot be empty.");
+        if (!params.query.trim()) return toolError("`query` cannot be empty.");
+        const isApply = mode === "apply";
+        if (isApply) {
+          const guardError = validateProductionApply({
+            workspaceName: params.workspaceName,
+            confirm: params.confirm
+          });
+          if (guardError) return toolError(guardError);
+        }
+        const body = {
+          workspaceName: params.workspaceName,
+          name: params.name,
+          query: params.query,
+          metricId: params.metricId,
+          description: params.description,
+          datasourceId: params.datasourceId,
+          isPublished: params.isPublished ?? false,
+          validateOnly: !isApply
+        };
+        const result = await client.request({
+          method: "POST",
+          // MCP-only control-plane route (not the public /api/v2 surface).
+          path: "/api/mcp/metrics/create",
+          auth: "service",
+          body
+        });
+        return toolSuccess(
+          JSON.stringify(
+            {
+              mode,
+              safety: productionSafetyNote(params.workspaceName),
+              result,
+              nextStep: isApply ? "Metric created unpublished and unattached. Publish/attach it to a dashboard as a separate step when ready." : 'Dry-run only \u2014 no metric written. Re-run with mode "apply" and confirm to create it.'
+            },
+            null,
+            2
+          )
+        );
+      } catch (err) {
+        if (err instanceof DatabrainApiError) return err.toToolResponse();
+        return toolError(`Unexpected error: ${err.message}`);
+      }
+    }
+  );
+}
+
+// src/tools/widgets/validate-metric-spec.ts
+import { z as z32 } from "zod";
 function registerValidateMetricSpec(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "validate_metric_spec",
     "Validate a production metric spec from SQL without saving it. Resolves dashboard, data app, datasource, conflicts, and required fields.",
     {
-      clientId: z31.string().describe("Client/tenant identifier used to validate dashboard widget scope"),
-      workspaceName: z31.string().describe("Target production-backed workspace name"),
-      dashboardName: z31.string().optional().describe("Dashboard name to attach to"),
-      embedId: z31.string().optional().describe("Technical embed id alternative to dashboardName"),
-      dataAppName: z31.string().optional().describe("Optional data app override"),
-      name: z31.string().describe("Metric/widget display name"),
-      metricId: z31.string().describe("Stable metric slug to create or update"),
-      query: z31.string().describe("SQL query already validated against the warehouse"),
-      description: z31.string().optional().describe("Metric description"),
-      chartOptions: z31.record(z31.unknown()).optional().describe("Chart configuration JSON"),
-      companyIntegrationId: z31.string().optional().describe("Datasource UUID override"),
-      integrationName: z31.string().optional().describe("Datasource display name override")
+      clientId: z32.string().describe("Client/tenant identifier used to validate dashboard widget scope"),
+      workspaceName: z32.string().describe("Target production-backed workspace name"),
+      dashboardName: z32.string().optional().describe("Dashboard name to attach to"),
+      embedId: z32.string().optional().describe("Technical embed id alternative to dashboardName"),
+      dataAppName: z32.string().optional().describe("Optional data app override"),
+      name: z32.string().describe("Metric/widget display name"),
+      metricId: z32.string().describe("Stable metric slug to create or update"),
+      query: z32.string().describe("SQL query already validated against the warehouse"),
+      description: z32.string().optional().describe("Metric description"),
+      chartOptions: z32.record(z32.unknown()).optional().describe("Chart configuration JSON"),
+      companyIntegrationId: z32.string().optional().describe("Datasource UUID override"),
+      integrationName: z32.string().optional().describe("Datasource display name override")
     },
     READ_ONLY,
     async (params) => {
@@ -6154,20 +6226,20 @@ function registerValidateMetricSpec(server, client) {
 }
 
 // src/tools/reports/list-scheduled-reports.ts
-import { z as z32 } from "zod";
+import { z as z33 } from "zod";
 function registerListScheduledReports(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "list_scheduled_reports",
     "List configured scheduled reports for a specific client/dashboard embed. Shows schedule metadata, not delivery success history.",
     {
-      clientId: z32.string().describe("Client/tenant identifier. Required by the current backend API for non-empty results"),
-      dashboardName: z32.string().optional().describe("Dashboard name to inspect"),
-      workspaceName: z32.string().optional().describe("Workspace name if dashboardName is ambiguous"),
-      embedId: z32.string().optional().describe("Technical embed id alternative to dashboardName"),
-      userIdentifier: z32.string().optional().describe("Optional creator/user filter"),
-      pageNumber: z32.number().int().positive().optional().describe("Page number when pagination is enabled"),
-      isPagination: z32.boolean().optional().describe("Enable backend pagination")
+      clientId: z33.string().describe("Client/tenant identifier. Required by the current backend API for non-empty results"),
+      dashboardName: z33.string().optional().describe("Dashboard name to inspect"),
+      workspaceName: z33.string().optional().describe("Workspace name if dashboardName is ambiguous"),
+      embedId: z33.string().optional().describe("Technical embed id alternative to dashboardName"),
+      userIdentifier: z33.string().optional().describe("Optional creator/user filter"),
+      pageNumber: z33.number().int().positive().optional().describe("Page number when pagination is enabled"),
+      isPagination: z33.boolean().optional().describe("Enable backend pagination")
     },
     READ_ONLY,
     async (params) => {
@@ -6300,6 +6372,7 @@ function registerAllTools(server, client) {
   registerListWidgets(server, client);
   registerValidateMetricSpec(server, client);
   registerCreateOrUpdateMetricFromQuery(server, client);
+  registerCreateWorkspaceMetric(server, client);
   registerAddWidget(server, client);
   registerUpdateWidget(server, client);
   registerRemoveWidget(server, client);