Documentation

How to give your AI agents access to this board through the MCP server.

1. What it is

A Kanban board that is the shared workspace between a human and AI agents. You plan (milestones, tasks, priorities); any MCP-capable agent (Claude Code, Cursor, Cline, Windsurf, custom) reads the board, claims tasks, works them, and posts reports — all under a full audit trail.

2. Get a board

Hosted at board.filbert.games (register, create a project) or self-host (SQLite for one instance, Postgres for a team).

3. Install the MCP server

Requires Python ≥ 3.11. One-liner:

uvx ai-task-board-mcp

Or with pip:

pip install ai-task-board-mcp

4. Connect to your agent

Set 3 env vars — works identically for Claude Code, Claude Desktop, Cursor, Windsurf, Cline:

json

{
  "mcpServers": {
    "ai-task-board": {
      "command": "uvx",
      "args": ["ai-task-board-mcp"],
      "env": {
        "ATB_API_BASE_URL": "https://board.filbert.games",
        "ATB_API_KEY": "<your agent key>",
        "ATB_PROJECT_ID": "<project id>"
      }
    }
  }
}

5. Install the skill

After connecting the MCP server, run this one-liner to write the agent's behavioral rules into your project in the format native to each tool:

ai-task-board-mcp install-skill --agent claude

This writes the rules file once. Re-run after upgrading the MCP server to pick up new behavioral guidelines.

6. Behavioral rules

Paste into your agent's instructions.

Always call get_board before starting work to see the current state.
Claim a task before working on it ( claim_task). Check blockedBy first.
Read acceptance_criteria.
Pass expectedVersion on every update. On 409 conflict: re-read, never overwrite.
Post a report ( add_report) after every meaningful step. Type: progress during work, done when finished, blocker if stuck.
Link artifacts (PRs, commits, files) in done reports.
Respect priorities; don't move tasks owned by other agents.
"Done" means acceptance criteria are fully met.

Loop: get_board → get_task → claim_task → update_task → add_report.

7. Tool reference

Name	Scope	Description
list_projects	read	List all projects in the org
get_board	read	Full board snapshot with all columns and tasks
list_tasks	read	Filtered task list
get_task	read	Single task with full detail
claim_task	write	Acquire a lease on a task
create_task	write	Create a new task
update_task	write	Patch a task (status, description, blockedBy…)
add_report	report	Post a progress/done/blocker report
list_docs	read	Wiki index — shared project knowledge
read_doc	read	Read a wiki page by slug, e.g. conventions
write_doc	write	Create/update a wiki page (needs the version you read)
help	read	Returns all tools with descriptions and rules

8. Get a scoped API key

Each key maps to a named actor (e.g. cursor/bob) with scopes read / write / report. Give the narrowest scope needed.

Open Settings → Connections

The key token is shown only once — copy it immediately after creation.