MCP server
Client setup
Cursor, STDIO
Edit ~/.cursor/mcp.json or the project MCP file:
{\n "mcpServers": {\n "puax": {\n "command": "npx",\n "args": ["puax-mcp-server", "--stdio"]\n }\n }\n}Streamable HTTP
{\n "mcpServers": {\n "puax": {\n "type": "streamable-http",\n "url": "http://127.0.0.1:2333/mcp"\n }\n }\n}After the server is up, doctor --fix can also write host hooks. That is what makes turn one tick without a manual tool call.
Families you will still see
| Family | Examples |
|---|---|
| Heartbeat / arena / dream | puax_tick puax_set_arena puax_enter_dreamscape |
| Gates | puax_check_diagnosis puax_confidence_check puax_verify_completion |
| Roles | recommend_role activate_with_context get_role_with_methodology |
| Session | puax_start_session puax_get_pressure_level puax_handle_breakthrough |
Code sample
# 最简单路径：一条龙激活 activate_with_context( context="用户说：为什么还是不行？已经试了三遍", autoActivate=true ) # → 检测触发 → 推荐角色 → 注入含 [PUAX-DIAGNOSIS] 的 System Prompt # 会话模式 puax_start_session(session_id="sess-1") puax_detect_trigger(session_id="sess-1", event_type="UserPromptSubmit", ...) puax_get_pressure_level(session_id="sess-1") puax_end_session(session_id="sess-1")