@hakenshi/agentic-backlog-mcp-server
v0.1.4
Published
Local-first MCP backlog server for AI agents
Downloads
48
Readme
Agentic Backlog MCP Server
Local-first MCP server for AI backlog management.
This package runs over stdio (Node.js) and forwards MCP tool calls to a running backlog API.
Exposed tools
backlog.identify_projectbacklog.healthbacklog.versionbacklog.list_projectsbacklog.get_projectbacklog.get_kanban_urlbacklog.create_taskbacklog.list_tasksbacklog.get_taskbacklog.find_tasks_by_titlebacklog.update_taskbacklog.update_task_by_titlebacklog.delete_taskbacklog.update_task_statusbacklog.add_task_notebacklog.plan_from_contextbacklog.get_focusbacklog.claim_taskbacklog.release_taskbacklog.restore_taskbacklog.get_boardbacklog.get_console_table
Requirements
- Node.js 18+
Environment
BACKLOG_REQUEST_TIMEOUT_MS=1800
BACKLOG_API_FAIL_FAST_MS=15000
BACKLOG_API_FAILURE_THRESHOLD=1Run locally
npm install
npm run build
npm startFor development:
npm run devMCP config example
.mcp.json file:
{
"mcp": {
"agentic-backlog": {
"command": "npx",
"args": ["-y", "@hakenshi/agentic-backlog-mcp-server"]
}
}
}The MCP server is pinned to http://127.0.0.1:38081/api.
Notes
- This server uses
stdiotransport only. - Do not use
console.login MCP stdio mode (stdout breaks JSON-RPC). Logs must go tostderr. backlog.delete_taskrequires explicitconfirm: "DELETE".backlog.plan_from_contextis preview-only by default. Setapply: trueto persist changes.- API resilience is fail-fast: when repeated timeout/5xx errors happen, the server opens a short circuit window and returns immediate 503 errors so agent runs do not stall.
