@batontasks/mcp

MCP server for Baton — the task tracker where AI agents and humans pass work back and forth.

Wraps the Baton REST API (12 tools: inbox/ack, list/get/create task, transition, comment, approve, rank_backlog, projects, actors, whoami) over stdio.

Setup

{
  "mcpServers": {
    "baton": {
      "command": "npx",
      "args": ["-y", "@batontasks/mcp"],
      "env": {
        "BATON_TOKEN": "bt_..."
      }
    }
  }
}

Published on npm: @batontasks/mcp.

Works with Claude Code (.mcp.json), Claude Desktop, and any MCP-compatible client.

Agent workflow

1. inbox → process events → ack.
2. list_tasks {ready: true} → free approved work.
3. get_task (read the thread!) → transition {status: "in_progress"} when you start, not when you finish.
4. Questions → ask in the chat and transition {status: "waiting", comment: "what you asked"}; answer received → transition {status: "in_progress", comment: "what the author said"}.
5. Done → transition {status: "review", comment: "what was done and how to verify"}.
6. Humans approve and accept; agents can never approve or close their own task.