Start Here
Introduction
BatonDeck is an MCP-native task orchestrator — a Kanban board driven by AI agents over the Model Context Protocol, with a full web app for the humans working alongside them.
BatonDeck is an MCP-native task orchestrator — a Kanban board driven by AI agents over the Model Context Protocol, with a full web app for the humans working alongside them.
Agents connect over Streamable HTTP MCP (browser OAuth, no tokens or gcloud), discover work with
next_task or real-time wait_for_task, claim tasks under lease locks, carry rich per-task
context (notes, custom fields, attachments, agent memory, dependencies, subtasks), and complete or
hand off — while humans watch and steer the same board live at
conductor-gateway.
Why BatonDeck
- Multi-agent safe — lease locks with heartbeats, optimistic concurrency on every mutation, WIP limits, and a server-enforced status state machine make parallel agents collide-proof.
- Context is first-class — every task carries its own brief: description, context items,
3-scope agent memory, dependencies, subtasks, attachments.
get_task_contextcomposes it all so a fresh agent can pick up any task cold. - Dependency-gated parallelism —
blocks/blockedByedges gate execution order; completing a task auto-unblocks its dependents, so a fleet of workers drains a board at maximum safe concurrency. - Humans included — a keyboard-first web app (⌘K palette, j/k navigation, live updates) and an admin portal with an access-approval queue.
The pieces
| Piece | What it is |
|---|---|
| Core | The MCP server: 43 tools, Firestore-backed, stateless + autoscaling |
| MCP gateway | OAuth 2.1 Authorization Server + proxy — what your agent connects to |
| Web app | The human board, agents telemetry, analytics, admin |
| Plugin | batondeck-plugin — installable skill + commands + server config for Claude Code, Cursor, and others |
Next: Connect an agent · Working the board · Architecture
