mcpField
S
superset-mcp

superset-mcp

github.com/paradevaiAgent workflows7130 installsUpdated 13w ago
Repository

About superset-mcp

Superset MCP exposes tools for coordinating coding agents across registered machines and isolated Git worktrees. It is for MCP clients that need to manage workspaces, terminals, automations, and tasks.

Key features

  1. 01List registered machines and projects
  2. 02Create and manage Git workspaces
  3. 03Launch coding-agent sessions
  4. 04Open workspace terminals
  5. 05Schedule recurring agent runs
  6. 06Manage organization tasks

Use cases

  1. 01Start a coding agent in a branch-specific worktree
  2. 02Run scheduled agent tasks and inspect logs
  3. 03Track coding work with organization tasks

MCP support

The MCP server exposes Superset’s orchestration tools over Streamable HTTP. MCP clients can connect using OAuth 2.1 or a Bearer API key.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/paradevai/skills --skill superset-mcp

After installing, type/superset-mcpin Claude Code to confirm it loaded.

Details

From the project README

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 — hosts_list, projects_list: 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 tasks_create / automations_create.

Learning surface

The documentation is also served over MCP, unauthenticated, at https://docs.superset.sh/mcp (docs_search + docs_read). Human-readable docs: https://docs.superset.sh/mcp-server.

Comments

Markdown supported