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

package/skills/style-dashboard/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: style-dashboard
+description: Use when a user asks to format or style Databrain dashboard charts. Triggers on "use a log scale", "make this 100% stacked", "sort the bars", and "format revenue as currency".
+---
+
+# Style Databrain dashboard charts
+
+## Requirements
+
+Work from the full current `chartOptions` object. If you cannot read or reconstruct the full object, do not replace it with a partial object.
+
+## Workflow
+
+1. Find the target Metric or Widget and its full `chartOptions`.
+2. Merge changes under `chartOptions.customSettings`. Preserve every sibling setting and every untouched appearance key.
+3. Use only the requested controls:
+   - `chartScale`: set the physical value axis. Types are `linear`, `log`, `sqrt`, or `symlog`. A log axis also needs an explicit `logZeroPolicy`: `refuse`, `clamp`, or `drop`.
+   - `chartStack`: set `mode` to `none`, `zero`, `center`, or `normalize`. For `normalize`, set a percent `normalizedFormat`.
+   - `chartSort`: set `by` to `natural`, `declared`, `category`, `value`, or `stack-total`, plus `direction`. Use sort only on supported bar, row, and stacked chart families.
+   - `chartFieldFormats`: key formats by the real result column name. Currency requires an ISO 4217 code such as `USD`.
+4. For a new Dashboard, put the merged `chartOptions` on each Tile before `create_dashboard`.
+5. For an existing tenant Embed, call `update_widget` only when you have the full current `chartOptions` and the Widget `externalMetricId`. Send the full merged object in `set.chartOptions`.
+6. Verify the saved values and return a demo link or rendered preview. A successful tool response alone does not prove the chart looks correct.
+
+Example merged settings:
+
+```json
+{
+  "customSettings": {
+    "chartScale": {
+      "vertical": {
+        "type": "log",
+        "logZeroPolicy": "refuse"
+      }
+    },
+    "chartStack": {
+      "mode": "normalize",
+      "normalizedFormat": {
+        "type": "percent",
+        "round": 0
+      }
+    },
+    "chartSort": {
+      "by": "stack-total",
+      "direction": "desc"
+    },
+    "chartFieldFormats": {
+      "revenue": {
+        "type": "currency",
+        "currency": "USD",
+        "round": 0
+      }
+    }
+  }
+}
+```
+
+The current MCP surface can read an existing workspace Dashboard with `get_dashboard`, but it has no safe workspace Dashboard update tool. Report that limit. Do not create a duplicate Dashboard or overwrite unknown settings.