PlugWiki

Apache Superset MCP server (built in)

OfficialRemote

Lets your AI assistant explore your Superset dashboards and datasets, run SQL and build charts for you.

Apache Superset has its own MCP server built in, so Claude, ChatGPT and other assistants can browse your dashboards, query datasets, run SQL and build charts on your own Superset. It respects the same roles and row-level security as the web app. It first shipped in Superset 6.1.0 and runs as a separate process you start next to Superset. Out of the box it has no sign-in and acts as one user you pick, so keep it on your own machine until you turn on token sign-in.

Good for

  • Analysts who want to ask questions of their Superset datasets in plain words
  • Dashboard builders who want charts and dashboards drafted from a description
  • Data engineers who want SQL run and saved as datasets from their AI assistant
  • Superset admins who need an AI connection that keeps existing roles and row-level security

Works in

3 supported · 10 should work

Tap an app to see how to set it up and any known problems.

Install Apache Superset MCP Service

Claude Code

  1. 1

    Copy this prompt.

    Add the Apache Superset MCP Service server to Claude Code. Run this command:
    
    claude mcp add --transport http superset http://localhost:5008/mcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Superset 6.1.0 or later, The MCP service running next to Superset.

Read-only mode: Connect as a user with a read-only Superset role, or ask your admin to turn off the SQL and write tools.

Start the MCP service first (see the Standalone tab). It listens on port 5008 by default. Superset's docs show the .mcp.json form with "type": "url"; Claude Code's own docs use "http" for web servers, so change it to "http" if the server does not show up.

Built from the package data we hold. Not yet tested by us.

Tools

  • Lists your dashboards, with search and filters

    Shows the dashboards in your Superset, and can search or filter them by name and other details.

    Try: “Which dashboards do we have about sales?”

    Read · list_dashboards

  • Shows details of one dashboard

    Gets a dashboard's title, charts, owners and settings from its ID, slug or a shared link.

    Try: “What charts are on the Q4 Sales Overview dashboard?”

    Read · get_dashboard_info

  • Pulls the data behind a dashboard's charts, with its filters applied

    Fetches a limited amount of data from the charts on a dashboard, taking the dashboard's filters into account. Added after Superset 6.1.0.

    Try: “Summarise the numbers on the revenue dashboard for last month.”

    Network · get_dashboard_data

  • Shows how a dashboard is laid out

    Returns the layout of a dashboard: its rows, tabs, headers and where each chart sits. Added after Superset 6.1.0.

    Try: “How is the executive dashboard organised?”

    Read · get_dashboard_layout

  • Lists the datasets a dashboard's charts use

    Shows which datasets and semantic views feed the charts on a dashboard. Added after Superset 6.1.0.

    Try: “Which datasets does the marketing dashboard depend on?”

    Read · get_dashboard_datasets

  • Lists your saved charts, with search and filters

    Shows the saved charts in your Superset and can search or filter them.

    Try: “Find all charts that use the orders dataset.”

    Read · list_charts

  • Shows the settings of one chart

    Gets a chart's type, dataset, metrics and other settings from its ID.

    Try: “How is chart 42 configured?”

    Read · get_chart_info

  • Gets the data a chart shows

    Returns the data behind a saved chart so the assistant can read or summarise it.

    Try: “What are the numbers in the weekly signups chart?”

    Network · get_chart_data

  • Gets a preview of a saved chart

    Returns a preview of a saved chart, such as an image or table.

    Try: “Show me a preview of chart 15.”

    Read · get_chart_preview

  • Shows the SQL a chart runs, without running it

    Returns the SQL query Superset builds for a chart, without executing it. Added after Superset 6.1.0.

    Try: “What SQL does the revenue by region chart run?”

    Read · get_chart_sql

  • Lists your datasets

    Shows the SQL datasets registered in Superset, with search and filters.

    Try: “What datasets are available?”

    Read · list_datasets

  • Shows a dataset's columns and metrics

    Gets a dataset's columns, saved metrics and settings.

    Try: “Show me the columns in the sales_orders dataset.”

    Read · get_dataset_info

Read from the source code

Pros and cons

Good

  • Built into Superset by the Apache project, free under Apache-2.0.
  • Uses the same roles, row-level security and audit log as the web app.
  • Builds charts as previews first and only saves when you ask.
  • Can turn SQL into a saved dataset you can chart.
  • Works with ChatGPT and claude.ai as well as local clients once it has a public HTTPS address.
  • Lists only a few tools up front and finds the rest on demand, which saves context.

Watch out

  • Only in Superset 6.1.0 and later, though the docs say 5.0+.
  • The stock Docker image before 7.0 lacks the extra it needs.
  • No sign-in by default.
  • On 6.1.0 everyone shares one account.
  • No single read-only switch.
  • You host and expose it yourself; Apache runs no hosted version.
  • Some tools still error on 6.1.0.

Permissions

high risk · 6 things to watch

High risk

It can run SQL on your connected databases and change or delete charts, dashboards and datasets, and by default anyone who reaches the port acts as the user you set. Turn on token sign-in before you expose it, and connect as a read-only user unless you need changes.

What it can do

Watch out for

  • No sign-in by default

    Every caller acts as the user set in MCP_DEV_USERNAME, often an admin. Keep the port on localhost or turn on token sign-in first. superset.apache.org

  • It runs SQL on your databases

    DROP, TRUNCATE and ALTER are blocked, but other writes run if the database login allows them. Use a read-only database login or disable the SQL tool. github.com

  • 6.1.0 cannot give each person their own login

    Maintainers say 6.1.0 cannot map tokens to users, so everyone shares one account. Per-user permissions need a newer build. github.com

  • A broken custom sign-in can leave it open

    On 6.1.0, if a custom MCP_AUTH_FACTORY fails, the server starts with no sign-in. Check the logs after setup; newer builds refuse to start. github.com

  • Newer builds can delete and change access

    Builds after 6.1.0 add tools that delete charts, dashboards and datasets and change dashboard owners and roles. Deleted items can be restored from trash. github.com

  • Roles and audit log apply

    Each call checks the user's Superset roles and row-level security, and is recorded in Settings, Action Log. superset.apache.org

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyNo single switch. Connect as a user with a read-only Superset role (Gamma), require read scopes with MCP_REQUIRED_SCOPES, or remove tools such as execute_sql with MCP_DISABLED_TOOLS.
Talks toYour Superset instance and its connected databases. Your AI provider, through the assistant
Sign-in and keysOptional JWT bearer token sent by the client; off by default (MCP_AUTH_ENABLED = False, calls run as MCP_DEV_USERNAME).
Scopes
  • mcp:read

  • mcp:write

Alternatives

Use the built-in server if you run Superset 6.1.0 or later yourself. Preset Cloud customers should use Preset's hosted version, and the community servers fit older Superset versions that lack the built-in one.

ServerOfficialRunsSign-inCan change thingsGitHub stars
For Apache Superset
Superset (built in)This pageOfficialSelf-hostedNone or tokenYes–
MCP SupersetCommunityLocal––60
superset-mcpCommunityLocalPassword or token–24
Other tools for the same job
Preset MCP–HostedAccount––

What people say

Questions

Which Superset version has the MCP server?

Superset 6.1.0 or later. Versions 5.0 and 6.0 do not have it, even though the docs say 5.0+. Superset 7.0, now in release candidates, adds many more tools.

Is the Superset MCP server free?

Yes. It is part of open-source Apache Superset. Preset's hosted version for Preset Cloud is a paid Enterprise add-on.

What is the Superset MCP server URL?

There is no shared address: it runs on your own server, by default at http://localhost:5008/mcp. ChatGPT and claude.ai need a public HTTPS address that points to it.

Why does it say "No such command mcp"?

Your Superset is older than 6.1.0 or was installed without the MCP extra. The stock Docker image before 7.0 leaves it out, so build your own image with it or use a 7.0 image.

Is it safe?

It keeps Superset's roles and row-level security, but by default it has no sign-in and acts as one user you choose. Keep it on localhost or turn on token sign-in, and use a read-only user unless you need changes.

Can I make it read-only?

Not with one switch. Connect it as a user with a read-only Superset role, require read-only token scopes, or turn off the SQL and write tools in the server settings.

Can it delete dashboards or data?

Builds after 6.1.0 can delete charts, dashboards and datasets, which go to the trash and can be restored. Its SQL tool blocks DROP, TRUNCATE and ALTER, but other changes run if the database login allows them.

Why does sign-in with a token or SSO fail on 6.1.0?

The maintainers say 6.1.0 cannot yet match tokens to Superset users. The workaround is to run it as one account; per-user sign-in is in newer builds.

Why does my assistant only see a few tools?

By default it shows a handful of tools and lets the assistant search for the rest, to save context. An admin can switch that off so every tool is listed.

Superset MCP vs Preset MCP?

They are the same service. Use the built-in one on your own Superset; use Preset's hosted version, with sign-in through your Preset account, if your dashboards live in Preset Cloud.

Examples

  • See what data you can work with

    What datasets are available? Show me the columns in the sales_orders dataset.

    Source
  • Build a chart from a dataset

    Create a bar chart showing monthly revenue by region from the sales dataset

    Source
  • Put existing charts on a new dashboard

    Create a dashboard called 'Q4 Sales Overview' with charts 10, 15, and 22

    Source
  • Turn a SQL query into a dataset you can chart

    Create a dataset from: SELECT region, SUM(revenue) as total_revenue FROM orders GROUP BY region

    Source

Information

updated Nov 1, 2026

Publisher
Official
Transport
Streamable HTTP
Auth
None
License
Apache-2.0
Last commit
Nov 2, 2026

WebsiteDocsPyPIChangelog

Other Apache Superset MCP servers

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 15
  1. MCP Server Deployment & Authentication · superset.apache.org
  2. UPDATING.md · github.com
  3. Using AI with Superset · superset.apache.org
  4. Docker superset mcp no such command on latest · github.com
  5. superset/mcp_service source · github.com
  6. MCP tool inventory · github.com
  7. execute_sql tool source · github.com
  8. MCP user resolution not working in release 6.1.0 · github.com
  9. Failing MCP_AUTH_FACTORY starts unauthenticated · github.com
  10. Preset MCP server authentication · docs.preset.io
  11. opencode dataset creation error · github.com
  12. Apache Superset MCP Service: A Technical Deep Dive · preset.io
  13. mcp-superset · github.com
  14. superset-mcp · github.com
  15. DetachedInstanceError in list_dashboards · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 1, 2026.