MCP serversh.handover/handover

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.

Read revision-anchored file comments, selected text, status, authorship, and resolution metadata. Use status=open to find feedback that still needs action.

Replace the open assignments with the supplied collaborator identities. This changes collaboration state, not the immutable handover revision.

Append a discussion comment and optionally notify explicitly mentioned collaborators.

Append an immutable revision after reading the current snapshot. expectedRevisionId is mandatory to prevent overwriting another collaborator's work. Omitted artifacts are inherited

Create durable shared context with an initial immutable revision. Authorship comes from the authenticated Handover identity.

Read a handover snapshot, continuation brief, artifact metadata, and revision history. Omit revisionId for the current snapshot.

Export a handover revision as an Open Knowledge Format bundle for another human or agent system.

Import Open Knowledge Format files into a new immutable Handover revision. Replaying the same bundle is idempotent.

Read the stable report URL, entry file, access mode, and selected revision for a handover.

Create or update a stable /r/{slug}/ report projection of a Handover revision.

Return the selected files of a published report with paths, hashes, media types, and UTF-8 or base64 content.

Read bounded artifact content after inspecting a handover. Text is returned as UTF-8 and binary content as base64; truncated results report that explicitly.

Find current shared context with hybrid, semantic, or lexical retrieval across metadata and artifact content. Use an empty query to list recent handovers.

Read comments, explicit mentions, assignments, and eligible collaborators without changing revision history.

Edit an authored comment, or resolve/reopen an annotation. Set resolvedRevisionId when a new handover revision addressed the feedback.

Return the authenticated person or service agent, organization, workspace, role, and granted scopes. Call this before reading or publishing to confirm attribution and tenancy.