Release history
bintocher/mcp-superset releases
MCP server for managing Apache Superset — 128+ tools for dashboards, charts, datasets, SQL Lab, access control
All releases
12 shown
v0.2.5
New feature
Notable features
- Bulk user role operations (add, remove, replace)
- Dry-run mode for bulk operations
- Enhanced permissions audit with datasource_access checks
Full changelog
What's Changed
Added
- Bulk role operations (4 new tools):
superset_bulk_user_role_add— add a role to multiple users (by user IDs or by current role filter)superset_bulk_user_role_remove— remove a role from multiple users (prevents removing last role)superset_bulk_user_role_replace— replace one role with another for all users who have itsuperset_role_copy_permissions— copy all permissions from one role to another- All bulk operations support dry-run mode and exclude Admin users by default
- Improved permissions audit (
superset_permissions_audit):- Now checks both dashboard visibility (via
dashboard.roles) ANDdatasource_access - Three access states:
1(full access),0(no access),"visible_no_data"(can open dashboard but charts fail)
- Now checks both dashboard visibility (via
Changed
- Total tools: 137 (was 133)
Full Changelog: https://github.com/bintocher/mcp-superset/blob/main/CHANGELOG.md
v0.2.4
Maintenance
Minor fixes and improvements.
Full changelog
What's Changed
Added
- Extended README badges: PyPI downloads, CodeQL, Superset version, MCP compatible, py.typed, Ruff, uv, tools count, GitHub stars
- Official MCP Registry support
- Glama.ai and Smithery listings
Install / Upgrade
pip install --upgrade mcp-superset
# or
uvx mcp-superset
v0.2.3
Maintenance
Minor fixes and improvements.
Full changelog
Added
- Official MCP Registry support (
server.json,mcp-nameverification tag) - Glama.ai listing: https://glama.ai/mcp/servers/bintocher/mcp-superset
- Smithery configuration (
smithery.yaml)
Catalog Listings
- awesome-mcp-servers PR (82.7k stars)
- Glama.ai
v0.2.2
Maintenance
Minor fixes and improvements.
Full changelog
What's Changed
Updated
actions/upload-artifactv6 → v7actions/download-artifactv6 → v8github/codeql-actionv3 → v4
Merged 3 Dependabot PRs for GitHub Actions dependency updates.
Install / Upgrade
pip install --upgrade mcp-superset
# or
uvx mcp-superset
v0.2.1
New feature
Notable features
- Health check endpoint (GET /health)
- CodeQL security scanning workflow
- Pre-commit hooks configuration
Full changelog
What's New
Added
- Health check endpoint:
GET /health— returns server status, version, and Superset URL (no auth required) - PEP 561
py.typedmarker for typed package support - CONTRIBUTING.md with development setup and contribution guidelines
- SECURITY.md with responsible disclosure policy
- GitHub templates for bug reports, feature requests, and pull requests
- Dependabot configuration for automated dependency updates
- Pre-commit hooks configuration (ruff lint/format, trailing whitespace, YAML validation)
- CodeQL security scanning workflow
Changed
- All comments, docstrings, and error messages translated to English
- Google-style docstrings added to all public functions and methods
Install / Upgrade
pip install --upgrade mcp-superset
# or
uvx mcp-superset
v0.2.0
Breaking risk
Breaking changes
- Package renamed from superset-mcp to mcp-superset: update imports to `from mcp_superset import ...` and CLI to `python -m mcp_superset`
Full changelog
What's Changed
Breaking
- Renamed package:
superset_mcp→mcp_superset(import name),superset-mcp→mcp-superset(PyPI name) - Update imports:
from mcp_superset import ...and CLI:python -m mcp_superset
Updated
- Updated GitHub Actions to latest versions (checkout@v6, setup-uv@v7, upload-artifact@v6)
- Fixed Makefile references to new package name
Migration
# Uninstall old package (if installed)
pip uninstall superset-mcp
# Install new package
pip install mcp-superset
# Or run directly
uvx mcp-superset
v0.1.0
New feature
Notable features
- 128+ tools for full Superset REST API coverage
- JWT authentication with automatic token refresh
- Permissions audit tool
Full changelog
mcp-superset v0.1.0
Comprehensive MCP server for Apache Superset with 128+ tools.
Highlights
- Full Superset 6.0.1 REST API coverage: dashboards, charts, datasets, databases, SQL Lab, security, RLS, groups, tags, reports, annotations, audit, asset management
- JWT authentication with automatic token refresh and CSRF handling
- Built-in safety: 14 confirmation flag types, DDL/DML blocking, system role protection
- Automatic datasource_access synchronization
- Dashboard native filter management (add/update/delete/reset)
- Permissions audit tool (user x dashboards x datasets x RLS matrix)
- CLI with
--host,--port,--transport,--env-file - Streamable HTTP, SSE, and stdio transports
- Works with Claude Code, Claude Desktop, Cursor, Windsurf, and any MCP client
Install
pip install mcp-superset
# or
uvx mcp-superset
See README for full documentation.