@databrainhq/mcp-server 0.2.4 → 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,6 +207,7 @@ 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 |
+| `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 |
 | `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 |
@@ -205,7 +216,7 @@ Prompts are guided workflows your AI assistant can follow. Ask for them by name
 
 ## Tools Reference
 
-21 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.
 
@@ -246,7 +257,7 @@ Prompts are guided workflows your AI assistant can follow. Ask for them by name
 </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 |
 |------|-------------|
@@ -265,11 +276,18 @@ Prompts are guided workflows your AI assistant can follow. Ask for them by name
 </details>
 
 <details>
-<summary><b>Dashboard Discovery</b> (1)</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) |
+| `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>
 
 ---