Happy Server MCP
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_sessionsB | List all Happy AI sessions. Returns session IDs, titles, paths, machines, and activity status. |
| happy_list_machinesA | List all machines registered with Happy. Returns machine IDs, hostnames, platforms, and activity status. |
| happy_list_recent_pathsB | List recently used folder paths for a machine. Useful for starting sessions in familiar locations. |
| happy_list_environment_setsA | List available environment variable presets. These can be used when starting new sessions with happy_start_session. |
| happy_read_messagesB | Read recent messages from a Happy AI session. Use this to see the conversation history. |
| happy_send_messageB | Send a message to a Happy AI session to trigger it to work. The message will be sent with bypass permissions mode. |
| happy_start_sessionA | 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_sessionA | Archive (stop) a Happy AI session. The session will be terminated and marked as inactive. |
| happy_wait_for_idleA | 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_todosB | List Zen (todo) items with titles, descriptions, and completion status. |
| happy_zen_create_todoC | Create a new Zen (todo) item with a title and optional description. |
| happy_zen_update_todoC | Update a Zen (todo) item title and/or description. |
| happy_zen_set_todo_doneC | Set or toggle a Zen (todo) item completion status. |
| happy_zen_delete_todoC | Delete a Zen (todo) item. |
| happy_zen_link_sessionC | 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 | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/zhigang1992/happy-server-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server