{
 "schema_version": 1,
 "generated": "2026-10-24",
 "id": "jklthinking-retinue--let-coding-agents-use-the-board-through-mcp",
 "repo": "jklthinking/retinue",
 "repo_url": "https://github.com/jklthinking/retinue",
 "repo_slug": "jklthinking-retinue",
 "title": "Connect a coding agent to the board through MCP",
 "page_title": "How to connect a coding agent to the board through MCP with Retinue",
 "summary": "Let Claude Code or Codex read and update Retinue cards without hand-written curl calls.",
 "who": "A developer who already runs Claude Code or OpenAI Codex and wants those agents to pick up and report on board cards directly.",
 "problem": "Agents need a way to claim work and write back that fits how they already operate, and hand-built HTTP calls are fragile to maintain.",
 "outcome": "An MCP-capable agent that can see its assigned cards, post progress, and hand off or complete work through the same holder-only rules as the HTTP API.",
 "steps": [
  "Install the MCP extra with `pip install 'retinue[mcp]'`.",
  "Make sure the hub is running (`curl -fsS http://127.0.0.1:9219/api/health` should return status ok).",
  "Read docs/agent-onboarding.md in the repo to set up the agent identity and token.",
  "Start the MCP server with `retinue-server mcp` and register it with the agent as an MCP server.",
  "Ask the agent to claim one assigned card and post a progress update, then check the card's receipt chain on the board."
 ],
 "agent_prompt": "In the Retinue repo at <repo path>, install retinue[mcp], start retinue-server mcp, and register it with this agent. Claim the card <task id> and post one progress update. Report the claim and update receipts, and verify the card shows the agent as holder.",
 "agents": [
  "claude-code",
  "codex"
 ],
 "difficulty": "Intermediate",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "The README names the MCP command and onboarding doc but does not list the exact MCP client configuration, so the agent registration step depends on the agent's own MCP setup.",
 "category": "Work and operations",
 "tags": [
  "Work and operations"
 ],
 "lang": "python",
 "requirements": [
  "Docker with Compose installed",
  "Host port 9219 free on the machine that will run the hub",
  "An admin password of at least 8 characters",
  "Python for the optional MCP install (pip install 'retinue[mcp]')",
  "An agent that can send HTTP requests or speak MCP"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/jklthinking-retinue/let-coding-agents-use-the-board-through-mcp/",
 "md": "https://dedupedai.com/use-cases/jklthinking-retinue/let-coding-agents-use-the-board-through-mcp/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/jklthinking-retinue--let-coding-agents-use-the-board-through-mcp.json",
 "api_version": "v1"
}