@databrainhq/mcp-server 0.2.3 → 0.2.5

package/README.md

@@ -163,6 +163,16 @@ Each of your customers gets their own dashboard with row-level security.
 
 > "Create per-client dashboard embeds for my SaaS app"
 
+### Tweak widgets on a customer dashboard
+
+Add, remove, or modify widgets (metrics) on a specific customer's embed without opening the Databrain UI. Clone from a template widget, write a fresh SQL spec, or generate one from a prompt.
+
+> "Add the 'Calls per day' widget from the standard template to Acme's dashboard"
+
+> "Generate a widget showing disqualification reasons for Acme and add it to their embed"
+
+> "Remove the billing widget from Acme's dashboard but keep it for other customers"
+
 ### Enable self-serve analytics
 
 Let end-users build their own metrics with drag-and-drop or AI-powered chat.
@@ -197,12 +207,8 @@ Prompts are guided workflows your AI assistant can follow. Ask for them by name
 |--------|-------------|
 | `embed-existing-dashboard` | Embed a dashboard you've already built in the Databrain UI |
 | `embed-blank-dashboard` | Multi-tenant setup — each client gets their own dashboard |
-| `enable-metric-creation` | Let end-users build metrics (drag-and-drop or AI chat) |
+| `customize-customer-dashboard` | Add, modify, or remove widgets on a specific customer's embed — per-client scope |
 | `brand-my-embed` | Customize colors, fonts, charts, card styling, responsive layout |
-| `localize-embed` | Multi-language support, translations, calendar format |
-| `secure-my-embed` | Permissions, access controls, role-based guest tokens |
-| `setup-filters` | Dashboard filters — dropdowns, date ranges, server-side filters |
-| `manage-embeds` | List, compare, and review existing embed configurations |
 | `query-data` | Query your data with natural language, manage the semantic layer |
 | `populate-semantic-layer` | Auto-generate table/column descriptions to enable natural language querying |
 
@@ -210,7 +216,7 @@ Prompts are guided workflows your AI assistant can follow. Ask for them by name
 
 ## Tools Reference
 
-24 tools organized by category. Your AI assistant picks the right tools automatically — you don't need to call them directly.
+26 tools organized by category. Your AI assistant picks the right tools automatically — you don't need to call them directly.
 
 > **Note:** Infrastructure creation (datasources, datamarts, workspaces) is done in the **Databrain UI**. However, the **semantic layer** is populated via MCP tools (`get_semantic_layer`, `update_semantic_layer`) — the AI auto-generates descriptions from column names.
 
@@ -239,26 +245,24 @@ Prompts are guided workflows your AI assistant can follow. Ask for them by name
 </details>
 
 <details>
-<summary><b>Embeds</b> (7) — Create, configure, and customize embedded dashboards</summary>
+<summary><b>Embeds</b> (5) — Create, configure, and customize embedded dashboards</summary>
 
 | Tool | Description |
 |------|-------------|
 | `create_embed` | Create an embed (standard or multi-tenant with `clientId`) |
 | `list_embeds` | List embed configurations |
 | `get_embed_details` | Get full embed details by ID |
-| `update_embed` | Update embed config (raw patch) |
+| `update_embed` | Update embed config — access settings, options, filters, i18n (via `body` passthrough) |
 | `customize_embed_theme` | Presets, colors, fonts, cards, chart appearance, responsive layout |
-| `configure_embed` | UI options, filters (string/date/number/SQL), i18n, translations |
-| `diagnose_embed_health` | Diagnose malformed embeds + validate runtime readiness |
 </details>
 
 <details>
-<summary><b>Frontend</b> (2) — Guest tokens and code generation</summary>
+<summary><b>Runtime Integration</b> (2) — Guest tokens and frontend code</summary>
 
 | Tool | Description |
 |------|-------------|
 | `generate_guest_token` | Generate a frontend guest token (server-side) |
-| `generate_embed_code` | Generate integration code (React, Next.js, Vue, Angular, Svelte, vanilla JS) |
+| `generate_embed_code` | Generate integration code (React, Next.js, Vue, Angular, Svelte, SolidJS, vanilla JS) |
 </details>
 
 <details>
@@ -272,12 +276,18 @@ Prompts are guided workflows your AI assistant can follow. Ask for them by name
 </details>
 
 <details>
-<summary><b>Discovery & Orchestration</b> (2)</summary>
+<summary><b>Dashboards & Widgets</b> (6) — Discover dashboards and CRUD widgets on customer embeds</summary>
 
 | Tool | Description |
 |------|-------------|
 | `list_dashboards` | List dashboards (by data app, workspace, or globally) |
-| `setup_embed_interactive` | Guided step-by-step flow for the full embed setup |
+| `list_widgets` | List widgets on an embed for a specific client |
+| `add_widget` | Add a widget — clone from a template (`templateMetricId`), supply a full spec, or pass a raw body from `generate_widget` |
+| `update_widget` | Patch a widget's fields (name, query, chartOptions, isPublished, etc.) |
+| `remove_widget` | Per-client soft delete — hides the widget for one client only |
+| `generate_widget` | AI-generate a widget draft from a natural-language prompt. Returns a draft; pass to `add_widget` to persist |
+
+Widget mutation tools mint a guest token internally for `(clientId, dataAppName)`. Provide `embedId` + `clientId` — the tools resolve the rest.
 </details>
 
 ---
@@ -320,7 +330,7 @@ This usually means no workspace was selected. Ask the assistant: *"List my works
 
 1. Check that the guest token is generated **server-side** (never expose API tokens in frontend code)
 2. Verify the embed ID and dashboard ID match
-3. Ask: *"Run a health check on my embed"* — this runs `diagnose_embed_health`
+3. Ask: *"Check my embed configuration for issues"* — the assistant inspects via `get_embed_details`
 
 ### Theme changes not showing