MCP tools

Handshake registers these tools with connected agents.

`checkpoint_session`

Stores the current native agent session.

string

required

Native session ID.

string

required

One of claude-code, codex, hermes, or opencode.

string

Title that replaces the native title.

string

Current state, validation results, problems, and ordered next actions.

string

Settled decisions, with one decision on each line.

`list_sessions`

Lists recent sessions. The tool imports applicable Codex sessions before it queries the database.

string

Optional filter. One of claude-code, codex, cursor, hermes, or opencode.

The structured result contains:

{
  "sessions": [
    {
      "id": "session-1",
      "title": "Fix authentication flow",
      "agent": "claude-code",
      "updated_at": "2026-07-25T14:30:00Z",
      "updated_relative": "5m ago",
      "working_directory": "/Users/alex/code/payments",
      "project_name": "payments",
      "project_id": "project-1"
    }
  ],
  "warnings": []
}

The readable fallback uses these columns:

Session | Agent | Updated | Directory | Project | ID

Warnings report complete or partial native-session import failures. A warning does not discard successful results.

`restore_session`

Restores an exact session ID or an unambiguous title.

string

required

Exact ID, exact title, or partial title.

boolean

Set to true after you review the restore packet.

When Git state is available, the first call returns a restore packet. The second call injects the handoff brief.

`generate_brief`

Creates a handoff brief without restoring the session.

string

required

Session title or part of the title.

`search_session`

Searches messages in one session.

string

required

Session title or part of the title.

string

required

Full-text search terms.

number

Maximum result count. The default is 5.

`search_all_sessions`

Searches messages in all stored sessions.

string

required

Full-text search terms.

number

Maximum result count. The default is 10.

string

Optional source-agent filter.

`get_project_knowledge_context`

Gets the project ID, facts revision, and document freshness.

string

required

Repository or project working directory.

`publish_project_knowledge`

Publishes one AI-authored project document for a current facts revision.

string

required

Project ID from get_project_knowledge_context.

string

required

project-brief or repo-map.

number

required

Facts revision used by the author.

string

required

Markdown body. Handshake adds provenance frontmatter.

string

Source session ID.

string

Source Git commit.

string

Short description of the factual records used.

Handshake rejects a stale facts_revision.

`get_handshake_update_status`

Reads the cached release-check result. The tool does not make a network request. This tool has no parameters.

Get started

Work with sessions

Manage project knowledge

Configuration

Connect agents

Reference

`checkpoint_session`

`list_sessions`

`restore_session`

`generate_brief`

`search_session`

`search_all_sessions`

`get_project_knowledge_context`

`publish_project_knowledge`

`get_handshake_update_status`

​checkpoint_session

​list_sessions

​restore_session

​generate_brief

​search_session

​search_all_sessions

​get_project_knowledge_context

​publish_project_knowledge

​get_handshake_update_status

`checkpoint_session`

`list_sessions`

`restore_session`

`generate_brief`

`search_session`

`search_all_sessions`

`get_project_knowledge_context`

`publish_project_knowledge`

`get_handshake_update_status`