Skip to main content
Handshake uses Cursor MCP support and agent hooks.

​
Installed integration

handshake setup can install:
  • An MCP entry in ~/.cursor/mcp.json.
  • A Stop hook in ~/.cursor/hooks.json.
  • ~/.cursor/hooks/handshake_cursor_stop.py.
The Stop hook sends the completed turn to Handshake. If project knowledge is stale, the hook can request one follow-up authoring action. Cursor is not a supported unattended background writer.

​
Connect Cursor

1

Check Python

Make sure that Python 3 is on PATH.
2

Run setup

Run:
3

Restart Cursor

Close and open Cursor.
4

Verify the connection

Enter:
If Python 3 is not available, the MCP registration can still work but the Stop hook is not installed.