Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HANDOFF_SERVER | No | Server connection mode: 'none' for standalone, or explicit server URL (e.g., 'http://localhost:3000'). Default is auto-discovery mode. | |
| HANDOFF_MAX_COUNT | No | Maximum number of handoffs | 100 |
| HANDOFF_PORT_RANGE | No | Port range for auto-discovery | 1099-1200 |
| HANDOFF_SERVER_TTL | No | Server auto-shutdown after inactivity in milliseconds (0 = disabled). Default is 24 hours. | 86400000 |
| HANDOFF_RETRY_COUNT | No | Auto-reconnect retry count | 30 |
| HANDOFF_MAX_KEY_LENGTH | No | Maximum key length | 100 |
| HANDOFF_RETRY_INTERVAL | No | Auto-reconnect interval in milliseconds | 10000 |
| HANDOFF_MAX_TITLE_LENGTH | No | Maximum title length | 200 |
| HANDOFF_MAX_SUMMARY_BYTES | No | Maximum summary size in bytes (default 10KB) | 10240 |
| HANDOFF_MAX_CONVERSATION_BYTES | No | Maximum conversation size in bytes (default 1MB) | 1048576 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| handoff_save | Save a conversation handoff for later retrieval. Use this to pass conversation context to another AI or project. Format Selection
Structured Template (for format="structured")Omit sections that don't apply. Add custom sections if needed. |
| handoff_list | List all saved handoffs with summaries. Returns lightweight metadata without full conversation content. Opens interactive UI if supported. |
| handoff_load | Load a specific handoff by key. Returns full conversation content. |
| handoff_clear | Clear handoffs. If key is provided, clears only that handoff. Otherwise clears all. |
| handoff_stats | Get storage statistics and current limits. Useful for monitoring usage. |
| handoff_restart | Restart the shared HTTP server. Useful when the server is in an unhealthy state. All stored handoffs will be lost (data is in-memory). |
| handoff_merge | Merge multiple handoffs into one. Combines conversations and metadata from related handoffs into a single unified handoff. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| ui://conversation-handoff/viewer.html |