Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HAPPY_SERVER_URL | No | Override the Happy server URL | https://happy.engineering |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| happy_list_sessions | List all Happy AI sessions. Returns session IDs, titles, paths, machines, and activity status. |
| happy_list_machines | List all machines registered with Happy. Returns machine IDs, hostnames, platforms, and activity status. |
| happy_list_recent_paths | List recently used folder paths for a machine. Useful for starting sessions in familiar locations. |
| happy_list_environment_sets | List available environment variable presets. These can be used when starting new sessions with happy_start_session. |
| happy_read_messages | Read recent messages from a Happy AI session. Use this to see the conversation history. |
| happy_send_message | Send a message to a Happy AI session to trigger it to work. The message will be sent with bypass permissions mode. |
| happy_start_session | Start a new Happy AI session on a machine. Use happy_list_machines to find available machines first. Use happy_list_environment_sets to see available environment presets. Optionally create a Git worktree for isolated development. |
| happy_archive_session | Archive (stop) a Happy AI session. The session will be terminated and marked as inactive. |
| happy_wait_for_idle | Wait for a Happy AI session to become idle (finish processing). Useful after sending a message to wait for AI to complete its work. |
| happy_zen_list_todos | List Zen (todo) items with titles, descriptions, and completion status. |
| happy_zen_create_todo | Create a new Zen (todo) item with a title and optional description. |
| happy_zen_update_todo | Update a Zen (todo) item title and/or description. |
| happy_zen_set_todo_done | Set or toggle a Zen (todo) item completion status. |
| happy_zen_delete_todo | Delete a Zen (todo) item. |
| happy_zen_link_session | Link a Zen (todo) item to a Happy session with a display title. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |