English Français العربية

io.github.vinsenzo83/baton

Registre officiel Sécurité

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http baton 'https://baton-mcp-production.up.railway.app/mcp'
Configuration JSON (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
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "baton": {
            "command": "npx",
            "args": [
                "-y",
                "baton-mcp@0.2.0"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que io.github.vinsenzo83/baton ?

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

Comment installer io.github.vinsenzo83/baton ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http baton 'https://baton-mcp-production.up.railway.app/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.vinsenzo83/baton ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.vinsenzo83/baton est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient io.github.vinsenzo83/baton ?

Il est publié par vinsenzo83. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.