English Français العربية

io.github.vinsenzo83/baton

Official registry Security

Hand off AI work with a signed Verification Receipt — an independent verifier proves it runs.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http baton 'https://baton-mcp-production.up.railway.app/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "baton": {
            "type": "http",
            "url": "https://baton-mcp-production.up.railway.app/mcp"
        }
    }
}
NPM package baton-mcp
Claude Code 
claude mcp add baton -- npx -y baton-mcp@0.2.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "baton": {
            "command": "npx",
            "args": [
                "-y",
                "baton-mcp@0.2.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. 🏃 BATON
  2. Why this, and not the dozen orchestration tools?
  3. The receipt (the differentiator)
  4. Tools
  5. Design principles (from the security review)
  6. Run
  7. Storage
  8. License

🏃 BATON

Hand off AI work — with a receipt.

An AI did the work. How does the next person — or the next AI — know it actually works, not just that the build passed? BATON seals a unit of AI work into a portable capsule, and an independent verifier replays it and issues a server-signed Verification Receipt. The receiver trusts observed evidence, not a claim.

Never trust an agent handoff without a receipt.

BATON is a standard MCP (Model Context Protocol) server — any MCP-capable tool (Claude Code, Codex CLI, Gemini CLI, Cursor …) connects with one URL. The producer and the verifier can be different models, machines, and people.

Why this, and not the dozen orchestration tools?

Running Claude + Codex + Gemini together (swarms, rooms, agent messaging) is a crowded space. BATON isn't that. The one thing almost nobody does: bind the handoff artifact to independent execution evidence as a single, forgeable-proof trust unit. That's the receipt.

Claude did the work
   ↓  baton_pass  → sealed capsule (BTN-H-…)
Codex / a teammate receives it
   ↓  baton_verify → replay in a clean env, observe the real flow
   ↓
🕸️ VERIFIED — signed receipt: who verified · what was observed · in what env · with what artifacts
   ↓
trust  (or reject)

The real buyer isn't "me switching Claude→Codex" (just re-read the repo). It's outsourcer→in-house, leaver→joiner, KO team→US team — where "an AI made this, does it really work?" is a question worth paying to answer.

The receipt (the differentiator)

baton_verify doesn't return a ✅ sticker. It returns a signed record:

{
  "kind": "baton.verification-receipt/v1",
  "capsule": "BTN-H-…",              // the handoff this verifies
  "verifier": "receiver-spider",    // WHO verified — independent of the producer
  "environment": { "os": "ubuntu-24.04", "node": "24.2" },
  "observed": [{ "claim": "payment succeeds", "observed": true,
                 "detail": "POST /pay 200 + order row +1" }],
  "artifacts": ["playwright.trace.zip", "network.har"],
  "verdict": "verified",
  "signature": "…hmac-sha256…"       // server-signed → tamper the verdict, break the sig
}

Flip verdict to "verified" without re-signing and the badge is refused. A passing build never earns verified on its own — only observed E2E does (this is what catches a silent upsert that returns 200 but writes nothing).

Tools

GroupToolsWhat it does
Handoffbaton_pass baton_receive baton_diff baton_revokeSeal a work capsule into a code (BTN-H-…), hand it over, diff versions. Body encrypted with a code-derived key — the server never sees plaintext
Verifybaton_verify baton_verify_plan baton_consolidate + spider_* ×6Independent verifier replays and issues the signed receipt (no observation, no 🕸️); consolidate gathers many handoffs into one result board by trust tier
Team rooms (supporting)baton_create_room baton_new_invite baton_join baton_send baton_inbox baton_who baton_leave baton_kick baton_approve baton_close_roomA persistent room the owner manages; people enter via rotating invite codes (BTN-R-…, 72h, re-issuable). Owner can kick, approve (optional gate), close. After join, activity is keyed by member_id
Operationsbaton_task_* baton_git_* baton_cost_*Cycle-safe private task DAG, Git commit/diff/test evidence binding, and idempotent provider/model/task cost ledger

Operations dashboard: /ops.html. It stores only task metadata, Git evidence, and cost facts; BATON never asks for repository credentials.

Network dashboard: /network.html. Shared Memory encrypts bodies under the account key and searches metadata only. MCP Hub rejects credential-bearing URLs. Marketplace reputation accepts only independent, server-signed VERIFIED receipts.

모든 공개 화면은 한국어를 기본으로 제공하며 /dash.html(협업방), /board.html(검증 결과), /ops.html(작업·Git·비용), /network.html(기억·MCP·에이전트)을 상호 연결한다.

Design principles (from the security review)

  • Code-derived encryption. The server stores only ciphertext + code_hash. Without the code, even the operator can't read the plaintext — the proof of "we can't lock you in."
  • Signed receipts. Verdicts are HMAC-signed server-side (BATON_RECEIPT_SECRET); no client can forge verified.
  • Prompt-injection containment. Inbound capsules/messages are returned fenced as untrusted data; secrets are auto-masked before storage.
  • Codes are ≥128-bit secrets, one-time codes redeem atomically, alias-spoofing blocked.
  • A passing build ≠ working behavior. verified requires observed side effects, never static analysis alone.

Run

npm install
npm test                                      # 15/15 E2E groups pass
node src/server.js                            # stdio (local / any CLI)
BATON_HTTP=1 PORT=8080 node src/server.js      # remote Streamable HTTP
Register (remote)
claude mcp add --transport http baton https://baton-mcp-production.up.railway.app/mcp

Billing/gating is off by default (dogfooding phase). Set BATON_BILLING=on to re-enable quotas. See USAGE.md for the full guide.

Storage

MVP uses SQLite (better-sqlite3) — self-host single binary. The hosted service drops a Postgres adapter into the narrow interface in src/store.js.

License

MIT

Frequently asked questions

What is io.github.vinsenzo83/baton?

Hand off AI work with a signed Verification Receipt — an independent verifier proves it runs.

How do I install io.github.vinsenzo83/baton?

It runs as a remote server. In Claude Code: claude mcp add --transport http baton 'https://baton-mcp-production.up.railway.app/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.vinsenzo83/baton need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.vinsenzo83/baton open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.vinsenzo83/baton?

It is published by vinsenzo83. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.