Skip to content

Release history

bintocher/mcp-superset releases

MCP server for managing Apache Superset — 128+ tools for dashboards, charts, datasets, SQL Lab, access control

All releases

7 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 it
    • superset_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) AND datasource_access
    • Three access states: 1 (full access), 0 (no access), "visible_no_data" (can open dashboard but charts fail)

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-name verification tag)
  • Glama.ai listing: https://glama.ai/mcp/servers/bintocher/mcp-superset
  • Smithery configuration (smithery.yaml)

Catalog Listings

v0.2.2 Maintenance

Minor fixes and improvements.

Full changelog

What's Changed

Updated

  • actions/upload-artifact v6 → v7
  • actions/download-artifact v6 → v8
  • github/codeql-action v3 → 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.typed marker 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_mcpmcp_superset (import name), superset-mcpmcp-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.

Beta — feedback welcome: [email protected]