{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_y3xqms53ywvx","handle":"dsh-kanban-mcp","url":"https://wellknown.network/agents/dsh-kanban-mcp","links":{"self":"https://wellknown.network/agents/dsh-kanban-mcp/record.json","html":"https://wellknown.network/agents/dsh-kanban-mcp","markdown":"https://wellknown.network/agents/dsh-kanban-mcp/record.md","api":"https://wellknown.network/api/v1/agents/dsh-kanban-mcp","status":"https://wellknown.network/api/v1/agents/dsh-kanban-mcp/status","claim":"https://wellknown.network/agents/dsh-kanban-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/dsh-kanban-mcp/claim.json","badge":"https://wellknown.network/agents/dsh-kanban-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/dsh-kanban-mcp/history","tools":"https://wellknown.network/api/v1/agents/dsh-kanban-mcp/tools"},"ard":{"identifier":"urn:air::server:dsh-kanban-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"dsh-kanban-mcp","summary":"Filesystem-driven four-lane kanban board (todo / doing / blocked / done) exposed as a read-only MCP server and a Python API. Works with DeepSeek Harness and any MCP client.","description":"# dsh-kanban-mcp \n \n> Filesystem-driven four-lane kanban board (todo / doing / blocked / done) exposed as a read-only MCP server and a Python API. Works with DeepSeek Harness and any MCP client. \n \nA kanban board is just a directory tree of markdown cards: \n \n``` \n<base_dir>/YYYY/YYYY-MM/YYYY-MM-DD/{todo,doing,blocked,done}/YYYYMMDD-HHMMSS__agent__slug__status.md \n``` \n \nThat design is the whole point: the board survives restarts, is diffable in git, needs no database, and can be inspected by any file tool. This package manages those files and exposes the board to agents over MCP. \n \n## Install \n \n```bash \npip install \"dsh-kanban-mcp\"          # Python API \npip install \"dsh-kanban-mcp[mcp]\"     # + MCP server (fastmcp) \n``` \n \nRequires Python 3.10+. \n \n## Run the MCP server \n \n```bash \npython -m kanban_mcp          # stdio transport \n# or: kanban-mcp \n``` \n \nRegister it in **DeepSeek Harness** (MCP settings — the built-in MCP client) or any MCP client. The tools take an optional `base_dir` argument (default `.agent/kanban`) so one server can point at any board. \n \n## Tools (read-only) \n \n| Tool | Description | \n|---|---| \n| `kanban_board` | Full four-lane board with card details (agent, work_item, purpose, status, outcome, priority, timestamps) | \n| `kanban_status` | Per-lane card counts + total | \n| `kanban_doing` | Cards currently in progress | \n| `kanban_blocked` | Blocked cards | \n| `kanban_done_today` | Cards completed today | \n \nAll tools are read-only. Card **creation / update / movement** is available through the `KanbanManager` Python API (see below); write tools are planned but not yet exposed over MCP. \n \n## Python API \n \n```python \nfrom kanban_mcp import KanbanManager, LaneStatus \n \nkanban = KanbanManager(base_dir=\".agent/kanban\") \n \ncard = kanban.create_doing_card( \n    agent=\"coder\", \n    work_item=\"build-api\", \n    purpose=\"Build the REST API endpoint\", \n) \nkanban.update_card(card, outcome=\"GET /users implemented\") \nkanban.move_to_done(\"coder\", \"buil…","publisher":{"name":"Chen (Jarry) Pan","url":null},"homepage":null,"repository":null,"version":"0.1.2","license":"MIT","protocols":["mcp"],"tags":["deepseek-harness","dsh","dsh-plugin","kanban","mcp","mcp-server","task-tracking","agent"],"pricing":null,"endpoints":[{"url":"pypi:dsh-kanban-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.project-management","name":"Project Management","confidence":1,"provenance":"declared"},{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"derived"},{"slug":"productivity.tasks","name":"Tasks & To-do","confidence":0.745,"provenance":"derived"}],"categories":["dev","productivity"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"dsh-kanban-mcp","registry":"pypi","observedAt":"2026-10-27T23:25:42.894Z","publishedAt":"2026-08-16T09:20:45.066019Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"dsh-kanban-mcp","url":"https://pypi.org/project/dsh-kanban-mcp/","firstSeenAt":"2026-09-09T14:32:26.103Z","fetchedAt":"2026-10-27T23:25:15.035Z","normalizedAt":"2026-10-27T23:25:15.035Z"}]},"firstSeenAt":"2026-09-09T14:32:26.103Z","updatedAt":"2026-10-27T23:25:42.894Z"}