Shared, versioned context that humans and AI agents can publish, review, annotate, and continue.
sh.handover/handover MCP Server
This MCP server provides “Shared, versioned context” that humans and AI agents can publish, review, annotate, and continue. It is intended to move active work between Claude Code, Codex, Cursor, Gemini CLI, people, and service agents without losing decisions, files, history, or authorship.
🛠️ Key Features
Shared, versioned context
Publish, review, annotate, and continue workflows
Preserves decisions, files, history, and authorship
MCP server with 17 tools
🚀 Use Cases
Handover active work across Claude Code, Codex, Cursor, and Gemini CLI
Human-in-the-loop review and continuation of agent work
Context engineering for agent handoff scenarios
⚡ Developer Benefits
Supports shared-context workflows across multiple tools and agent types
Uses MCP / Model Context Protocol integration
Aligned with agent skills for Claude, Codex, Cursor, and Gemini CLI
⚠️ Limitations
Documentation excerpt does not specify setup, authentication, or API/tool details beyond the stated capabilities
Return the authenticated person or service agent, organization, workspace, role, and granted scopes. Call this before reading or publishing to confirm attribution and tenancy.
Find current shared context with hybrid, semantic, or lexical retrieval across metadata and artifact content. Use an empty query to list recent handovers.
Read a handover snapshot, continuation brief, artifact metadata, and revision history. Omit revisionId for the current snapshot.
Parameters2
handoverId
string
required
Handover identifier returned by handover.search or handover.create.
revisionId
string
optional
Optional immutable revision; omit to inspect the current revision.
Raw schema
{
"type": "object",
"properties": {
"handoverId": {
"type": "string",
"pattern": "^hov_",
"description": "Handover identifier returned by handover.search or handover.create."
},
"revisionId": {
"type": "string",
"pattern": "^rev_",
"description": "Optional immutable revision; omit to inspect the current revision."
}
},
"required": [
"handoverId"
],
"additionalProperties": false
}
handover.read_artifact
Read bounded artifact content after inspecting a handover. Text is returned as UTF-8 and binary content as base64; truncated results report that explicitly.
Parameters2
artifactId
string
required
Artifact identifier returned by handover.get.
maxBytes
integer
optional
Maximum decoded bytes to return before reporting truncation.
Read comments, explicit mentions, assignments, and eligible collaborators without changing revision history.
Parameters1
handoverId
string
required
Handover whose discussion and assignments should be read.
Raw schema
{
"type": "object",
"properties": {
"handoverId": {
"type": "string",
"pattern": "^hov_",
"description": "Handover whose discussion and assignments should be read."
}
},
"required": [
"handoverId"
],
"additionalProperties": false
}
handover.annotations
Read revision-anchored file comments, selected text, status, authorship, and resolution metadata. Use status=open to find feedback that still needs action.
Create durable shared context with an initial immutable revision. Authorship comes from the authenticated Handover identity.
Parameters5
title
string
required
Short, specific name for the durable context.
summary
string
optional
Concise explanation of what this handover contains.
note
string
optional
Free-form continuation note recorded in the initial revision.
brief
object
optional
Structured continuation brief for humans and agents.
artifacts
array
optional
Files attached to the initial immutable revision.
Raw schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 200,
"description": "Short, specific name for the durable context."
},
"summary": {
"type": "string",
"maxLength": 2000,
"description": "Concise explanation of what this handover contains."
},
"note": {
"type": "string",
"minLength": 1,
"description": "Free-form continuation note recorded in the initial revision."
},
"brief": {
"type": "object",
"additionalProperties": false,
"minProperties": 1,
"properties": {
"objective": {
"type": "string",
"description": "The outcome the next human or agent should continue toward."
},
"currentState": {
"type": "string",
"description": "Verified state at the moment this revision is published."
},
"decisions": {
"type": "array",
"description": "Decisions already made that successors should preserve.",
"items": {
"type": "string"
},
"maxItems": 50
},
"openQuestions": {
"type": "array",
"description": "Unresolved questions that still require evidence or judgment.",
"items": {
"type": "string"
},
"maxItems": 50
},
"nextSteps": {
"type": "array",
"description": "Concrete continuation steps for the receiving actor.",
"maxItems": 50,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"description": "Optional stable identifier for this step."
},
"text": {
"type": "string",
"description": "One actionable continuation step."
},
"status": {
"type": "string",
"enum": [
"open",
"done"
],
"description": "Whether the step still needs action."
}
},
"required": [
"text"
]
}
}
},
"description": "Structured continuation brief for humans and agents."
},
"artifacts": {
"type": "array",
"description": "Files attached to the initial immutable revision.",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"description": "Filename shown in Handover."
},
"mediaType": {
"type": "string",
"description": "IANA media type, such as text/markdown or text/x-sql."
},
"content": {
"type": "string",
"description": "UTF-8 text, or base64 when encoding is base64."
},
"encoding": {
"type": "string",
"enum": [
"utf-8",
"base64"
],
"default": "utf-8"
}
},
"required": [
"name",
"content"
]
},
"minItems": 1,
"maxItems": 50
}
},
"required": [
"title"
],
"additionalProperties": false,
"anyOf": [
{
"required": [
"note"
]
},
{
"required": [
"brief"
]
},
{
"required": [
"artifacts"
]
}
]
}
handover.continue
Append an immutable revision after reading the current snapshot. expectedRevisionId is mandatory to prevent overwriting another collaborator's work. Omitted artifacts are inherited; matching names are replaced.
Parameters5
handoverId
string
required
Handover to continue after reading its current snapshot.
expectedRevisionId
string
required
Current revision ID returned by handover.get; prevents lost updates.
note
string
optional
What changed or what the next collaborator should know.
brief
object
optional
Updated structured continuation brief.
artifacts
array
optional
New or replacement files; omitted files remain inherited.
Raw schema
{
"type": "object",
"properties": {
"handoverId": {
"type": "string",
"pattern": "^hov_",
"description": "Handover to continue after reading its current snapshot."
},
"expectedRevisionId": {
"type": "string",
"pattern": "^rev_",
"description": "Current revision ID returned by handover.get; prevents lost updates."
},
"note": {
"type": "string",
"minLength": 1,
"description": "What changed or what the next collaborator should know."
},
"brief": {
"type": "object",
"additionalProperties": false,
"minProperties": 1,
"properties": {
"objective": {
"type": "string",
"description": "The outcome the next human or agent should continue toward."
},
"currentState": {
"type": "string",
"description": "Verified state at the moment this revision is published."
},
"decisions": {
"type": "array",
"description": "Decisions already made that successors should preserve.",
"items": {
"type": "string"
},
"maxItems": 50
},
"openQuestions": {
"type": "array",
"description": "Unresolved questions that still require evidence or judgment.",
"items": {
"type": "string"
},
"maxItems": 50
},
"nextSteps": {
"type": "array",
"description": "Concrete continuation steps for the receiving actor.",
"maxItems": 50,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"description": "Optional stable identifier for this step."
},
"text": {
"type": "string",
"description": "One actionable continuation step."
},
"status": {
"type": "string",
"enum": [
"open",
"done"
],
"description": "Whether the step still needs action."
}
},
"required": [
"text"
]
}
}
},
"description": "Updated structured continuation brief."
},
"artifacts": {
"type": "array",
"description": "New or replacement files; omitted files remain inherited.",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"description": "Filename shown in Handover."
},
"mediaType": {
"type": "string",
"description": "IANA media type, such as text/markdown or text/x-sql."
},
"content": {
"type": "string",
"description": "UTF-8 text, or base64 when encoding is base64."
},
"encoding": {
"type": "string",
"enum": [
"utf-8",
"base64"
],
"default": "utf-8"
}
},
"required": [
"name",
"content"
]
},
"minItems": 1,
"maxItems": 50
}
},
"required": [
"handoverId",
"expectedRevisionId"
],
"additionalProperties": false,
"anyOf": [
{
"required": [
"note"
]
},
{
"required": [
"brief"
]
},
{
"required": [
"artifacts"
]
}
]
}
handover.comment
Append a discussion comment and optionally notify explicitly mentioned collaborators.
Parameters3
handoverId
string
required
Handover discussion to append the comment to.
body
string
required
Comment body in plain text or Markdown.
mentionPrincipalIds
array
optional
Collaborator principal IDs to mention and notify.
Raw schema
{
"type": "object",
"properties": {
"handoverId": {
"type": "string",
"pattern": "^hov_",
"description": "Handover discussion to append the comment to."
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 10000,
"description": "Comment body in plain text or Markdown."
},
"mentionPrincipalIds": {
"type": "array",
"description": "Collaborator principal IDs to mention and notify.",
"maxItems": 20,
"items": {
"type": "string",
"pattern": "^prn_"
}
}
},
"required": [
"handoverId",
"body"
],
"additionalProperties": false
}
handover.annotate
Add a durable comment anchored to selected text or lines in an immutable artifact revision. Read the artifact first and preserve the exact quote and surrounding context.
Parameters4
handoverId
string
required
Handover containing the artifact being annotated.
body
string
required
Actionable annotation body in plain text or Markdown.
target
object
required
Immutable artifact location to anchor this annotation.
mentionPrincipalIds
array
optional
Collaborator principal IDs to mention and notify.
Raw schema
{
"type": "object",
"properties": {
"handoverId": {
"type": "string",
"pattern": "^hov_",
"description": "Handover containing the artifact being annotated."
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 10000,
"description": "Actionable annotation body in plain text or Markdown."
},
"target": {
"type": "object",
"additionalProperties": false,
"properties": {
"revisionId": {
"type": "string",
"pattern": "^rev_",
"description": "Immutable revision containing the annotated artifact."
},
"artifactId": {
"type": "string",
"pattern": "^art_",
"description": "Artifact containing the selected text or code."
},
"targetKind": {
"type": "string",
"enum": [
"text",
"code",
"html"
],
"description": "Rendering context used to relocate and display the annotation."
},
"selector": {
"type": "object",
"additionalProperties": false,
"properties": {
"exact": {
"type": "string",
"minLength": 1,
"maxLength": 4000,
"description": "The exact selected text."
},
"prefix": {
"type": "string",
"maxLength": 500,
"description": "Text immediately before the selection."
},
"suffix": {
"type": "string",
"maxLength": 500,
"description": "Text immediately after the selection."
},
"startOffset": {
"type": "integer",
"minimum": 0,
"description": "Zero-based character offset where the selection starts."
},
"endOffset": {
"type": "integer",
"minimum": 0,
"description": "Zero-based character offset immediately after the selection."
},
"startLine": {
"type": "integer",
"minimum": 0,
"description": "Zero-based line where the selection starts."
},
"endLine": {
"type": "integer",
"minimum": 0,
"description": "Zero-based line where the selection ends."
}
},
"required": [
"exact"
],
"description": "Exact quote plus optional position and surrounding context."
}
},
"required": [
"revisionId",
"artifactId",
"targetKind",
"selector"
],
"description": "Immutable artifact location to anchor this annotation."
},
"mentionPrincipalIds": {
"type": "array",
"description": "Collaborator principal IDs to mention and notify.",
"maxItems": 20,
"items": {
"type": "string",
"pattern": "^prn_"
}
}
},
"required": [
"handoverId",
"body",
"target"
],
"additionalProperties": false
}
handover.update_comment
Edit an authored comment, or resolve/reopen an annotation. Set resolvedRevisionId when a new handover revision addressed the feedback.
Parameters7
handoverId
string
required
Handover containing the comment.
commentId
string
required
Comment or annotation to edit, resolve, or reopen.
body
string
optional
Replacement comment body; omit to preserve the current body.
target
any
optional
Replacement annotation target, or null to remove the anchor.
mentionPrincipalIds
array
optional
Replacement collaborator mentions.
status
string
optional
Open, resolve, or reopen the feedback thread.
resolvedRevisionId
any
optional
Revision that addressed the feedback, or null when reopening.
Raw schema
{
"type": "object",
"properties": {
"handoverId": {
"type": "string",
"pattern": "^hov_",
"description": "Handover containing the comment."
},
"commentId": {
"type": "string",
"pattern": "^cmt_",
"description": "Comment or annotation to edit, resolve, or reopen."
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 10000,
"description": "Replacement comment body; omit to preserve the current body."
},
"target": {
"anyOf": [
{
"type": "object",
"additionalProperties": false,
"properties": {
"revisionId": {
"type": "string",
"pattern": "^rev_",
"description": "Immutable revision containing the annotated artifact."
},
"artifactId": {
"type": "string",
"pattern": "^art_",
"description": "Artifact containing the selected text or code."
},
"targetKind": {
"type": "string",
"enum": [
"text",
"code",
"html"
],
"description": "Rendering context used to relocate and display the annotation."
},
"selector": {
"type": "object",
"additionalProperties": false,
"properties": {
"exact": {
"type": "string",
"minLength": 1,
"maxLength": 4000,
"description": "The exact selected text."
},
"prefix": {
"type": "string",
"maxLength": 500,
"description": "Text immediately before the selection."
},
"suffix": {
"type": "string",
"maxLength": 500,
"description": "Text immediately after the selection."
},
"startOffset": {
"type": "integer",
"minimum": 0,
"description": "Zero-based character offset where the selection starts."
},
"endOffset": {
"type": "integer",
"minimum": 0,
"description": "Zero-based character offset immediately after the selection."
},
"startLine": {
"type": "integer",
"minimum": 0,
"description": "Zero-based line where the selection starts."
},
"endLine": {
"type": "integer",
"minimum": 0,
"description": "Zero-based line where the selection ends."
}
},
"required": [
"exact"
],
"description": "Exact quote plus optional position and surrounding context."
}
},
"required": [
"revisionId",
"artifactId",
"targetKind",
"selector"
]
},
{
"type": "null"
}
],
"description": "Replacement annotation target, or null to remove the anchor."
},
"mentionPrincipalIds": {
"type": "array",
"description": "Replacement collaborator mentions.",
"maxItems": 20,
"items": {
"type": "string",
"pattern": "^prn_"
}
},
"status": {
"type": "string",
"enum": [
"open",
"resolved"
],
"description": "Open, resolve, or reopen the feedback thread."
},
"resolvedRevisionId": {
"anyOf": [
{
"type": "string",
"pattern": "^rev_"
},
{
"type": "null"
}
],
"description": "Revision that addressed the feedback, or null when reopening."
}
},
"required": [
"handoverId",
"commentId"
],
"additionalProperties": false,
"minProperties": 3
}
handover.assign
Replace the open assignments with the supplied collaborator identities. This changes collaboration state, not the immutable handover revision.
Parameters2
handoverId
string
required
Handover whose open assignments will be replaced.
principalIds
array
required
Complete replacement list of assigned collaborator principal IDs.
Raw schema
{
"type": "object",
"properties": {
"handoverId": {
"type": "string",
"pattern": "^hov_",
"description": "Handover whose open assignments will be replaced."
},
"principalIds": {
"type": "array",
"description": "Complete replacement list of assigned collaborator principal IDs.",
"maxItems": 20,
"items": {
"type": "string",
"pattern": "^prn_"
}
}
},
"required": [
"handoverId",
"principalIds"
],
"additionalProperties": false
}
handover.publish
Create or update a stable /r/{slug}/ report projection of a Handover revision.
Parameters6
handoverId
string
required
Handover to project as a stable report.
slug
string
optional
Stable URL slug; generated from the title when omitted.
entryPath
string
optional
Artifact path opened first when readers visit the report.
access
string
optional
Who can open the report URL.
revisionMode
string
optional
Follow new revisions automatically or keep one revision pinned.
revisionId
string
optional
Revision to pin; used when revisionMode is pinned.
Raw schema
{
"type": "object",
"properties": {
"handoverId": {
"type": "string",
"pattern": "^hov_",
"description": "Handover to project as a stable report."
},
"slug": {
"type": "string",
"description": "Stable URL slug; generated from the title when omitted."
},
"entryPath": {
"type": "string",
"description": "Artifact path opened first when readers visit the report."
},
"access": {
"type": "string",
"enum": [
"organization",
"public"
],
"description": "Who can open the report URL."
},
"revisionMode": {
"type": "string",
"enum": [
"latest",
"pinned"
],
"description": "Follow new revisions automatically or keep one revision pinned."
},
"revisionId": {
"type": "string",
"pattern": "^rev_",
"description": "Revision to pin; used when revisionMode is pinned."
}
},
"required": [
"handoverId"
],
"additionalProperties": false
}
handover.publication
Read the stable report URL, entry file, access mode, and selected revision for a handover.
Handover
provides shared, versioned context for humans and AI agents through a hosted
Model Context Protocol server, a dependency-free CLI, and eight open Agent
Skills. This repository is the public source, discovery, installation, and
connection record for those interfaces.
Research and evidence
The Handover research and evidence
index
collects the open continuity benchmark, Reporter migration field report,
Handoff Continuity Record, and runnable continuation demo. Findings stay beside
their methods, source artifacts, first-party relationship, and material
limitations.
The versioned research/v1/ package gives agents and
researchers a stable JSON index, JSON Schema, citation metadata, and a bounded
Markdown summary. The package is a first-party publication by Handover and
44pixels; it is designed for inspection and reuse, not presented as independent
validation.
The public continuation
demo
shows the same workflow from both sides: an interactive human view and an
agent-readable record. It includes Markdown, SQL, JSON, a visual artifact,
three attributable revisions, a human review note, and the next agent's
resolution. No account is required.
The AI handoff prompt
generator
turns unfinished work into separate capture and receiver prompts without
requiring an account. Draft fields stay inside the browser tab and are not sent
to analytics or stored as a server-side draft.
The receiver prompt requires the next actor to inspect the evidence, separate
verified and unverified state, identify blockers, and state one bounded next
action before continuing. Copy or download the Markdown record, or carry the
same private draft into a prefilled first handover.
Codex's built-in import is the right first choice for a one-time move of
supported Claude Code setup, projects, memories, and recent chats. Use
Handover when Claude Code and Codex will alternate on unfinished work and need
shared artifacts, separate identities, review, and revision history.
The Claude Code to Codex transfer
recipe contains the exact
sender checkpoint, two-host service-credential setup, receiver verification,
optimistic-concurrency continuation, revocation test, and pass criteria. The
rendered
guide
explains when to use native import and when to use a durable handoff.
Run the reviewed MCP handoff
The demo shows the finished record. The
end-to-end MCP handoff procedure
tests the workflow itself across separate authenticated identities:
verify the publisher;
publish Markdown, SQL, and JSON;
read every artifact back;
review exact evidence from another identity;
publish a correction with optimistic concurrency;
resolve the finding against the correcting revision; and
prove a fresh successor can continue without the original chat.
It also exercises denied, read-only, stale-revision, and revoked-credential
paths. Use the rendered
guide
for the rationale, or connect an agent through the
install flow
before running the repository procedure.
Use the AI agent handoff checklist
For a smaller local handoff, start with the
Markdown checklist. It captures the objective,
current state, decisions, evidence, constraints, next action, and ownership,
then requires the receiving actor to read the current revision, open the
evidence, reproduce one meaningful result, and mark the handoff as passed or
blocked.
The rendered checklist and
FAQ
explains each verification step. The raw template works without Handover; use
the hosted service when multiple actors need authenticated access, immutable
revisions, search, annotations, or auditable ownership.
Test company AI context readiness
Before connecting company knowledge to several people and agents, use the
company AI context readiness checklist.
It separates approved source knowledge from changing continuation records,
inventories human and service identities, declares company and workspace
boundaries, and finishes with a two-person, two-agent pilot.
The pilot is intentionally stricter than an import count: it verifies
authorized retrieval, attributable revisions, human review, denied searches,
agent revocation, and fresh-session continuation. The
source-linked architecture
guide
explains why a search index, private model memory, and canonical company
records have different responsibilities.
Use the open handoff format
The Handoff Continuity
Record
is a platform-neutral JSON format for the state another human or AI agent needs
to verify and continue work. It records the objective, verified and unverified
state, decisions, evidence, constraints, next action, ownership, and open
review without prescribing transport, routing, authentication, or storage.
MCP can expose the tools used to read and write the record. A2A or an
orchestration framework can route it. Git or Handover can store it.
Connect
The canonical Streamable HTTP endpoint is:
text
https://handover.sh/api/mcp?profile=core
The recommended core profile exposes 17 tools for everyday identity, search,
retrieval, review, continuation, publishing, and portability workflows. Use
https://handover.sh/api/mcp?profile=native for all 27 first-party Handover
operations. The unparameterized https://handover.sh/api/mcp endpoint retains
all 55 tools and Reporter aliases for existing integrations.
The endpoint exposes its MCP handshake and tool schemas without an account so
clients and directories can verify compatibility before connecting. Tool calls
remain protected and return Handover's OAuth resource challenge when no valid
human or service credential is present.
Interactive MCP hosts use Handover's first-party OAuth flow: standard discovery,
dynamic client registration, PKCE, short-lived access tokens, and rotating
refresh tokens. The host opens Handover in a browser; sign in as yourself,
review the requested permissions, and approve the connection. Handover records
your human identity on every attributable action.
Unattended runners and hosts without OAuth support use a separately named,
scoped service credential created under Workspace or Company -> Agents.
Human and service identities remain independently attributable and revocable.
For the complete setup, identity check, two-agent continuity test, and
troubleshooting flow, see CONNECTING.md.
Choose Remote (HTTP) and Static headers, then enter the scoped service
agent credential in Cline's private header prompt. The agent-readable
llms-install.md includes the exact configuration, identity
check, safe first write, two-agent continuation test, and revocation procedure.
Use the first-party Cline setup
page
for the complete Handover flow. Do not paste a real credential into chat or
commit Cline's private MCP settings.
Command-line client
The dependency-free Handover CLI supports the same durable workflow from a
terminal:
The published package source and metadata live in cli/. The audited
direct installer remains available when npm is not appropriate:
bash
curl -fsSL https://handover.sh/install.sh | sh
Package releases are built from this public repository. The bootstrap and
trusted-publishing process is documented in RELEASING.md.
handover doctor is a read-only connection check. It verifies the configured
endpoint, server-resolved identity, workspace, role, scopes, and one protected
context request without printing the credential or changing a handover. Use
the complete verification checklist
before an agent's first write.
Agent Skills
Install reusable Handover workflows into a compatible coding agent with the
open Agent Skills format:
The public collection includes a local-first session handoff, skills for
creating and validating machine-readable records, verifying connections,
publishing context, resuming work,
reviewing revision-anchored feedback, testing complete multi-identity
continuity, and governing agent access. Browse the
catalog at skills.handover.sh or inspect the
source in skills/. The collection is also indexed in the
Skills.sh directory.
The catalog organizes skills by handoff phase, includes a plain-language
starting request for each workflow, and exposes the exact MCP tools and CLI
commands through its machine-readable
index.
The Agent Skills and MCP
guide
explains the boundary between portable workflow instructions and authenticated
runtime capabilities. Its raw end-to-end
workflow
is designed for direct agent retrieval.
To publish a workflow that uses Handover, start with the
Agent Skill developer
kit,
the contributor contract, and the
starter skill. Copy the starter
into a new skills/<name>/SKILL.md; the template deliberately does not use the
reserved filename so registries cannot mistake it for an installable skill.
Community submissions keep
their publisher and source attribution; catalog inclusion does not widen
Handover access or replace source review.
Validate the local contract before testing the authenticated workflow:
Passing this validator proves the file contract, not host discovery, MCP
authentication, permissions, read-back, or denied behavior. The developer kit
keeps those runtime checks explicit.
Open continuity benchmark
The AI Handoff Continuity
Benchmark
tests whether a successor model can recover the objective, current state,
decisions, evidence, constraints, next action, owner, and open questions from
a transcript, compressed memory, or structured handoff.
The first two-system pilot scored structured handoffs at 79.45, conversation
transcripts at 76.67, and compressed memory at 45.00. It is a small authored
pilot rather than a model leaderboard. The public benchmark/
directory contains the dataset, answer key, dependency-free scorer, strict
submissions, deterministic results, limitations, and all 18 raw response
bodies. Reuse the published
CITATION.cff,
citation.bib, or flat
summary.csv instead of
transcribing values from the page.
bash
cd benchmark/v1
node run.mjs --validate-scorer
node run.mjs --prompts ./prompts
What agents can do
Connected agents can:
verify the active identity, organization, workspace, and scopes with
handover.whoami;
search company or personal context;
inspect an exact immutable revision;
read attached Markdown, HTML, SQL, JSON, code, images, and other files;
retrieve discussions and revision-anchored annotations;
create a new handover or continue an existing one;
add, edit, resolve, and respond to review comments;
preserve the authenticated human or service identity in the audit history.
The server never asks an agent to provide an author identity in tool input.
Authorship comes from the authenticated credential.
Verify the connection
Ask the connected host to perform these calls before real work:
Call handover.whoami with no arguments and confirm the returned person or
named service agent, organization, workspace, role, and scopes.
Call handover.search with { "query": "" } and confirm it returns only
context that identity should be able to access.
Read one known handover and artifact before creating or continuing work.
A working connection lists Handover's tools without a JSON or sign-in error,
preserves the intended identity as author, and immediately stops working after
the OAuth grant or service credential is revoked.
Service agents
Workspace owners create service agents in Handover and grant only the scopes
that actor needs. Store the credential in HANDOVER_TOKEN; do not put it in a
repository or MCP configuration committed to source control.
The hosted Handover application source is maintained in a private repository.
This public repository contains the MCP connection record, setup documentation,
and the source of the dependency-free CLI, not the hosted service
implementation.
Report connection or documentation problems through
GitHub Issues. Report
security concerns using the process in SECURITY.md.