You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@superset.apache.org by ru...@apache.org on 2026/09/10 00:53:26 UTC

(superset) branch master updated: docs(mcp): document delete_chart and delete_dashboard tools (#43898)

This is an automated email from the ASF dual-hosted git repository.

rusackas pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/superset.git


The following commit(s) were added to refs/heads/master by this push:
     new bdae45fee3f docs(mcp): document delete_chart and delete_dashboard tools (#43898)
bdae45fee3f is described below

commit bdae45fee3f72d33fed801398fac4beef1b381b3
Author: Evan Rusackas <ev...@preset.io>
AuthorDate: Wed Sep 9 17:53:16 2026 -0700

    docs(mcp): document delete_chart and delete_dashboard tools (#43898)
    
    Co-authored-by: Claude Sonnet 5 <no...@anthropic.com>
---
 .../docs/using-superset/using-ai-with-superset.mdx | 36 ++++++++++++----------
 1 file changed, 19 insertions(+), 17 deletions(-)

diff --git a/docs/docs/using-superset/using-ai-with-superset.mdx b/docs/docs/using-superset/using-ai-with-superset.mdx
index 8f17e0aa249..4ded14cf020 100644
--- a/docs/docs/using-superset/using-ai-with-superset.mdx
+++ b/docs/docs/using-superset/using-ai-with-superset.mdx
@@ -269,26 +269,28 @@ Ask your admin for the MCP server URL and any authentication tokens you need.
 
 ### Charts
 
-| Tool                    | Description                                                                                                                        |
-| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
-| `list_charts`           | List charts with filtering and search                                                                                              |
-| `get_chart_info`        | Get chart metadata and configuration                                                                                               |
-| `get_chart_data`        | Retrieve chart data (JSON, CSV, or Excel)                                                                                          |
-| `get_chart_preview`     | Generate a chart preview (URL, ASCII, table, or Vega-Lite)                                                                         |
-| `get_chart_type_schema` | Get the configuration schema for a chart type                                                                                      |
-| `generate_chart`        | Create a new chart from a specification (defaults to preview mode — review before saving)                                          |
-| `update_chart`          | Modify an existing chart's configuration (pass `generate_preview=False` to persist immediately instead of returning a preview URL) |
-| `update_chart_preview`  | Update a cached chart preview without saving                                                                                       |
-| `generate_explore_link` | Generate an Explore URL for interactive visualization                                                                              |
+| Tool                    | Description                                                                                                                                      |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `list_charts`           | List charts with filtering and search                                                                                                             |
+| `get_chart_info`        | Get chart metadata and configuration                                                                                                              |
+| `get_chart_data`        | Retrieve chart data (JSON, CSV, or Excel)                                                                                                         |
+| `get_chart_preview`     | Generate a chart preview (URL, ASCII, table, or Vega-Lite)                                                                                        |
+| `get_chart_type_schema` | Get the configuration schema for a chart type                                                                                                     |
+| `generate_chart`        | Create a new chart from a specification (defaults to preview mode — review before saving)                                                        |
+| `update_chart`          | Modify an existing chart's configuration (pass `generate_preview=False` to persist immediately instead of returning a preview URL)               |
+| `update_chart_preview`  | Update a cached chart preview without saving                                                                                                      |
+| `generate_explore_link` | Generate an Explore URL for interactive visualization                                                                                             |
+| `delete_chart`          | Delete a chart by ID or UUID (soft-deletes to trash when `SOFT_DELETE` is enabled; fails if alerts/reports are still attached, checked before editorship; otherwise returns `permission_denied` if the caller isn't an editor of the chart — owners, Admins, and explicitly granted editors qualify)   |
 
 ### Dashboards
 
-| Tool                              | Description                                  |
-| --------------------------------- | -------------------------------------------- |
-| `list_dashboards`                 | List dashboards with filtering and search    |
-| `get_dashboard_info`              | Get dashboard metadata and layout            |
-| `generate_dashboard`              | Create a new dashboard with specified charts |
-| `add_chart_to_existing_dashboard` | Add a chart to an existing dashboard         |
+| Tool                              | Description                                                                                                                                                                          |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `list_dashboards`                 | List dashboards with filtering and search                                                                                                                                            |
+| `get_dashboard_info`              | Get dashboard metadata and layout                                                                                                                                                    |
+| `generate_dashboard`              | Create a new dashboard with specified charts                                                                                                                                         |
+| `add_chart_to_existing_dashboard` | Add a chart to an existing dashboard                                                                                                                                                 |
+| `delete_dashboard`                | Delete a dashboard by ID, UUID, or slug; leaves its charts intact (soft-deletes to trash when `SOFT_DELETE` is enabled; fails if alerts/reports are still attached, checked before editorship; otherwise returns `permission_denied` if the caller isn't an editor of the dashboard — owners, Admins, and explicitly granted editors qualify) |
 
 ### SQL