@databrainhq/mcp-server 0.2.2 → 0.2.3

package/dist/index.js

@@ -218,7 +218,7 @@ var DatabrainClient = class {
       throw new DatabrainApiError(
         401,
         "MISSING_API_TOKEN",
-        "A per-data-app API token is required for this embedding operation but none is configured. Use `setup_embed_interactive` with step `ensure_api_token` to create or set one, or call `create_api_token` / `set_api_token` directly. Do not ask the user for this token \u2014 create it via the MCP tools."
+        "A per-data-app API token is required for this embedding operation but none is configured. Call `create_api_token` to generate one, or `set_api_token` if you already have the value. Do not ask the user for this token \u2014 create it via the MCP tools."
       );
     }
     let url = `${this.config.apiUrl}${options.path}`;
@@ -1690,7 +1690,7 @@ Next: use \`generate_guest_token\` with the clientId and \`generate_embed_code\`
 - workspaceName: \`${body.workspaceName}\`
 - accessSettings.datamartName: \`${datamartName}\`
 
-Next: run \`get_embed_details\` and \`diagnose_embed_health\` to verify update compatibility.`
+Next: run \`get_embed_details\` to verify the embed configuration.`
         );
       } catch (err) {
         if (err instanceof DatabrainApiError) return err.toToolResponse();
@@ -2377,612 +2377,71 @@ Use \`get_embed_details\` to view the full current theme configuration.` + GUEST
   );
 }
 
-// src/tools/embed/configure-embed.ts
-import { z as z15 } from "zod";
-var stringFilterSchema = z15.object({
-  filterName: z15.string().describe("Name of the filter as it appears in the dashboard"),
-  options: z15.array(z15.object({
-    value: z15.string(),
-    label: z15.string()
-  })).describe("Dropdown options"),
-  defaultOption: z15.union([z15.string(), z15.array(z15.string())]).optional().describe("Default selected value (string or array for multi-select)")
-});
-var numberFilterSchema = z15.object({
-  filterName: z15.string().describe("Name of the filter"),
-  min: z15.number().describe("Minimum value"),
-  max: z15.number().describe("Maximum value")
-});
-var datePresetSchema = z15.object({
-  type: z15.string().optional().describe('Preset type (e.g. "Last", "This")'),
-  interval: z15.string().optional().describe('Interval (e.g. "Days", "Months", "Years")'),
-  timeGrain: z15.string().optional().describe("Time grain"),
-  label: z15.string().describe('Display label (e.g. "Last 30 Days")'),
-  startDate: z15.string().optional().describe("Start date (YYYY-MM-DD)"),
-  endDate: z15.string().optional().describe("End date (YYYY-MM-DD)")
-});
-var dateFilterSchema = z15.object({
-  filterName: z15.string().describe("Name of the filter"),
-  startDate: z15.string().optional().describe("Default start date (YYYY-MM-DD)"),
-  endDate: z15.string().optional().describe("Default end date (YYYY-MM-DD)"),
-  datePresetOptions: z15.array(datePresetSchema).optional().describe("Custom date presets to show in the date picker")
-});
-var sqlFilterSchema = z15.object({
-  filterName: z15.string().describe("Name of the filter"),
-  sql: z15.string().describe("SQL query to fetch filter options"),
-  columnName: z15.string().describe("Column from the SQL result to use as option values")
-});
-var SUPPORTED_LANGUAGES = [
-  "en",
-  "fr",
-  "es",
-  "de",
-  "it",
-  "pt",
-  "zh",
-  "ja",
-  "ko",
-  "hi",
-  "ar",
-  "ru"
-];
-function registerConfigureEmbed(server, client) {
-  const services = createServiceBundle(client);
-  server.tool(
-    "configure_embed",
-    "Configure embed options (UI toggles, downloads, layout), filters (string/date/number/SQL), and i18n (language, translations).",
-    {
-      embedId: z15.string().describe("ID of the embed to configure"),
-      body: z15.record(z15.unknown()).optional().describe(
-        "Raw API body for PUT /api/v2/data-app/embeds. If provided, sent directly and convenience fields are ignored."
-      ),
-      // ===== OPTIONS (from configure_embed_options) =====
-      // Metric Operations
-      disableMetricCreation: z15.boolean().optional().describe("Disable creating new metrics"),
-      disableMetricUpdation: z15.boolean().optional().describe("Disable updating existing metrics"),
-      disableMetricDeletion: z15.boolean().optional().describe("Disable deleting metrics"),
-      disableManageMetrics: z15.boolean().optional().describe("Hide the manage metrics interface"),
-      // Layout
-      disableLayoutCustomization: z15.boolean().optional().describe("Prevent layout changes"),
-      disableSaveLayout: z15.boolean().optional().describe("Prevent saving layout changes"),
-      // Downloads & Export
-      enableDownloadCsv: z15.boolean().optional().describe("Enable CSV download for individual metrics"),
-      enableEmailCsv: z15.boolean().optional().describe("Enable emailing metric data as CSV"),
-      disableDownloadPng: z15.boolean().optional().describe("Disable PNG download in fullscreen"),
-      enableDownloadAllMetrics: z15.boolean().optional().describe("Enable bulk download of all metrics as CSV"),
-      enableDownloadAllPdf: z15.boolean().optional().describe("Enable downloading entire dashboard as PDF"),
-      disableDownloadDataNoFilters: z15.boolean().optional().describe("Prevent data download when no filters"),
-      disableDownloadUnderlyingDataNoFilters: z15.boolean().optional().describe("Prevent underlying data download without filters"),
-      // UI Visibility
-      hideDashboardName: z15.boolean().optional().describe("Hide the dashboard title"),
-      hideMetricCardShadow: z15.boolean().optional().describe("Remove card shadow effects"),
-      disableMetricCardBorder: z15.boolean().optional().describe("Remove metric card borders"),
-      showDashboardActions: z15.boolean().optional().describe("Show/hide dashboard action buttons"),
-      disableFullscreen: z15.boolean().optional().describe("Disable fullscreen mode"),
-      isHideTablePreview: z15.boolean().optional().describe("Hide table preview in fullscreen"),
-      isHideChartSettings: z15.boolean().optional().describe("Hide chart settings in fullscreen"),
-      shouldFitFullScreen: z15.boolean().optional().describe("Make fullscreen modal fit the component space"),
-      // Loaders
-      disableMainLoader: z15.boolean().optional().describe("Hide the main loading indicator"),
-      disableMetricLoader: z15.boolean().optional().describe("Hide metric-level loading indicators"),
-      // Data Access
-      disableUnderlyingData: z15.boolean().optional().describe("Disable access to underlying data"),
-      isShowNoDataFoundScreen: z15.boolean().optional().describe('Show a "no data" screen when data unavailable'),
-      // Scheduling
-      disableScheduleEmailReports: z15.boolean().optional().describe("Disable email report scheduling"),
-      // Interactions
-      isStickyDashboardFilters: z15.boolean().optional().describe("Make filters sticky when scrolling"),
-      enableMultiMetricFilters: z15.boolean().optional().describe("Enable cross-metric filter interactions"),
-      optionsIcon: z15.enum(["kebab-menu-vertical", "download"]).optional().describe("Menu icon style"),
-      enableTitleClickFullscreen: z15.boolean().optional().describe("Click metric title to enter fullscreen"),
-      // Export
-      exportMsgPosition: z15.enum([
-        "bottom",
-        "bottom-left",
-        "bottom-right",
-        "center",
-        "top",
-        "top-left",
-        "top-right"
-      ]).optional().describe('Position of "exporting" notification message'),
-      isModifyUrl: z15.boolean().optional().describe("Whether navigating metrics modifies the browser URL"),
-      // No-data visuals
-      noDataImg: z15.string().optional().describe("URL to custom image when no data found"),
-      noDataFoundSvg: z15.string().optional().describe("Inline SVG when no data found"),
-      // Metric description
-      longDescriptionWidth: z15.string().optional().describe('Width of long-description tooltip (e.g. "300px")'),
-      longDescriptionFontColor: z15.string().optional().describe("Font color for long-description tooltip (hex)"),
-      // Settings icon
-      settingsIconName: z15.string().optional().describe("Custom name/label for the settings icon"),
-      settingsIconSvg: z15.string().optional().describe("Inline SVG for a custom settings icon"),
-      // Advanced: per-chart settings
-      customChartSettings: z15.record(z15.unknown()).optional().describe("Per-chart override settings (JSON)"),
-      // Custom Messages
-      tokenExpiryMessage: z15.string().optional().describe("Custom message when token expires"),
-      tokenAbsentMessage: z15.string().optional().describe("Custom message when token is missing"),
-      // ===== FILTERS (from configure_filters) =====
-      stringFilters: z15.array(stringFilterSchema).optional().describe("String filter configurations with dropdown options and defaults"),
-      numberFilters: z15.array(numberFilterSchema).optional().describe("Number filter configurations with min/max defaults"),
-      dateFilters: z15.array(dateFilterSchema).optional().describe("Date filter configurations with default ranges and presets"),
-      sqlFilters: z15.array(sqlFilterSchema).optional().describe("SQL-based filter options for large option sets"),
-      hideDashboardFilters: z15.array(z15.string()).optional().describe("Filter names to hide from the dashboard UI"),
-      hideDatePickerOptions: z15.array(z15.string()).optional().describe('Date picker options to hide (e.g. ["this month", "yesterday"])'),
-      metricFilterPosition: z15.enum(["inside", "outside"]).optional().describe("Where to display metric-level filters"),
-      // ===== INTERNATIONALIZATION (from configure_internationalization) =====
-      language: z15.enum(SUPPORTED_LANGUAGES).optional().describe('Primary language code (e.g. "fr", "es", "ja")'),
-      calendarType: z15.enum(["default", "ind"]).optional().describe('Calendar system: "default" or "ind" (Indian)'),
-      translations: z15.array(z15.object({
-        key: z15.string().describe("Original text to translate (must match exactly)"),
-        translations: z15.record(z15.string()).describe("Language code \u2192 translation mapping")
-      })).optional().describe("Translation dictionary entries")
-    },
-    WRITE_IDEMPOTENT,
-    async (params) => {
-      const { embedId, body, ...opts } = params;
-      if (body) {
-        try {
-          const rawBody = { ...body };
-          if (!rawBody.embedId) rawBody.embedId = embedId;
-          const result = await services.embedsApi.updateEmbed(rawBody);
-          if (result.error) {
-            return toolError(`Embed configuration failed: ${stringify(result.error)}`);
-          }
-          return toolSuccess(
-            `Embed configured for "${embedId}" (raw passthrough mode).` + GUEST_TOKEN_REMINDER
-          );
-        } catch (err) {
-          const guardrail = await maybeBuildCorruptedEmbedGuardrail(client, embedId, "configure embed", err);
-          if (guardrail) return guardrail;
-          if (err instanceof DatabrainApiError) return err.toToolResponse();
-          return toolError(`Unexpected error: ${err.message}`);
-        }
-      }
-      const options = {};
-      const attrs = {};
-      const configured = [];
-      if (opts.disableMetricCreation !== void 0) options.disableMetricCreation = opts.disableMetricCreation;
-      if (opts.disableMetricUpdation !== void 0) options.disableMetricUpdation = opts.disableMetricUpdation;
-      if (opts.disableMetricDeletion !== void 0) options.disableMetricDeletion = opts.disableMetricDeletion;
-      if (opts.disableManageMetrics !== void 0) options.disableManageMetrics = opts.disableManageMetrics;
-      if (opts.disableLayoutCustomization !== void 0) options.disableLayoutCustomization = opts.disableLayoutCustomization;
-      if (opts.disableSaveLayout !== void 0) options.disableSaveLayout = opts.disableSaveLayout;
-      if (opts.disableDownloadDataNoFilters !== void 0) options.disableDownloadDataNoFilters = opts.disableDownloadDataNoFilters;
-      if (opts.disableDownloadUnderlyingDataNoFilters !== void 0) options.disableDownloadUnderlyingDataNoFilters = opts.disableDownloadUnderlyingDataNoFilters;
-      if (opts.hideDashboardName !== void 0) options.hideDashboardName = opts.hideDashboardName;
-      if (opts.hideMetricCardShadow !== void 0) options.hideMetricCardShadow = opts.hideMetricCardShadow;
-      if (opts.disableMetricCardBorder !== void 0) options.disableMetricCardBorder = opts.disableMetricCardBorder;
-      if (opts.showDashboardActions !== void 0) options.showDashboardActions = opts.showDashboardActions;
-      if (opts.shouldFitFullScreen !== void 0) options.shouldFitFullScreen = opts.shouldFitFullScreen;
-      if (opts.isShowNoDataFoundScreen !== void 0) options.isShowNoDataFoundScreen = opts.isShowNoDataFoundScreen;
-      if (opts.disableMainLoader !== void 0) options.disableMainLoader = opts.disableMainLoader;
-      if (opts.disableMetricLoader !== void 0) options.disableMetricLoader = opts.disableMetricLoader;
-      if (opts.disableUnderlyingData !== void 0) options.disableUnderlyingData = opts.disableUnderlyingData;
-      if (opts.disableScheduleEmailReports !== void 0) options.disableScheduleEmailReports = opts.disableScheduleEmailReports;
-      if (opts.exportMsgPosition) options.exportMsgPosition = opts.exportMsgPosition;
-      if (opts.isModifyUrl !== void 0) options.isModifyUrl = opts.isModifyUrl;
-      if (opts.enableDownloadCsv !== void 0) attrs.enableDownloadCsv = opts.enableDownloadCsv;
-      if (opts.enableEmailCsv !== void 0) attrs.enableEmailCsv = opts.enableEmailCsv;
-      if (opts.disableDownloadPng !== void 0) attrs.disableDownloadPng = opts.disableDownloadPng;
-      if (opts.enableDownloadAllMetrics !== void 0) attrs.enableDownloadAllMetrics = opts.enableDownloadAllMetrics;
-      if (opts.enableDownloadAllPdf !== void 0) attrs.enableDownloadAllPdf = opts.enableDownloadAllPdf;
-      if (opts.disableFullscreen !== void 0) attrs.disableFullscreen = opts.disableFullscreen;
-      if (opts.isHideTablePreview !== void 0) attrs.isHideTablePreview = opts.isHideTablePreview;
-      if (opts.isHideChartSettings !== void 0) attrs.isHideChartSettings = opts.isHideChartSettings;
-      if (opts.isStickyDashboardFilters !== void 0) attrs.isStickyDashboardFilters = opts.isStickyDashboardFilters;
-      if (opts.enableMultiMetricFilters !== void 0) attrs.enableMultiMetricFilters = opts.enableMultiMetricFilters;
-      if (opts.optionsIcon) attrs.optionsIcon = opts.optionsIcon;
-      if (opts.enableTitleClickFullscreen !== void 0) attrs.enableTitleClickFullscreen = opts.enableTitleClickFullscreen;
-      if (opts.noDataImg) attrs.noDataImg = opts.noDataImg;
-      if (opts.noDataFoundSvg) attrs.noDataFoundSvg = opts.noDataFoundSvg;
-      if (opts.customChartSettings) attrs.customChartSettings = opts.customChartSettings;
-      if (opts.longDescriptionWidth || opts.longDescriptionFontColor) {
-        attrs.longDescriptionConfig = {
-          ...opts.longDescriptionWidth && { width: opts.longDescriptionWidth },
-          ...opts.longDescriptionFontColor && { fontColor: opts.longDescriptionFontColor }
-        };
-      }
-      if (opts.settingsIconName || opts.settingsIconSvg) {
-        attrs.settingsIcon = {
-          ...opts.settingsIconName && { name: opts.settingsIconName },
-          ...opts.settingsIconSvg && { iconSvg: opts.settingsIconSvg }
-        };
-      }
-      const customMessages = {};
-      if (opts.tokenExpiryMessage) customMessages.tokenExpiry = opts.tokenExpiryMessage;
-      if (opts.tokenAbsentMessage) customMessages.tokenAbsent = opts.tokenAbsentMessage;
-      if (Object.keys(customMessages).length) options.customMessages = customMessages;
-      const globalFilterOptions = {};
-      if (opts.stringFilters) {
-        for (const f of opts.stringFilters) {
-          globalFilterOptions[f.filterName] = {
-            options: f.options,
-            ...f.defaultOption !== void 0 && { defaultOption: f.defaultOption }
-          };
-        }
-        configured.push(`${opts.stringFilters.length} string filter(s)`);
-      }
-      if (opts.numberFilters) {
-        for (const f of opts.numberFilters) {
-          globalFilterOptions[f.filterName] = {
-            defaultOption: { min: f.min, max: f.max }
-          };
-        }
-        configured.push(`${opts.numberFilters.length} number filter(s)`);
-      }
-      if (opts.dateFilters) {
-        for (const f of opts.dateFilters) {
-          const config = {};
-          if (f.startDate || f.endDate) {
-            config.defaultOption = {
-              ...f.startDate && { startDate: f.startDate },
-              ...f.endDate && { endDate: f.endDate }
-            };
-          }
-          if (f.datePresetOptions) config.datePresetOptions = f.datePresetOptions;
-          globalFilterOptions[f.filterName] = config;
-        }
-        configured.push(`${opts.dateFilters.length} date filter(s)`);
-      }
-      if (opts.sqlFilters) {
-        for (const f of opts.sqlFilters) {
-          globalFilterOptions[f.filterName] = {
-            sql: f.sql,
-            columnName: f.columnName
-          };
-        }
-        configured.push(`${opts.sqlFilters.length} SQL filter(s)`);
-      }
-      if (Object.keys(globalFilterOptions).length) options.globalFilterOptions = globalFilterOptions;
-      if (opts.hideDashboardFilters) {
-        attrs.hideDashboardFilters = opts.hideDashboardFilters;
-        configured.push(`hiding ${opts.hideDashboardFilters.length} filter(s)`);
-      }
-      if (opts.hideDatePickerOptions) {
-        options.hideDatePickerOptions = opts.hideDatePickerOptions;
-        configured.push(`hiding ${opts.hideDatePickerOptions.length} date picker option(s)`);
-      }
-      if (opts.metricFilterPosition) {
-        attrs.metricFilterPosition = opts.metricFilterPosition;
-        configured.push(`metric filter position: ${opts.metricFilterPosition}`);
-      }
-      if (opts.language) {
-        attrs.language = opts.language;
-        configured.push(`language: ${opts.language}`);
-      }
-      if (opts.calendarType) {
-        attrs.calendarType = opts.calendarType;
-        configured.push(`calendar: ${opts.calendarType}`);
-      }
-      if (opts.translations?.length) {
-        const dict = {};
-        for (const entry of opts.translations) {
-          dict[entry.key] = entry.translations;
-        }
-        attrs.translationDictionary = dict;
-        configured.push(`${opts.translations.length} translation(s)`);
-      }
-      const optionKeys = Object.keys(options).filter((k) => k !== "globalFilterOptions" && k !== "customMessages" && k !== "hideDatePickerOptions");
-      const attrKeys = Object.keys(attrs).filter(
-        (k) => k !== "hideDashboardFilters" && k !== "metricFilterPosition" && k !== "language" && k !== "calendarType" && k !== "translationDictionary"
-      );
-      if (optionKeys.length || attrKeys.length) {
-        configured.push(`${optionKeys.length + attrKeys.length} display option(s)`);
-      }
-      if (Object.keys(options).length === 0 && Object.keys(attrs).length === 0) {
-        return toolError("No configuration provided. Specify at least one option, filter, or i18n setting.");
-      }
-      try {
-        const patch = {};
-        if (Object.keys(options).length) patch.options = options;
-        if (Object.keys(attrs).length) patch.componentAttributes = attrs;
-        const result = await services.embedService.updateEmbed(embedId, patch);
-        if (result.error) {
-          return toolError(`Embed configuration failed: ${stringify(result.error)}`);
-        }
-        return toolSuccess(
-          `Embed configured for "${embedId}".
-
-**Configured:** ${configured.join(", ")}
-
-Use \`get_embed_details\` to view the full configuration.` + GUEST_TOKEN_REMINDER
-        );
-      } catch (err) {
-        const guardrail = await maybeBuildCorruptedEmbedGuardrail(client, embedId, "configure embed", err);
-        if (guardrail) return guardrail;
-        if (err instanceof DatabrainApiError) return err.toToolResponse();
-        return toolError(`Unexpected error: ${err.message}`);
-      }
-    }
-  );
-}
-
-// src/tools/embed/diagnose-embed-health.ts
-import { z as z16 } from "zod";
-function asRecord2(value) {
-  return value && typeof value === "object" ? value : null;
-}
-function firstString(...values) {
-  for (const v of values) {
-    if (typeof v === "string" && v.trim().length > 0) return v;
-  }
-  return null;
-}
-function runRuntimeReadinessChecks(params) {
-  const payload = params.guestTokenBody ?? {
-    clientId: params.clientId,
-    dataAppName: params.dataAppName,
-    permissions: params.permissions
-  };
-  const checks = [];
-  const topLevelPermissions = payload.permissions;
-  const paramsObj = payload.params;
-  const nestedPermissions = paramsObj?.permissions;
-  checks.push({
-    check: "Top-level dataAppName",
-    status: typeof payload.dataAppName === "string" && payload.dataAppName.length > 0 ? "pass" : "fail",
-    details: typeof payload.dataAppName === "string" && payload.dataAppName.length > 0 ? "dataAppName is present at top level." : "Missing top-level dataAppName in guest token body."
-  });
-  checks.push({
-    check: "Top-level permissions object",
-    status: typeof topLevelPermissions === "object" && topLevelPermissions !== null ? "pass" : "fail",
-    details: typeof topLevelPermissions === "object" && topLevelPermissions !== null ? "permissions is present at top level." : "Missing top-level permissions object."
-  });
-  checks.push({
-    check: "No nested permissions in params",
-    status: nestedPermissions ? "fail" : "pass",
-    details: nestedPermissions ? "Found params.permissions. Move permissions to top level." : "No nested permissions found."
-  });
-  const disableMetricCreationFromToken = typeof topLevelPermissions === "object" && topLevelPermissions !== null ? topLevelPermissions.isDisableMetricCreation : void 0;
-  checks.push({
-    check: "Guest token metric creation gate",
-    status: disableMetricCreationFromToken === true ? "fail" : "pass",
-    details: disableMetricCreationFromToken === true ? "permissions.isDisableMetricCreation=true blocks + Create Metric." : "permissions.isDisableMetricCreation is not forcing metric creation off."
-  });
-  if (params.embedOptions) {
-    checks.push({
-      check: "Embed option metric creation gate",
-      status: params.embedOptions.disableMetricCreation === true ? "fail" : "pass",
-      details: params.embedOptions.disableMetricCreation === true ? "embed option disableMetricCreation=true blocks + Create Metric." : "Embed options are not forcing metric creation off."
-    });
-  }
-  if (params.dashboardRuntime) {
-    checks.push({
-      check: "Dashboard runtime: isAllowedToCreateMetrics",
-      status: params.dashboardRuntime.isAllowedToCreateMetrics === true ? "pass" : "fail",
-      details: params.dashboardRuntime.isAllowedToCreateMetrics === true ? "Dashboard runtime allows metric creation." : "Dashboard runtime says metric creation is not allowed."
-    });
-    checks.push({
-      check: "Dashboard runtime: metricCreationMode",
-      status: params.dashboardRuntime.metricCreationMode === "DRAG_DROP" ? "pass" : "warn",
-      details: `metricCreationMode is "${params.dashboardRuntime.metricCreationMode ?? "unknown"}".`
-    });
-  }
-  return checks;
-}
-function registerDiagnoseEmbedHealth(server, client) {
-  server.tool(
-    "diagnose_embed_health",
-    "Diagnose embed shape and required fields. Optionally validates runtime readiness if guestTokenBody or permissions are provided.",
-    {
-      embedId: z16.string().describe("Embed ID to diagnose"),
-      dataAppName: z16.string().optional().describe("Optional data app name to scope dashboard checks"),
-      // Runtime readiness params (absorbed from check_runtime_readiness)
-      guestTokenBody: z16.record(z16.unknown()).optional().describe(
-        "Exact request body sent to POST /api/v2/guest-token/create (for runtime validation)."
-      ),
-      permissions: z16.record(z16.unknown()).optional().describe(
-        "Guest token permissions (used when guestTokenBody is not provided)."
-      ),
-      embedOptions: z16.object({
-        disableMetricCreation: z16.boolean().optional()
-      }).optional().describe("Embed web component options (if known)."),
-      dashboardRuntime: z16.object({
-        isAllowedToCreateMetrics: z16.boolean().optional(),
-        metricCreationMode: z16.string().optional()
-      }).optional().describe("Runtime flags from dashboard response payload.")
-    },
-    READ_ONLY,
-    async (params) => {
-      try {
-        const raw = await client.request({
-          method: "GET",
-          path: "/api/v2/data-app/embeds",
-          auth: "api",
-          query: { embedId: params.embedId }
-        });
-        const embedList = Array.isArray(raw) ? raw : [raw];
-        const embed = embedList.find((e) => (e?.embedId || e?._id || e?.id) === params.embedId) || embedList[0];
-        const embedObj = asRecord2(embed);
-        if (!embedObj) {
-          return toolError(
-            `Embed "${params.embedId}" is not returned as an object by GET /embeds. This indicates malformed API data for this record.`
-          );
-        }
-        const embedMetadata = asRecord2(embedObj.embedMetadata);
-        const accessSettings = asRecord2(embedObj.accessSettings) || (embedMetadata ? asRecord2(embedMetadata.accessSettings) : null);
-        const dashboardIdCandidates = [
-          firstString(embedObj.dashboardId),
-          firstString(embedObj.externalDashboardId),
-          embedMetadata ? firstString(embedMetadata.dashboardId) : null
-        ].filter(Boolean);
-        const workspaceCandidates = [
-          firstString(embedObj.workspaceName),
-          firstString(embedObj.workspace),
-          firstString(embedObj.workspaceId),
-          embedMetadata ? firstString(embedMetadata.workspaceName) : null,
-          embedMetadata ? firstString(embedMetadata.workspaceId) : null
-        ].filter(Boolean);
-        const datamartName = firstString(
-          accessSettings?.datamartName,
-          embedObj.datamartName,
-          embedMetadata?.datamartName
-        );
-        let datamartsCount = 0;
-        let datamartNames = [];
-        try {
-          const datamarts = await client.request({
-            method: "GET",
-            path: "/api/v2/data-app/datamarts",
-            auth: "service",
-            cacheKey: "list_datamarts",
-            cacheTtlMs: 5 * 60 * 1e3
-          });
-          if (Array.isArray(datamarts)) {
-            datamartsCount = datamarts.length;
-            datamartNames = datamarts.map((d) => firstString(d?.name, d?.datamartName)).filter(Boolean).slice(0, 10);
-          }
-        } catch {
-        }
-        let dashboardsCount = 0;
-        let dashboardIdSample = [];
-        try {
-          const dashboardQuery = params.dataAppName && params.dataAppName.trim().length > 0 ? { dataAppName: params.dataAppName } : void 0;
-          const dashboards = await client.request({
-            method: "GET",
-            path: "/api/v2/data-app/dashboards",
-            auth: "api",
-            query: dashboardQuery,
-            cacheKey: "list_dashboards",
-            cacheTtlMs: 5 * 60 * 1e3
-          });
-          if (Array.isArray(dashboards)) {
-            dashboardsCount = dashboards.length;
-            dashboardIdSample = dashboards.map(
-              (d) => firstString(
-                d?.dashboardId,
-                d?.externalDashboardId,
-                d?._id,
-                d?.id,
-                d?.uid
-              )
-            ).filter(Boolean).slice(0, 10);
-          }
-        } catch {
-        }
-        const issues = [];
-        if (!firstString(embedObj.embedId, embedObj.id, embedObj._id)) {
-          issues.push("No stable embed identifier found in record");
-        }
-        if (!accessSettings) {
-          issues.push("Missing accessSettings");
-        }
-        if (!datamartName) {
-          issues.push("Missing datamartName (in accessSettings or embed metadata)");
-        }
-        if (dashboardIdCandidates.length === 0) {
-          issues.push("No dashboard identifier found on embed");
-        }
-        if (workspaceCandidates.length === 0) {
-          issues.push("No workspace identifier/name found on embed");
-        }
-        const health = issues.length === 0 ? "healthy-shape" : "inconsistent-shape";
-        let report = `Embed Health Report: \`${params.embedId}\`
-
-- **Status:** ${health}
-- **Issues:** ${issues.length ? issues.join("; ") : "none detected in shape checks"}
-- **Dashboard ID candidates:** ${dashboardIdCandidates.length ? dashboardIdCandidates.map((id) => `\`${id}\``).join(", ") : "none"}
-- **Workspace candidates:** ${workspaceCandidates.length ? workspaceCandidates.map((id) => `\`${id}\``).join(", ") : "none"}
-- **Resolved datamartName:** ${datamartName ? `\`${datamartName}\`` : "none"}
-- **Datamarts visible:** ${datamartsCount}${datamartNames.length ? ` (sample: ${datamartNames.join(", ")})` : ""}
-- **Dashboards visible:** ${dashboardsCount}${dashboardIdSample.length ? ` (ID sample: ${dashboardIdSample.map((id) => `\`${id}\``).join(", ")})` : ""}
-`;
-        if (params.guestTokenBody || params.permissions || params.embedOptions || params.dashboardRuntime) {
-          const runtimeChecks = runRuntimeReadinessChecks({
-            guestTokenBody: params.guestTokenBody,
-            clientId: void 0,
-            dataAppName: params.dataAppName,
-            permissions: params.permissions,
-            embedOptions: params.embedOptions,
-            dashboardRuntime: params.dashboardRuntime
-          });
-          const hasFail = runtimeChecks.some((c) => c.status === "fail");
-          report += `
-### Runtime Readiness: ${hasFail ? "NOT_READY" : "READY"}
-
-`;
-          for (const c of runtimeChecks) {
-            const icon = c.status === "pass" ? "PASS" : c.status === "fail" ? "FAIL" : "WARN";
-            report += `- **[${icon}]** ${c.check}: ${c.details}
-`;
-          }
-        }
-        report += `
-Raw embed payload:
-\`\`\`json
-` + JSON.stringify(embedObj, null, 2) + "\n```";
-        return toolSuccess(report);
-      } catch (err) {
-        if (err instanceof DatabrainApiError) return err.toToolResponse();
-        return toolError(`Unexpected error: ${err.message}`);
-      }
-    }
-  );
-}
-
 // src/tools/frontend/generate-guest-token.ts
-import { z as z17 } from "zod";
+import { z as z15 } from "zod";
 function registerGenerateGuestToken(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "generate_guest_token",
     "Generate a guest token for frontend embedding. Requires clientId. Omit dataAppName to auto-resolve.",
     {
-      clientId: z17.string().describe('Unique end-user identifier for multi-tenant filtering. Use "None" if no tenancy.'),
-      dataAppName: z17.string().optional().describe("Name of the data app. Omit to list available data apps."),
-      body: z17.record(z17.unknown()).optional().describe(
+      clientId: z15.string().describe('Unique end-user identifier for multi-tenant filtering. Use "None" if no tenancy.'),
+      dataAppName: z15.string().optional().describe("Name of the data app. Omit to list available data apps."),
+      body: z15.record(z15.unknown()).optional().describe(
         "Raw API body for POST /api/v2/guest-token/create. If provided, sent directly and convenience fields are ignored."
       ),
-      params: z17.object({
-        allowedEmbeds: z17.array(z17.string()).optional().describe("Restrict token to specific embed IDs"),
-        rlsSettings: z17.array(z17.object({
-          metricId: z17.string().describe("Metric ID"),
-          values: z17.record(z17.unknown()).describe("RLS values by column name")
+      params: z15.object({
+        allowedEmbeds: z15.array(z15.string()).optional().describe("Restrict token to specific embed IDs"),
+        rlsSettings: z15.array(z15.object({
+          metricId: z15.string().describe("Metric ID"),
+          values: z15.record(z15.unknown()).describe("RLS values by column name")
         })).optional().describe("Legacy alias used in docs/examples; forwarded as params.rlsSettings"),
-        appFilters: z17.array(z17.object({
-          metricId: z17.string().describe("Metric ID"),
-          values: z17.record(z17.unknown()).describe("Filter values by column name")
+        appFilters: z15.array(z15.object({
+          metricId: z15.string().describe("Metric ID"),
+          values: z15.record(z15.unknown()).describe("Filter values by column name")
         })).optional().describe("Metric-level app filters"),
-        dashboardAppFilters: z17.array(z17.object({
-          dashboardId: z17.string().describe("Dashboard ID"),
-          values: z17.record(z17.unknown()).describe("Filter values by dashboard filter name"),
-          isShowOnUrl: z17.boolean().optional().describe("Whether filters are shown in URL params")
+        dashboardAppFilters: z15.array(z15.object({
+          dashboardId: z15.string().describe("Dashboard ID"),
+          values: z15.record(z15.unknown()).describe("Filter values by dashboard filter name"),
+          isShowOnUrl: z15.boolean().optional().describe("Whether filters are shown in URL params")
         })).optional().describe("Dashboard-level app filters"),
-        hideDashboardFilters: z17.array(z17.string()).optional().describe("Dashboard filter names to hide"),
-        userIdentifier: z17.string().optional().describe("End-user identifier for private metrics support"),
-        timezone: z17.string().optional().describe('IANA timezone, e.g. "America/New_York"')
+        hideDashboardFilters: z15.array(z15.string()).optional().describe("Dashboard filter names to hide"),
+        userIdentifier: z15.string().optional().describe("End-user identifier for private metrics support"),
+        timezone: z15.string().optional().describe('IANA timezone, e.g. "America/New_York"')
       }).optional().describe("Advanced token params"),
       // Legacy convenience fields (auto-mapped into params for backward compatibility)
-      timezone: z17.string().optional().describe("Legacy: moved under params.timezone"),
-      allowedEmbeds: z17.array(z17.string()).optional().describe("Legacy: moved under params.allowedEmbeds"),
-      rlsSettings: z17.array(z17.object({
-        metricId: z17.string().describe("Metric ID"),
-        values: z17.record(z17.unknown()).describe("RLS values by column name")
+      timezone: z15.string().optional().describe("Legacy: moved under params.timezone"),
+      allowedEmbeds: z15.array(z15.string()).optional().describe("Legacy: moved under params.allowedEmbeds"),
+      rlsSettings: z15.array(z15.object({
+        metricId: z15.string().describe("Metric ID"),
+        values: z15.record(z15.unknown()).describe("RLS values by column name")
       })).optional().describe("Legacy: moved under params.rlsSettings"),
-      appFilters: z17.array(z17.object({
-        metricId: z17.string().describe("Metric ID"),
-        values: z17.record(z17.unknown()).describe("Filter values by column name")
+      appFilters: z15.array(z15.object({
+        metricId: z15.string().describe("Metric ID"),
+        values: z15.record(z15.unknown()).describe("Filter values by column name")
       })).optional().describe("Legacy: moved under params.appFilters"),
-      dashboardAppFilters: z17.array(z17.object({
-        dashboardId: z17.string().describe("Dashboard ID to apply filters to"),
-        values: z17.record(z17.unknown()).describe("Filter values for this dashboard"),
-        isShowOnUrl: z17.boolean().optional().describe("Whether filters are shown in URL params")
+      dashboardAppFilters: z15.array(z15.object({
+        dashboardId: z15.string().describe("Dashboard ID to apply filters to"),
+        values: z15.record(z15.unknown()).describe("Filter values for this dashboard"),
+        isShowOnUrl: z15.boolean().optional().describe("Whether filters are shown in URL params")
       })).optional().describe("Legacy: moved under params.dashboardAppFilters"),
-      permissions: z17.object({
-        isEnableArchiveMetrics: z17.boolean().optional(),
-        isEnableManageMetrics: z17.boolean().optional(),
-        isEnableCreateDashboardView: z17.boolean().optional(),
-        isEnableMetricUpdation: z17.boolean().optional(),
-        isEnableCustomizeLayout: z17.boolean().optional(),
-        isEnableUnderlyingData: z17.boolean().optional(),
-        isEnableDownloadMetrics: z17.boolean().optional(),
-        isShowSideBar: z17.boolean().optional(),
-        isShowDashboardName: z17.boolean().optional(),
-        isDisableMetricCreation: z17.boolean().optional()
+      permissions: z15.object({
+        isEnableArchiveMetrics: z15.boolean().optional(),
+        isEnableManageMetrics: z15.boolean().optional(),
+        isEnableCreateDashboardView: z15.boolean().optional(),
+        isEnableMetricUpdation: z15.boolean().optional(),
+        isEnableCustomizeLayout: z15.boolean().optional(),
+        isEnableUnderlyingData: z15.boolean().optional(),
+        isEnableDownloadMetrics: z15.boolean().optional(),
+        isShowSideBar: z15.boolean().optional(),
+        isShowDashboardName: z15.boolean().optional(),
+        isDisableMetricCreation: z15.boolean().optional()
       }).optional().describe("Runtime permission overrides (merge with and override embed-level settings)"),
-      theme: z17.record(z17.unknown()).optional().describe("Runtime theme overrides (overrides embed-level theme)"),
-      hideDashboardFilters: z17.array(z17.string()).optional().describe("Legacy: moved under params.hideDashboardFilters"),
-      userIdentifier: z17.string().optional().describe("Legacy: moved under params.userIdentifier"),
-      expiryTime: z17.number().optional().describe("Token TTL in milliseconds"),
-      datasourceName: z17.string().optional().describe("Datasource name for multi-datasource routing")
+      theme: z15.record(z15.unknown()).optional().describe("Runtime theme overrides (overrides embed-level theme)"),
+      hideDashboardFilters: z15.array(z15.string()).optional().describe("Legacy: moved under params.hideDashboardFilters"),
+      userIdentifier: z15.string().optional().describe("Legacy: moved under params.userIdentifier"),
+      expiryTime: z15.number().optional().describe("Token TTL in milliseconds"),
+      datasourceName: z15.string().optional().describe("Datasource name for multi-datasource routing")
     },
     WRITE_CREATE,
     async (params) => {
@@ -3035,7 +2494,7 @@ Next step: Use \`generate_embed_code\` to get copy-paste-ready frontend code.`
 }
 
 // src/tools/frontend/generate-embed-code.ts
-import { z as z18 } from "zod";
+import { z as z16 } from "zod";
 
 // src/templates/react.ts
 function kebabCase(str) {
@@ -4031,22 +3490,22 @@ function registerGenerateEmbedCode(server, _client) {
     "generate_embed_code",
     "Generate framework-specific embed code (React, Next.js, Vue, Angular, Svelte, SolidJS, vanilla HTML).",
     {
-      embedId: z18.string().describe("The embed ID to generate code for"),
-      framework: z18.enum(FRAMEWORKS).describe("Frontend framework"),
-      embedType: z18.enum(["dashboard", "metric"]).optional().default("dashboard"),
-      options: z18.object({
-        enableDownloadCsv: z18.boolean().optional(),
-        enableEmailCsv: z18.boolean().optional(),
-        enableDownloadAllMetrics: z18.boolean().optional(),
-        enableDownloadAllPdf: z18.boolean().optional(),
-        disableFullscreen: z18.boolean().optional(),
-        isHideTablePreview: z18.boolean().optional(),
-        isHideChartSettings: z18.boolean().optional(),
-        isStickyDashboardFilters: z18.boolean().optional(),
-        enableMultiMetricFilters: z18.boolean().optional(),
-        themeName: z18.string().optional(),
-        customTheme: z18.record(z18.unknown()).optional(),
-        optionsIcon: z18.enum(["kebab-menu-vertical", "download"]).optional()
+      embedId: z16.string().describe("The embed ID to generate code for"),
+      framework: z16.enum(FRAMEWORKS).describe("Frontend framework"),
+      embedType: z16.enum(["dashboard", "metric"]).optional().default("dashboard"),
+      options: z16.object({
+        enableDownloadCsv: z16.boolean().optional(),
+        enableEmailCsv: z16.boolean().optional(),
+        enableDownloadAllMetrics: z16.boolean().optional(),
+        enableDownloadAllPdf: z16.boolean().optional(),
+        disableFullscreen: z16.boolean().optional(),
+        isHideTablePreview: z16.boolean().optional(),
+        isHideChartSettings: z16.boolean().optional(),
+        isStickyDashboardFilters: z16.boolean().optional(),
+        enableMultiMetricFilters: z16.boolean().optional(),
+        themeName: z16.string().optional(),
+        customTheme: z16.record(z16.unknown()).optional(),
+        optionsIcon: z16.enum(["kebab-menu-vertical", "download"]).optional()
       }).optional()
     },
     READ_ONLY,
@@ -4086,17 +3545,17 @@ ${generated.instructions}`;
 }
 
 // src/tools/analytics/list-dashboards.ts
-import { z as z19 } from "zod";
+import { z as z17 } from "zod";
 function registerListDashboards(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "list_dashboards",
     "List dashboards globally or for a specific data app.",
     {
-      scope: z19.enum(["auto", "global", "data_app"]).optional().describe(
+      scope: z17.enum(["auto", "global", "data_app"]).optional().describe(
         "Dashboard listing scope. auto: use data_app when dataAppName + API token are available, otherwise global."
       ),
-      dataAppName: z19.string().optional().describe("Data app name for data_app scope. Ignored for global scope.")
+      dataAppName: z17.string().optional().describe("Data app name for data_app scope. Ignored for global scope.")
     },
     READ_ONLY,
     async (params) => {
@@ -4130,617 +3589,8 @@ function registerListDashboards(server, client) {
   );
 }
 
-// src/tools/orchestration/setup-embed-interactive.ts
-import { z as z20 } from "zod";
-var STEPS = [
-  "discover_data_apps",
-  "choose_data_app",
-  "create_data_app",
-  "ensure_api_token",
-  "discover_workspaces",
-  "choose_workspace",
-  "list_dashboards",
-  "choose_dashboard",
-  "create_embed",
-  "runtime_readiness",
-  "complete"
-];
-var stateSchema = z20.object({
-  dataAppName: z20.string().optional(),
-  dataAppId: z20.string().optional(),
-  workspaceName: z20.string().optional(),
-  embedType: z20.enum(["dashboard", "metric"]).optional(),
-  dashboardId: z20.string().optional(),
-  metricId: z20.string().optional(),
-  datamartName: z20.string().optional(),
-  embedId: z20.string().optional(),
-  embedName: z20.string().optional(),
-  clientId: z20.string().optional(),
-  runtimeValidated: z20.boolean().optional()
-});
-function emit(status, step, state, message, options, nextStep) {
-  const payload = {
-    status,
-    step,
-    message,
-    state
-  };
-  if (options) payload.options = options;
-  if (nextStep) payload.nextStep = nextStep;
-  return toolSuccess(JSON.stringify(payload, null, 2));
-}
-function parseUserChoiceObject(userChoice) {
-  if (!userChoice) return null;
-  try {
-    const parsed = JSON.parse(userChoice);
-    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
-      return parsed;
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}
-function parseNameFromUserChoice(userChoice) {
-  if (!userChoice) return null;
-  const choiceObj = parseUserChoiceObject(userChoice);
-  if (choiceObj) {
-    const rawName = choiceObj.name;
-    if (typeof rawName === "string" && rawName.trim().length > 0) return rawName.trim();
-    return null;
-  }
-  const trimmed = userChoice.trim();
-  return trimmed.length > 0 ? trimmed : null;
-}
-function registerSetupEmbedInteractive(server, client) {
-  const services = createServiceBundle(client);
-  const listDashboardsForContext = async (currentState) => {
-    const dataAppName = currentState.dataAppName;
-    const workspaceName = currentState.workspaceName;
-    if (dataAppName && dataAppName.trim().length > 0 && client.hasApiToken()) {
-      const dashboards2 = await services.dashboardsApi.listDashboards(dataAppName);
-      if (Array.isArray(dashboards2) && dashboards2.length > 0) {
-        return { dashboards: dashboards2, scope: "data_app" };
-      }
-    }
-    if (workspaceName && workspaceName.trim().length > 0) {
-      const dashboards2 = await services.dashboardsApi.listDashboardsForWorkspace(workspaceName);
-      return { dashboards: dashboards2, scope: "workspace" };
-    }
-    const dashboards = await services.dashboardsApi.listDashboardsAcrossWorkspaces();
-    return { dashboards, scope: "global" };
-  };
-  server.tool(
-    "setup_embed_interactive",
-    "Step-by-step embed setup wizard. Pass step and state from previous call.",
-    {
-      step: z20.enum(STEPS).describe("Current orchestration step"),
-      state: stateSchema.optional().describe("State from previous step \u2014 pass forward unchanged"),
-      userChoice: z20.string().optional().describe("User response for CHOICE_REQUIRED or CONFIRM_REQUIRED")
-    },
-    WRITE_CREATE,
-    async (params) => {
-      const state = params.state ?? {};
-      const step = params.step;
-      try {
-        if (step === "discover_data_apps") {
-          const apps = await services.dataAppsApi.listDataApps();
-          if (!Array.isArray(apps) || apps.length === 0) {
-            return emit(
-              "CHOICE_REQUIRED",
-              step,
-              state,
-              "No data apps found. Ask user for a data app name to create one.",
-              [
-                { id: "create", label: "Create a new data app" },
-                { id: "stop", label: "Stop setup" }
-              ],
-              "create_data_app"
-            );
-          }
-          if (apps.length === 1) {
-            const app = services.discoveryService.normalizeDataApp(apps[0]);
-            return emit(
-              "CONFIRM_REQUIRED",
-              step,
-              {
-                ...state,
-                dataAppName: app.name,
-                dataAppId: app.dataAppId || void 0
-              },
-              `Found one data app: "${app.name}". Confirm to continue.`,
-              [{ id: app.name, label: `${app.name} (${app.dataAppId || "no-id"})` }],
-              "ensure_api_token"
-            );
-          }
-          const options = apps.map((a) => {
-            const n = services.discoveryService.normalizeDataApp(a);
-            return {
-              id: n.dataAppId || n.name,
-              label: `${n.name} (${n.dataAppId || "no-id"})`,
-              dataAppName: n.name,
-              dataAppId: n.dataAppId
-            };
-          });
-          return emit(
-            "CHOICE_REQUIRED",
-            step,
-            state,
-            `Found ${apps.length} data app(s). Ask the user which one to embed from.`,
-            options,
-            "choose_data_app"
-          );
-        }
-        if (step === "choose_data_app") {
-          if (!params.userChoice) {
-            return toolError("userChoice is required for choose_data_app.");
-          }
-          const apps = await services.dataAppsApi.listDataApps();
-          const q = params.userChoice.toLowerCase();
-          const match = apps.find((a) => {
-            const n2 = services.discoveryService.normalizeDataApp(a);
-            return n2.name.toLowerCase() === q || (n2.dataAppId || "").toLowerCase() === q || n2.name.toLowerCase().includes(q);
-          });
-          if (!match) {
-            return toolError(
-              `No data app matched "${params.userChoice}". Re-run discover_data_apps.`
-            );
-          }
-          const n = services.discoveryService.normalizeDataApp(match);
-          return emit(
-            "READY",
-            step,
-            {
-              ...state,
-              dataAppName: n.name,
-              dataAppId: n.dataAppId || void 0
-            },
-            `Selected data app: "${n.name}".`,
-            void 0,
-            "ensure_api_token"
-          );
-        }
-        if (step === "create_data_app") {
-          const name = parseNameFromUserChoice(params.userChoice);
-          if (!name) {
-            return toolError(
-              'Provide data app name in userChoice. Accepts plain string or JSON: {"name":"my-data-app"}.'
-            );
-          }
-          const created = await client.request({
-            method: "POST",
-            path: "/api/v2/data-app/",
-            auth: "service",
-            body: { name },
-            invalidateCache: ["list_data_apps"]
-          });
-          return emit(
-            "READY",
-            step,
-            {
-              ...state,
-              dataAppName: name,
-              dataAppId: created.id || void 0
-            },
-            `Created data app "${name}".`,
-            void 0,
-            "ensure_api_token"
-          );
-        }
-        if (step === "ensure_api_token") {
-          const appName = state.dataAppName;
-          if (!appName) {
-            return toolError("state.dataAppName is required. Run discover_data_apps first.");
-          }
-          const tokens = await client.request({
-            method: "GET",
-            path: "/api/v2/data-app/api-tokens",
-            auth: "service",
-            query: { dataAppName: appName }
-          });
-          if (Array.isArray(tokens) && tokens.length > 0) {
-            const tokenValue = tokens[0].token || tokens[0].apiToken || tokens[0].key;
-            if (tokenValue) {
-              client.setRuntimeApiToken(tokenValue);
-              return emit(
-                "READY",
-                step,
-                { ...state, dataAppName: appName },
-                `API token found and activated for "${appName}".`,
-                void 0,
-                "discover_workspaces"
-              );
-            }
-            return emit(
-              "CHOICE_REQUIRED",
-              step,
-              { ...state, dataAppName: appName },
-              `"${appName}" has API token(s) but the value was not returned. Call \`create_api_token\` to generate a new one, or \`set_api_token\` if you have the value. Then re-run discover_workspaces.`,
-              [
-                { id: "create", label: "Create new API token (call create_api_token)" },
-                { id: "set", label: "Set existing token (call set_api_token)" }
-              ],
-              "discover_workspaces"
-            );
-          }
-          return emit(
-            "CHOICE_REQUIRED",
-            step,
-            { ...state, dataAppName: appName },
-            `No API token for "${appName}". Call \`create_api_token\` to generate one. Then proceed to discover_workspaces.`,
-            [
-              { id: "create", label: "Create API token now (call create_api_token)" }
-            ],
-            "discover_workspaces"
-          );
-        }
-        if (step === "discover_workspaces") {
-          const workspaces = await services.workspacesApi.listWorkspaces();
-          if (!Array.isArray(workspaces) || workspaces.length === 0) {
-            return emit(
-              "READY",
-              step,
-              state,
-              "No workspaces found. Create a workspace in Databrain UI first, then re-run this step."
-            );
-          }
-          if (workspaces.length === 1) {
-            const ws = workspaces[0];
-            const wsName = (typeof ws.name === "string" ? ws.name.trim() : "") || "Unnamed";
-            return emit(
-              "READY",
-              step,
-              { ...state, workspaceName: wsName },
-              `Found one workspace: "${wsName}". Auto-selected.`,
-              void 0,
-              "list_dashboards"
-            );
-          }
-          const options = workspaces.filter((ws) => typeof ws.name === "string" && ws.name.trim().length > 0).map((ws) => ({
-            id: ws.name,
-            label: `${ws.name} (${ws._id || ws.id || "no-id"})`,
-            workspaceName: ws.name
-          }));
-          return emit(
-            "CHOICE_REQUIRED",
-            step,
-            state,
-            `Found ${workspaces.length} workspace(s). Ask the user which workspace to use.`,
-            options,
-            "choose_workspace"
-          );
-        }
-        if (step === "choose_workspace") {
-          if (!params.userChoice) {
-            return toolError("userChoice is required for choose_workspace.");
-          }
-          const workspaces = await services.workspacesApi.listWorkspaces();
-          const q = params.userChoice.toLowerCase();
-          const match = workspaces.find((ws) => {
-            const name = (typeof ws.name === "string" ? ws.name.trim() : "").toLowerCase();
-            const wsId = (ws._id || ws.id || "").toLowerCase();
-            return name === q || wsId === q || name.includes(q);
-          });
-          if (!match) {
-            return toolError(
-              `No workspace matched "${params.userChoice}". Re-run discover_workspaces.`
-            );
-          }
-          const wsName = (typeof match.name === "string" ? match.name.trim() : "") || "Unnamed";
-          return emit(
-            "READY",
-            step,
-            { ...state, workspaceName: wsName },
-            `Selected workspace: "${wsName}".`,
-            void 0,
-            "list_dashboards"
-          );
-        }
-        if (step === "list_dashboards") {
-          const { dashboards, scope } = await listDashboardsForContext(state);
-          if (!Array.isArray(dashboards) || dashboards.length === 0) {
-            const scopeMsg = scope === "data_app" ? `No dashboards found for data app "${state.dataAppName || "unknown"}".` : scope === "workspace" ? `No dashboards found in workspace "${state.workspaceName || "unknown"}". Create a dashboard in Databrain UI first, then re-run this step.` : "No dashboards found in available workspaces. Create a dashboard in Databrain UI first, then re-run this step.";
-            return emit("READY", step, state, scopeMsg);
-          }
-          const options = dashboards.map((d) => {
-            const n = services.discoveryService.normalizeDashboard(d);
-            return {
-              id: n.dashboardId || n.name,
-              label: `${n.name} (${n.dashboardId || "no-id"})${n.workspaceName ? ` \u2014 workspace: ${n.workspaceName}` : ""}`,
-              dashboardId: n.dashboardId,
-              workspaceName: n.workspaceName
-            };
-          });
-          const foundMsg = scope === "data_app" ? `Found ${dashboards.length} dashboard(s) for data app "${state.dataAppName || "unknown"}". Ask the user which dashboard to embed.` : scope === "workspace" ? `Found ${dashboards.length} dashboard(s) in workspace "${state.workspaceName || "unknown"}". Ask the user which dashboard to embed.` : `Found ${dashboards.length} dashboard(s) across workspaces. Ask the user which dashboard to embed.`;
-          return emit(
-            "CHOICE_REQUIRED",
-            step,
-            state,
-            foundMsg,
-            options,
-            "choose_dashboard"
-          );
-        }
-        if (step === "choose_dashboard") {
-          if (!params.userChoice) {
-            return toolError("userChoice is required for choose_dashboard. Pass dashboardId or name.");
-          }
-          const { dashboards } = await listDashboardsForContext(state);
-          const q = params.userChoice.toLowerCase();
-          const match = dashboards.find((d) => {
-            const n2 = services.discoveryService.normalizeDashboard(d);
-            return (n2.dashboardId || "").toLowerCase() === q || (n2.name || "").toLowerCase() === q || (n2.name || "").toLowerCase().includes(q);
-          });
-          if (!match) {
-            return toolError(
-              `No dashboard matched "${params.userChoice}". Re-run list_dashboards.`
-            );
-          }
-          const n = services.discoveryService.normalizeDashboard(match);
-          let resolvedDatamartName = state.datamartName;
-          const resolveAppId = state.dataAppId || n.workspaceName;
-          if (!resolvedDatamartName && resolveAppId) {
-            try {
-              const datamarts = await services.datamartsApi.listDatamartsByDataAppId(resolveAppId);
-              const names = Array.from(
-                new Set(
-                  datamarts.map((dm) => dm.name || dm.datamartName).filter((v) => typeof v === "string" && v.trim().length > 0)
-                )
-              );
-              if (names.length === 1) resolvedDatamartName = names[0];
-            } catch {
-            }
-          }
-          return emit(
-            "READY",
-            step,
-            {
-              ...state,
-              dashboardId: n.dashboardId,
-              embedType: "dashboard",
-              ...n.workspaceName ? { workspaceName: n.workspaceName } : {},
-              ...resolvedDatamartName ? { datamartName: resolvedDatamartName } : {}
-            },
-            `Selected dashboard: "${n.name}" (${n.dashboardId}).${n.workspaceName ? ` workspaceName=${n.workspaceName}.` : ""}${resolvedDatamartName ? ` datamartName=${resolvedDatamartName}.` : ""} Proceeding to create embed.`,
-            void 0,
-            "create_embed"
-          );
-        }
-        if (step === "create_embed") {
-          const choiceObj = parseUserChoiceObject(params.userChoice);
-          const merged = {
-            ...state,
-            ...choiceObj || {}
-          };
-          const dashboardId = merged.dashboardId;
-          const metricId = merged.metricId;
-          let resolvedWorkspaceName = merged.workspaceName;
-          const embedType = merged.embedType?.toLowerCase() === "metric" ? "metric" : "dashboard";
-          const datamartName = merged.datamartName;
-          const embedName = merged.embedName || (embedType === "dashboard" && dashboardId ? `embed-${dashboardId}` : embedType === "metric" && metricId ? `embed-metric-${metricId}` : void 0);
-          let resolvedDatamartName = datamartName;
-          let resolveAppId = merged.dataAppId;
-          let availableDatamartNames = [];
-          if (!resolveAppId) {
-            const appName = merged.dataAppName;
-            if (appName) {
-              try {
-                const apps = await services.dataAppsApi.listDataApps();
-                const app = apps.find((a) => {
-                  const n = services.discoveryService.normalizeDataApp(a);
-                  return n.name.toLowerCase() === appName.toLowerCase() || (n.dataAppId || "").toLowerCase() === appName.toLowerCase();
-                });
-                if (app) {
-                  resolveAppId = services.discoveryService.normalizeDataApp(app).dataAppId || void 0;
-                }
-              } catch {
-              }
-            }
-          }
-          if (embedType === "dashboard" && dashboardId && merged.dataAppName && client.hasApiToken()) {
-            try {
-              const scopedDashboards = await services.dashboardsApi.listDashboards(
-                merged.dataAppName
-              );
-              const dashboardMatch = scopedDashboards.find((d) => {
-                const n = services.discoveryService.normalizeDashboard(d);
-                return (n.dashboardId || "").toLowerCase() === dashboardId.toLowerCase();
-              });
-              if (!dashboardMatch) {
-                return emit(
-                  "CHOICE_REQUIRED",
-                  step,
-                  merged,
-                  `dashboardId "${dashboardId}" is not available under data app "${merged.dataAppName || "unknown"}". Re-run list_dashboards and choose from the current data app scope.`,
-                  [],
-                  "list_dashboards"
-                );
-              }
-              const dashboardNormalized = services.discoveryService.normalizeDashboard(dashboardMatch);
-              if (dashboardNormalized.workspaceName) {
-                if (resolvedWorkspaceName && resolvedWorkspaceName !== dashboardNormalized.workspaceName) {
-                  return emit(
-                    "CHOICE_REQUIRED",
-                    step,
-                    merged,
-                    `workspaceName "${resolvedWorkspaceName}" does not match dashboard workspace "${dashboardNormalized.workspaceName}". Use the dashboard workspace.`,
-                    [
-                      {
-                        id: "use_dashboard_workspace",
-                        label: dashboardNormalized.workspaceName,
-                        workspaceName: dashboardNormalized.workspaceName
-                      }
-                    ],
-                    "create_embed"
-                  );
-                }
-                resolvedWorkspaceName = dashboardNormalized.workspaceName;
-              }
-            } catch {
-            }
-          }
-          if (embedType === "dashboard" && !resolvedDatamartName) {
-            if (resolveAppId) {
-              try {
-                const datamarts = await services.datamartsApi.listDatamartsByDataAppId(
-                  resolveAppId
-                );
-                const names = Array.from(
-                  new Set(
-                    datamarts.map((dm) => dm.name || dm.datamartName).filter(
-                      (v) => typeof v === "string" && v.trim().length > 0
-                    )
-                  )
-                );
-                availableDatamartNames = names;
-                if (names.length === 1) {
-                  resolvedDatamartName = names[0];
-                } else if (names.length > 1) {
-                  return emit(
-                    "CHOICE_REQUIRED",
-                    step,
-                    merged,
-                    "Multiple datamarts are available for this data app. Ask the user to select one for accessSettings.datamartName.",
-                    names.map((name) => ({
-                      id: name,
-                      label: name,
-                      datamartName: name
-                    })),
-                    "create_embed"
-                  );
-                }
-              } catch {
-              }
-            }
-          }
-          if (embedType === "dashboard" && resolvedDatamartName && resolveAppId && availableDatamartNames.length === 0) {
-            try {
-              const datamarts = await services.datamartsApi.listDatamartsByDataAppId(resolveAppId);
-              availableDatamartNames = Array.from(
-                new Set(
-                  datamarts.map((dm) => dm.name || dm.datamartName).filter((v) => typeof v === "string" && v.trim().length > 0)
-                )
-              );
-            } catch {
-            }
-          }
-          if (embedType === "dashboard" && resolvedDatamartName && availableDatamartNames.length > 0 && !availableDatamartNames.includes(resolvedDatamartName)) {
-            return emit(
-              "CHOICE_REQUIRED",
-              step,
-              merged,
-              `datamartName "${resolvedDatamartName}" is invalid for this data app. Choose one of the available datamarts.`,
-              availableDatamartNames.map((name) => ({
-                id: name,
-                label: name,
-                datamartName: name
-              })),
-              "create_embed"
-            );
-          }
-          const missing = [];
-          if (!resolvedWorkspaceName) missing.push("workspaceName");
-          if (!dashboardId) missing.push("dashboardId");
-          if (embedType === "metric" && !metricId) missing.push("metricId");
-          if (embedType === "dashboard" && !resolvedDatamartName) missing.push("datamartName");
-          if (missing.length > 0) {
-            return emit(
-              "CHOICE_REQUIRED",
-              step,
-              {
-                ...merged,
-                ...resolvedDatamartName ? { datamartName: resolvedDatamartName } : {}
-              },
-              `Missing required fields for embed creation: ${missing.join(", ")}. Provide via userChoice JSON.`,
-              [
-                {
-                  id: "provide_fields",
-                  label: 'Provide JSON: {"dashboardId":"...","workspaceName":"...","datamartName":"..."}'
-                }
-              ],
-              "create_embed"
-            );
-          }
-          const created = await services.embedService.createEmbedStrict({
-            dashboardId,
-            metricId,
-            workspaceName: resolvedWorkspaceName,
-            embedType,
-            name: embedName,
-            accessSettings: {
-              datamartName: resolvedDatamartName,
-              isAllowMetricCreation: false,
-              isAllowMetricDeletion: false,
-              isAllowMetricUpdate: false,
-              isAllowMetricLayoutChange: false,
-              isAllowManageMetrics: false,
-              isAllowUnderlyingData: false,
-              isAllowAiPilot: false,
-              isAllowEmailReports: false,
-              isAllowCreateDashboardView: false,
-              metricCreationMode: "DRAG_DROP"
-            }
-          });
-          const embedId = created.embedId || created.id || created._id || void 0;
-          return emit(
-            "READY",
-            step,
-            { ...merged, embedType, embedId },
-            `Embed created successfully${embedId ? ` (embedId: ${embedId})` : ""}. Next: run runtime readiness validation before finishing setup.`,
-            void 0,
-            "runtime_readiness"
-          );
-        }
-        if (step === "runtime_readiness") {
-          const appName = state.dataAppName;
-          if (!appName) {
-            return toolError("state.dataAppName is required. Run discover_data_apps first.");
-          }
-          const choiceObj = parseUserChoiceObject(params.userChoice);
-          const clientId = choiceObj?.clientId || state.clientId || "None";
-          const permissions = {
-            isEnableManageMetrics: true,
-            isEnableMetricUpdation: true,
-            isEnableCustomizeLayout: true,
-            isEnableCreateDashboardView: true,
-            isDisableMetricCreation: false,
-            ...choiceObj?.permissions || {}
-          };
-          await services.guestTokenService.generateToken({
-            clientId,
-            dataAppName: appName,
-            permissions
-          });
-          return emit(
-            "DONE",
-            step,
-            {
-              ...state,
-              clientId,
-              runtimeValidated: true
-            },
-            "Runtime contract validated by generating a guest token with top-level clientId/dataAppName/permissions. Next: run generate_embed_code and then continue with brand-my-embed or secure-my-embed as needed."
-          );
-        }
-        if (step === "complete") {
-          return emit(
-            "DONE",
-            step,
-            state,
-            "Setup complete. Recommended before handoff: run runtime_readiness. Then use brand-my-embed, secure-my-embed, setup-filters, or localize-embed prompts for further customization."
-          );
-        }
-        return toolError(`Unknown step: ${step}`);
-      } catch (err) {
-        if (err instanceof DatabrainApiError) return err.toToolResponse();
-        return toolError(`Unexpected error: ${err.message}`);
-      }
-    }
-  );
-}
-
 // src/tools/query/ask-question.ts
-import { z as z21 } from "zod";
+import { z as z18 } from "zod";
 var MAX_DISPLAY_ROWS = 50;
 function formatDataTable(data, columns) {
   if (!Array.isArray(data) || data.length === 0) return "_No data returned._";
@@ -4770,16 +3620,16 @@ function registerAskQuestion(server, client) {
     "ask_question",
     "Ask a natural language question \u2014 converts to SQL, returns data + chart suggestion. Requires datamartName with a populated semantic layer.",
     {
-      question: z21.string().describe(
+      question: z18.string().describe(
         'The natural language question to ask (e.g. "What was total revenue last month?")'
       ),
-      datamartName: z21.string().optional().describe(
+      datamartName: z18.string().optional().describe(
         "Name of the datamart to query. Use `list_datamarts` to find available names. REQUIRED unless exactly one datamart exists (auto-resolved). Do NOT pass a workspace name here."
       ),
-      sessionId: z21.string().optional().describe(
+      sessionId: z18.string().optional().describe(
         "Session ID from a previous ask_question response, for follow-up questions."
       ),
-      timezone: z21.string().optional().describe('IANA timezone (e.g. "America/New_York"). Defaults to UTC.')
+      timezone: z18.string().optional().describe('IANA timezone (e.g. "America/New_York"). Defaults to UTC.')
     },
     WRITE_CREATE,
     async (params) => {
@@ -4944,14 +3794,14 @@ To fix this:
 }
 
 // src/tools/query/get-semantic-layer.ts
-import { z as z22 } from "zod";
+import { z as z19 } from "zod";
 function registerGetSemanticLayer(server, client) {
   const services = createServiceBundle(client);
   server.tool(
     "get_semantic_layer",
     "Get semantic layer metadata for a datamart: table/column descriptions, synonyms, completion score. Omit datamartName to auto-resolve.",
     {
-      datamartName: z22.string().optional().describe(
+      datamartName: z19.string().optional().describe(
         "Name of the datamart to inspect. Omit to list available datamarts."
       )
     },
@@ -5061,15 +3911,15 @@ ${result.feedback}`);
 }
 
 // src/tools/query/update-semantic-layer.ts
-import { z as z23 } from "zod";
-var columnSchema = z23.object({
-  name: z23.string().describe("Column name (must exist in the datamart)"),
-  description: z23.string().optional().describe("Business-friendly description of what this column represents"),
-  synonyms: z23.array(z23.string()).optional().describe(
+import { z as z20 } from "zod";
+var columnSchema = z20.object({
+  name: z20.string().describe("Column name (must exist in the datamart)"),
+  description: z20.string().optional().describe("Business-friendly description of what this column represents"),
+  synonyms: z20.array(z20.string()).optional().describe(
     'Alternative names users might use for this column (e.g. ["revenue", "sales amount"])'
   ),
-  miscellaneousInfo: z23.string().optional().describe("Additional context such as valid values, units, or caveats"),
-  columnType: z23.enum([
+  miscellaneousInfo: z20.string().optional().describe("Additional context such as valid values, units, or caveats"),
+  columnType: z20.enum([
     "String",
     "Long String",
     "String (Custom)",
@@ -5082,16 +3932,16 @@ var columnSchema = z23.object({
     "JSON"
   ]).nullable().optional().describe('Semantic column type. Use "Identifier" for IDs/foreign keys, "Number" for numeric values, "String" for text. Omit for date columns.')
 });
-var tableSchema = z23.object({
-  name: z23.string().describe("Table name (must exist in the datamart)"),
-  description: z23.string().optional().describe(
+var tableSchema = z20.object({
+  name: z20.string().describe("Table name (must exist in the datamart)"),
+  description: z20.string().optional().describe(
     "Business-friendly description of what this table represents"
   ),
-  synonyms: z23.array(z23.string()).optional().describe("Alternative names for this table"),
-  miscellaneousInfo: z23.string().optional().describe(
+  synonyms: z20.array(z20.string()).optional().describe("Alternative names for this table"),
+  miscellaneousInfo: z20.string().optional().describe(
     "Additional context such as how the table relates to other tables"
   ),
-  columns: z23.array(columnSchema).optional().describe("Column-level semantic definitions to update")
+  columns: z20.array(columnSchema).optional().describe("Column-level semantic definitions to update")
 });
 function registerUpdateSemanticLayer(server, client) {
   const services = createServiceBundle(client);
@@ -5099,13 +3949,13 @@ function registerUpdateSemanticLayer(server, client) {
     "update_semantic_layer",
     "Populate or update the semantic layer for a datamart. Add table/column descriptions, synonyms, context. Required before ask_question works. Auto-generate descriptions from column names when empty.",
     {
-      datamartName: z23.string().optional().describe(
+      datamartName: z20.string().optional().describe(
         "Name of the datamart to update. Omit to list available datamarts."
       ),
-      tables: z23.array(tableSchema).optional().describe(
+      tables: z20.array(tableSchema).optional().describe(
         "Table and column definitions to update. Only include tables/columns you want to change."
       ),
-      feedback: z23.string().optional().describe(
+      feedback: z20.string().optional().describe(
         'General feedback or context about the datamart (e.g. "This datamart contains e-commerce data for the US market").'
       )
     },
@@ -5179,12 +4029,9 @@ function registerAllTools(server, client) {
   registerGetEmbedDetails(server, client);
   registerUpdateEmbed(server, client);
   registerCustomizeTheme(server, client);
-  registerConfigureEmbed(server, client);
-  registerDiagnoseEmbedHealth(server, client);
   registerGenerateGuestToken(server, client);
   registerGenerateEmbedCode(server, client);
   registerListDashboards(server, client);
-  registerSetupEmbedInteractive(server, client);
   registerAskQuestion(server, client);
   registerGetSemanticLayer(server, client);
   registerUpdateSemanticLayer(server, client);
@@ -7660,7 +6507,7 @@ Databrain supports 4 core use cases for embedding analytics. Each maps to a spec
 **Two modes:**
 - **DRAG_DROP:** Visual metric builder \u2014 users drag columns, pick chart types. No AI needed.
 - **CHAT:** AI-powered natural language \u2014 users type questions. Requires LLM connector in Databrain admin.
-**Tool sequence:** \`list_embeds\` \u2192 \`update_embed\` (set accessSettings) \u2192 \`configure_embed\` \u2192 \`generate_guest_token\` (with permissions)
+**Tool sequence:** \`list_embeds\` \u2192 \`update_embed\` (set accessSettings and options) \u2192 \`generate_guest_token\` (with permissions)
 
 ## Use Case 4: Explore and Query Data
 **When to use:** You want to explore available data and ask questions using natural language.
@@ -7883,7 +6730,7 @@ If creating new: resolve datamartName by calling \`list_datamarts\`, then call \
 - \`accessSettings: { datamartName: "<resolved>" }\` \u2014 only datamartName is needed, the tool fills in all other required defaults automatically. Do NOT add isAllow* fields yourself.
 
 **Step 6 \u2014 Verify Embed**
-Call \`get_embed_details\` and \`diagnose_embed_health\` to verify the embed is properly configured.
+Call \`get_embed_details\` to verify the embed is properly configured.
 Show the user the embed ID and status.
 
 **Step 7 \u2014 Generate Guest Token**
@@ -8013,7 +6860,7 @@ For CHAT mode:
 \`\`\`
 
 **Step 4 \u2014 Configure Embed Options**
-Call \`configure_embed\` to ensure the UI supports metric creation:
+Call \`update_embed\` (body passthrough with options) to ensure the UI supports metric creation:
 - \`disableMetricCreation\`: false
 - \`hideCreateMetricButton\`: false
 - \`hideChartSettings\`: false (so users can customize their created metrics)
@@ -8084,7 +6931,7 @@ Use \`customize_embed_theme\` with the chart appearance params to fine-tune char
 Ask if they want to customize tooltip fonts, axis styling, or label positions.
 
 **Step 5 \u2014 Configure Display Options**
-Use \`configure_embed\` to clean up the UI:
+Use \`update_embed\` (body passthrough) to clean up the UI:
 - Ask if they want to hide the dashboard name (\`hideDashboardName\`)
 - Ask about card shadows and borders
 - Ask about download/export options they want to show
@@ -8126,7 +6973,7 @@ Call \`list_embeds\` and ask the user which embed to localize. Then ask:
 - What is the default/primary language?
 
 **Step 2 \u2014 Set the Primary Language**
-Use \`configure_embed\` with the \`language\` parameter set to their primary language code (e.g. "fr" for French).
+Use \`update_embed\` (body passthrough with componentAttributes) with the \`language\` parameter set to their primary language code (e.g. "fr" for French).
 
 **Step 3 \u2014 Gather Translations**
 Call \`get_embed_details\` to understand what text is in the dashboard. Then help the user build translations:
@@ -8148,28 +6995,28 @@ For each text element, ask for translations in their target languages. Build tra
 - If a translation is missing for a language, the original key text is shown as fallback
 
 **Step 4 \u2014 Apply Translations**
-Use \`configure_embed\` with the \`translations\` array containing all entries.
+Use \`update_embed\` (body passthrough with componentAttributes.translationDictionary) with the translations.
 
 **Step 5 \u2014 Configure Calendar (if needed)**
 Ask if they need a different calendar system:
 - \`"default"\` \u2014 standard Gregorian calendar
 - \`"ind"\` \u2014 Indian calendar format
 
-Set via \`calendarType\` in \`configure_embed\` (\`language\` and \`calendarType\` params).
+Set via \`calendarType\` in \`update_embed\` (body passthrough with componentAttributes).
 
 **Step 6 \u2014 Set Custom Messages**
 Ask if they want to translate system messages:
 - Token expiry message (shown when session expires)
 - Token absent message (shown when no auth token)
 
-Use \`configure_embed\` with \`tokenExpiryMessage\` and \`tokenAbsentMessage\` in their primary language.
+Use \`update_embed\` (body passthrough with options.customMessages) with \`tokenExpiry\` and \`tokenAbsent\` in their primary language.
 
 **Step 7 \u2014 Test**
 Tell the user to refresh the embed and verify translations appear correctly. If any text isn't translating, double-check that the key matches exactly.
 
 Remind the user: translations can also be applied per-user at the web component level using the \`translation-dictionary\` attribute, which is useful for dynamically switching languages based on user preferences.
 
-**Tip:** The \`language\`, \`calendarType\`, \`hideDashboardFilters\`, and filter settings are all available in the same \`configure_embed\` tool.
+**Tip:** The \`language\`, \`calendarType\`, \`hideDashboardFilters\`, and filter settings are all configurable via \`update_embed\` body passthrough.
 
 **Important:** After changing language or translation settings, existing guest tokens still carry the old configuration. Remind the user to **regenerate guest tokens** (or reload their app) for changes to take effect.`;
 
@@ -8186,10 +7033,10 @@ Ask the user about their end-user roles. Common patterns:
 Ask: "What roles do your end-users have? What should each role be allowed to do?"
 
 **Step 2 \u2014 Lock Down the Embed Defaults**
-Use \`configure_embed\` to set restrictive defaults (principle of least privilege):
+Use \`update_embed\` (body passthrough with options) to set restrictive defaults (principle of least privilege):
 
 \`\`\`
-configure_embed(embedId,
+update_embed(embedId, body: { options: {
   disableMetricCreation: true,
   disableMetricUpdation: true,
   disableMetricDeletion: true,
@@ -8293,7 +7140,7 @@ Ask the user:
 - "Do any filters have very large option lists?" (100+ options \u2014 these benefit from SQL-based filters)
 
 **Step 3 \u2014 Configure String Filters**
-For text/category filters, use \`configure_embed\` with \`stringFilters\`:
+For text/category filters, use \`update_embed\` (body passthrough with options.globalFilterOptions) for \`stringFilters\`:
 
 \`\`\`
 stringFilters: [{
@@ -8422,15 +7269,15 @@ Ask the user what they want to do:
 
    **Permissions / Access Settings:**
    - What's enabled vs disabled
-   - Suggest \`configure_embed\` for changes
+   - Suggest \`update_embed\` for changes
 
    **Filters:**
    - Current filter configuration
-   - Suggest \`configure_embed\` with filter params for changes
+   - Suggest \`update_embed\` (body passthrough with options.globalFilterOptions) for changes
 
    **Internationalization:**
    - Current language and translations
-   - Suggest \`configure_embed\` with \`language\` and \`translations\` params for changes
+   - Suggest \`update_embed\` (body passthrough with componentAttributes) for changes
 
 3. Ask: "Would you like to modify any of these settings?"
 
@@ -8679,7 +7526,7 @@ function createServer(config) {
 4 core use cases \u2014 match the user's scenario to the right prompt:
 1. Embed existing dashboard \u2192 prompt: embed-existing-dashboard (list_data_apps \u2192 create_api_token \u2192 list_dashboards \u2192 create_embed \u2192 generate_guest_token \u2192 generate_embed_code)
 2. Blank dashboard per client \u2192 prompt: embed-blank-dashboard (list_data_apps \u2192 list_datamarts \u2192 create_embed with clientId per client \u2192 generate_guest_token \u2192 generate_embed_code)
-3. Enable metric creation \u2192 prompt: enable-metric-creation (list_embeds \u2192 update_embed accessSettings \u2192 configure_embed \u2192 generate_guest_token with permissions)
+3. Enable metric creation \u2192 prompt: enable-metric-creation (list_embeds \u2192 update_embed accessSettings \u2192 generate_guest_token with permissions)
 4. Explore & query data \u2192 prompt: query-data (list_datamarts \u2192 get_semantic_layer \u2192 if empty, auto-generate descriptions with update_semantic_layer or use populate-semantic-layer prompt \u2192 ask_question)
 
 Infrastructure CREATION (datasources, datamarts, workspaces) is done in the Databrain UI.
@@ -8687,6 +7534,8 @@ However, the **semantic layer** is populated and maintained entirely via MCP too
 
 After embed setup, customize with: brand-my-embed, setup-filters, localize-embed, secure-my-embed.
 Use generate_guest_token for frontend auth and generate_embed_code for framework snippets.
+For advanced embed configuration (UI toggles, filters, i18n), use update_embed with a body passthrough.
+To diagnose embed issues, use get_embed_details and reason about the response.
 Do NOT ask the user for any tokens \u2014 manage them via MCP tools.
 
 IMPORTANT \u2014 accessSettings defaults: