name: preset-mcp-visualization description: Use Superset MCP tools for Explore links, chart configuration discovery, chart previews, saved charts, and chart updates. Use only for MCP tool workflows; do not use for direct API work.
preset-mcp-visualization
Use for chart and Explore workflows through MCP.
Always
- Treat "create", "make", or "build" a chart as saved-chart intent: use
generate_chartdirectly. Treat "add" as saved-chart intent only when no dashboard target is named; with a dashboard target, route topreset-mcp-dashboard. - Use
generate_explore_linkfor "show", "visualize", "explore", or "preview" requests with no save intent. - Use
get_dataset_infoonce to resolve exact column and metric names before building the config. - Use
get_chart_type_schemaonly for unfamiliar or complex chart types, or after a config validation error — not for simple bar, line, pie, table, or big-number charts. - Use saved metrics as saved metrics; do not treat metric names as raw columns.
generate_chartrequest shape: top-leveldataset_id(notdatasource_id), chart fields nested insideconfig, andconfig.chart_typeuses the MCP taxonomy, currently common values such asxy,table,pie,pivot_table,mixed_timeseries,handlebars, andbig_number— not a Supersetviz_typestring. If the needed type is not listed or validation fails, trustget_chart_type_schema.- Never fabricate URLs. Use URLs returned by MCP tools.
Decision Rules
- Creation intent ("create/make/build a chart", or "add a chart" with no dashboard target):
generate_chart. Do not substitute an unsaved Explore link. - Preview intent ("show/visualize/explore/preview"):
generate_explore_link. - Use
update_chartto change an existing saved chart. - Use
update_chart_previewonly for cached preview form data. - Route adding charts to dashboards to
preset-mcp-dashboard.
Workflow Order
- Resolve the dataset and its exact columns/metrics with one
get_dataset_infocall. - Build the config and call the tool matching the user's intent (create →
generate_chart). - If the call returns a validation error, do not retry the same config blindly: fetch
get_chart_type_schemaonce, fix the config against it, and retry once. - Report success based on the tool response, not assumption.
Retrieve
- Visualization workflow details: references/visualization-workflows.md