UNIHODL — Agent Handoff SDK & MCP Server

The handoff layer for the agentic web. Capture a human's working session — open tabs, scroll positions, video timestamps, and reasoning thread — and hand it to any AI agent as a signed, scoped, revocable Resume Token. Your agent picks up exactly where the human left off instead of starting cold.

This is the open-source SDK + MCP server + protocol spec. The browser extension, web app, and product live separately at unihodl.app.

# Zero-setup demo — no signup, sandbox key, real API:
npx -y @unihodl/mcp-server
#   env: UNIHODL_API_KEY=uh_test_sandbox_demo_key_v0
# then ask your agent:  resume ses_8f3aZ91b

What's here

Package	What it is	Install
@unihodl/mcp-server	MCP server — gives Claude Desktop, Cursor, Cline, etc. a resume tool	npx -y @unihodl/mcp-server
@unihodl/agent-sdk	TypeScript client — mint tokens, hydrate sessions	npm i @unihodl/agent-sdk
unihodl-agent	Python client	pip install unihodl-agent
RFC.md	The open Resume Token protocol spec	—

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "unihodl": {
      "command": "npx",
      "args": ["-y", "@unihodl/mcp-server"],
      "env": { "UNIHODL_API_KEY": "uh_test_sandbox_demo_key_v0" }
    }
  }
}

Restart Claude. The resume and list_sessions tools appear. Ask it to resume ses_8f3aZ91b and it receives the human's conclusions, open blockers, and intended next step — then continues the work.

Why it exists

Agent memory is well-funded, but it standardizes agent-generated memory. Nothing standardizes the human's live working context crossing into an agent — the 15 tabs, the half-formed decision, the thing you were about to do next. That handoff is the protocol. See RFC.md for the token design (EdDSA-signed, scope-filtered, TTL-capped, revocable, audited).

We're proposing Resume Tokens as an open standard — issues and PRs welcome. The goal is for every agent framework to accept a Resume Token, the way every framework now speaks MCP.

Get a live key

Free for 10,000 hydrations/month at unihodl.app/developers. Verify your key against the live API: https://www.unihodl.app/.well-known/jwks.json.

License

MIT — see LICENSE.