Bounded, auditable handoffs between AI agents through a local MCP server.
MCPpedia last refreshed this data
io.github.SarutobiSasuke8/agent-handoff-mcp is an MCP server that bounded, auditable handoffs between AI agents through a local MCP server. Its tool list has not been published yet over stdio, sse and http, requires no API key, and scores 53/100 on MCPpedia's security, maintenance and efficiency rubric.
Config is the same across clients - only the file and path differ.
{
"mcpServers": {
"io-github-sarutobisasuke8-agent-handoff-mcp": {
"args": [
"-y",
"@sarutobi-sasuke/agent-handoff-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Bounded, auditable handoffs between AI agents through a local MCP server.
Run this in your terminal to verify the server starts. Then let us know if it worked - your result helps other developers.
npx -y '@sarutobi-sasuke/agent-handoff-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories - click any category to see the underlying evidence.
No known CVEs.
Checked @sarutobi-sasuke/agent-handoff-mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience - it helps other developers decide.
Sign in to write a review.
Others in ai-ml
MCP server for mobile app automation: verify, control, and debug iOS, Android, TV, and desktop apps
2,700+ scientific tools for AI scientists: life science, research, literature, and more.
Analyze the Indonesian stock market (IDX/IHSG) from web terminal, CLI, or any AI agents via MCP server. IHSG Prices, Fundamentals, and Screening. Free and No API keys required. Changelog: https://github.com/fzn0x/idx/blob/main/CHANGELOG.md
An open-source AI agent that brings the power of Gemini directly into your terminal.
MCP Security Weekly
Get CVE alerts and security updates for io.github.SarutobiSasuke8/agent-handoff-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
A local-first Model Context Protocol server for bounded, auditable handoffs between AI agents.
Agent Handoff MCP gives Claude, Codex, local agents, and other MCP clients a shared inbox without giving one model control over another. Agents can send structured work, acknowledge it, report a blocker, complete it, or cancel work they originally queued. Every transition is attributable and retained in SQLite.
Multi-agent systems often pass work through chat transcripts, ad hoc files, or vendor-specific orchestration. That loses ownership, lifecycle state, authorization boundaries, and a durable audit trail. This server turns a handoff into a small protocol object:
sender -> queued -> accepted -> completed
| ^
v |
blocked --------+
sender may cancel only while queued
The server coordinates work; it does not execute agents, fetch references, read arbitrary files, or create autonomous agent loops.
| Tool | Purpose |
|---|---|
handoff_whoami | Show the authenticated identity, boundaries, and policy revision. |
handoff_send | Send a structured handoff to an authorized recipient. |
handoff_inbox | List handoffs addressed to the current identity. |
handoff_get | Read a handoff and its append-only event history. |
handoff_acknowledge | Accept queued or blocked work. |
handoff_update_status | Mark work blocked/completed, or cancel it while queued. |
send_to and receive_from authorization with no permissive defaultspublic-safe, internal, or restrictedThe package installs one dispatcher binary, agent-handoff-mcp, whose name matches the package so npx @sarutobi-sasuke/agent-handoff-mcp <command> resolves directly once the package is published to npm. (It is not published yet; use a source checkout until then.)
| Command | Purpose |
|---|---|
http | Start the shared Streamable HTTP server. |
stdio | Start a stdio server bound to HANDOFF_AGENT_ID. |
init --registry <path> | Create a starter registry with disabled synthetic identities. |
validate --registry <path> | Validate a registry without reading tokens or the database. |
issue --registry <path> --agent <id> --expires <iso8601> | Issue an expiring token, printed once to stdout. |
rotate ... | Replace an existing token; the old one stops working immediately. |
disable / enable | Toggle an identity across all transports. |
revoke | Remove an identity's token binding. |
token | Generate a token and digest without touching a registry. |
agent-handoff-http, agent-handoff-stdio, agent-handoff-token, and agent-handoff-validate are also installed as direct aliases.
Requirements: Node.js 22.13 or newer.
For a source checkout:
git clone https://github.com/SarutobiSasuke8/agent-handoff-mcp.git
cd agent-handoff-mcp
npm ci
npm run build
cp .env.example .env
node dist/src/cli.js init --registry ./config/agents.yaml
node dist/src/cli.
... [View full README on GitHub](https://github.com/sarutobisasuke8/agent-handoff-mcp#readme)