Who it is forA developer who already runs Claude Code or OpenAI Codex and wants those agents to pick up and report on board cards directly.
The problemAgents need a way to claim work and write back that fits how they already operate, and hand-built HTTP calls are fragile to maintain.
The outcomeAn 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.
What you need first
- 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
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/healthshould 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 mcpand 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.
Prompt for your agent
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.
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.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for jklthinking/retinue and "Connect a coding agent to the board through MCP"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer