Superset MCP Server

Superset runs parallel AI coding agents in isolated Git worktrees on a user's registered machines. Its MCP server (Streamable HTTP, JSON-RPC 2.0) exposes the full orchestration surface as tools.

https://api.superset.sh/api/v2/agent/mcp   (alias: https://api.superset.sh/mcp)

Setup

# Claude Code
claude mcp add superset --transport http https://api.superset.sh/api/v2/agent/mcp

# OpenAI Codex
codex mcp add superset --url https://api.superset.sh/api/v2/agent/mcp

# Gemini CLI
gemini mcp add --transport http superset https://api.superset.sh/api/v2/agent/mcp

Any MCP client that speaks Streamable HTTP works — point it at the URL above.

Authentication

Unauthenticated requests return 401 with WWW-Authenticate: Bearer resource_metadata="https://api.superset.sh/.well-known/oauth-protected-resource";. Two options:

1. OAuth 2.1 (recommended) — authorization code + PKCE with RFC 7591 dynamic client registration; the user approves access in a browser. Most MCP clients handle this automatically on first connect.
2. API key — the user creates one in the Superset app and the agent sends it as a Bearer token.

Full walkthrough: <https://superset.sh/auth.md>;

Tools

27 tools across seven families (call tools/list for the live catalog with input schemas, or fetch <https://api.superset.sh/.well-known/mcp/server-card.json>;):

• hosts / projects — hostslist, projectslist: enumerate the user's registered machines and checked-out repos. IDs are host-scoped, so start here.
• workspaces — create (branch- or PR-scoped Git worktrees), list, rename, delete.
• agents — launch a coding-agent session (Claude Code, Codex, OpenCode, ...) with a prompt inside a workspace; list installed agent presets.
• terminals — open a PTY in a workspace, optionally running a one-off command.
• automations — schedule recurring agent runs (RFC 5545 RRULE), pause/resume/dispatch, read run logs.
• tasks — create, search, update, delete tasks; list statuses and organization members.

Tools carry MCP behavioral annotations: reads are readOnlyHint, the three *_delete tools are destructiveHint — confirm with the user before calling those.

Typical flow

1. hosts_list → pick an online host.
2. projects_list (on that host) → pick a repo.
3. workspaces_create with branch or pr — optionally pass agents to spawn a coding agent in the new worktree in the same call.
4. Track follow-up work with taskscreate / automationscreate.

Learning surface

The documentation is also served over MCP, unauthenticated, at https://docs.superset.sh/mcp (docssearch + docsread). Human-readable docs: <https://docs.superset.sh/mcp-server>;.