# workspace-board-mcp

MCP (stdio) server for workspace kanban boards. Reads/writes the same file as Web CLI:

`<workspace>/.webcli/board.json`

## Tools

| Tool | Purpose |
|------|---------|
| `board_get` | Full board summary or one card (`T-12` / `#T-12`) |
| `board_add_card` | Create card → `T-N` |
| `board_update_card` | Title / body |
| `board_move_card` | Change column (+ optional order) |
| `board_delete_card` | Remove card |
| `board_add_column` / `board_rename_column` / `board_delete_column` | Columns |

Every tool requires **`workspace`**: absolute path to the project root.

## Setup

```bat
cd C:\Users\furye\Documents\GitHub\workspace-board-mcp
npm install
npm run build
```

### Web CLI (`~/.webcli/mcp.json`)

```json
{
  "mcpServers": {
    "workspace-board": {
      "command": "node",
      "args": ["C:/Users/furye/Documents/GitHub/workspace-board-mcp/dist/index.js"]
    }
  }
}
```

(Merge with existing servers.) Restart Web CLI / promote so agents reload MCP.

### Cursor IDE

Same entry in Cursor MCP settings / `mcp.json`.

## Schema

Compatible with Web CLI Board UI (`version: 1`, default columns Inbox / In progress / Done).