@gethmy/mcp 2.22.0 → 2.24.0

package/README.md

@@ -1,12 +1,12 @@
 # @gethmy/mcp
 
-MCP (Model Context Protocol) server for [Harmony](https://gethmy.com).
-Enables AI coding agents (Claude Code, OpenAI Codex, Cursor) to interact with your Harmony boards.
+MCP (Model Context Protocol) server for [Harmony](https://gethmy.com), the shared surface for human–agent teams.
+Claude Code, OpenAI Codex, Cursor, and any MCP client claim cards, report progress, and move work on your board.
 
 ## Features
 
-- **71 MCP Tools** for full board control, knowledge graph, and workflow plans
-- **7 Global Skills** — `/hmy`, `/hmy-plan`, `/hmy-cleanup`, `/hmy-standup`, `/hmy-memory-prune`, `/hmy-upgrade`, `/hmy-review`, served from the DB-backed [skill hub](../../docs/skills.md) with auto-update and admin-managed versioning
+- **78 MCP Tools** for full board control, knowledge graph, and workflow plans
+- **Global Skills** — installable in one command, served from the DB-backed [skill hub](../../docs/skills.md) with auto-update and admin-managed versioning
 - **Knowledge Graph Memory** — Phase 1 surface: hybrid retrieval (vector + lexical + RRF), session-scoped working memory, activity feed. See [docs/memory.md](../../docs/memory.md)
 - **GSD Workflow Plans** - plan/execute/verify/done lifecycle with auto card creation
 - **Card Linking** - create relationships between cards (blocks, relates_to, duplicates, is_part_of)
@@ -16,7 +16,7 @@ Enables AI coding agents (Claude Code, OpenAI Codex, Cursor) to interact with yo
 - **Auto-Assignment** - automatically assign cards to you when starting agent sessions
 - **Memory Sync** - bidirectional sync between local markdown files and remote database
 - **Multi-Agent Support** - works with Claude Code, Codex, Cursor, Claude.ai
-- **Smart Setup** - one command configures everything
+- **One-Command Setup** - one command configures everything
 - **Browser Sign-In** - secure OAuth setup (loopback + PKCE), no key to copy or paste; API keys still supported for CI
 
 ## Prerequisites
@@ -32,7 +32,7 @@ Enables AI coding agents (Claude Code, OpenAI Codex, Cursor) to interact with yo
 npx @gethmy/mcp setup
 ```
 
-The smart setup wizard will:
+The setup wizard will:
 
 - Sign you in through your browser (OAuth — no API key to copy or paste). You can also create a free account or paste an existing key from the same prompt.
 - Detect installed AI agents (Claude Code, Cursor, Codex)
@@ -89,7 +89,7 @@ If you prefer to configure manually (e.g., in Claude.ai's UI):
 1. Get an API key from [Harmony](https://gethmy.com/user/keys)
 2. In Claude.ai, add a remote MCP server with URL `https://mcp.gethmy.com/mcp`
 3. Set the Authorization header to `Bearer hmy_your_key_here`
-4. All 70 Harmony tools become available in your conversation
+4. All 78 Harmony tools become available in your conversation
 
 **Session management** is automatic - sessions have a 1-hour TTL and are created/renewed transparently.
 
@@ -110,7 +110,7 @@ It detects your existing configuration and only asks for the project context.
 
 ```bash
 # Setup (recommended) — authorizes in your browser, no API key handling
-npx @gethmy/mcp setup              # Smart setup wizard
+npx @gethmy/mcp setup              # Setup wizard
 
 # Setup with flags (non-interactive)
 npx @gethmy/mcp setup --global --workspace ID --project ID
@@ -150,9 +150,9 @@ npx @gethmy/mcp serve              # Start MCP server
 
 ## Skills
 
-Seven global skills ship with the MCP server and are installed automatically by `npx @gethmy/mcp setup`. They live in the `skill_resource` Postgres table, are fetched via `GET /v1/skills/<name>`, and render-time composed with a shared auto-update preamble.
+Global skills ship with the MCP server and are installed automatically by `npx @gethmy/mcp setup`. They live in the `skill_resource` Postgres table, are fetched via `GET /v1/skills/<name>`, and render-time composed.
 
-For the full skill hub architecture (storage, versioning, auto-update, admin management), see [docs/skills.md](../../docs/skills.md).
+For the full skill list and the hub architecture (storage, versioning, auto-update, admin management), see [docs/skills.md](../../docs/skills.md).
 
 ### `/hmy` — Card Workflow
 
@@ -200,7 +200,7 @@ Generates a structured standup summary: what shipped, what's in progress, what's
 
 ### Auto-Update
 
-Every skill ships with an `hmy-update-check` preamble that fires on invocation. It compares local versions against `/v1/skills/version` and prompts (or silently auto-installs, if `~/.hmy/config.yaml` has `auto_upgrade: true`). Snooze levels: 24h / 48h / 7d.
+The server owns auto-update. `refreshSkills()` runs at `serve` startup, calls `GET /v1/skills/version` at most once per 24h, and atomically rewrites only the installed skill files that are behind. Two knobs live in `~/.hmy/config.yaml`: `update_check` (master switch) and `pin` (freeze on the installed version).
 
 ## Available Tools
 
@@ -296,7 +296,7 @@ Sessions are automatically started when agents call card-mutating tools without
 |-----------|-------------|
 | `cardId` | Card UUID to generate prompt from |
 | `shortId` | Alternative: Card short ID (e.g., 42 for #42) |
-| `variant` | `analysis` (understand/plan), `draft` (design solution), `execute` (implement fully) |
+| `variant` | `analysis` (understand/plan), `draft` (design the approach), `execute` (implement fully) |
 | `includeDescription` | Include card description (default: true) |
 | `includeSubtasks` | Include subtasks in prompt (default: true) |
 | `includeLinks` | Include linked cards in prompt (default: true) |
@@ -340,7 +340,7 @@ Create and manage project plans with a phased workflow: **plan** → **execute**
 - `harmony_get_plan` - Get plan by ID or card ID
 - `harmony_update_plan` - Update plan title, content, status, or phase
 - `harmony_advance_plan` - Advance to next phase with side effects:
-  - **plan → execute:** auto-creates Kanban cards from plan tasks, sets plan active
+  - **plan → execute:** auto-creates board cards from plan tasks, sets plan active
   - **execute → verify:** checks card completion status
   - **verify → done:** archives plan, creates memory entities
 
@@ -349,7 +349,7 @@ Create and manage project plans with a phased workflow: **plan** → **execute**
 - `harmony_onboard` - Complete end-to-end onboarding: signup → workspace → project → API key
 - `harmony_signup` - Create a new user account
 - `harmony_create_workspace` - Create a new workspace
-- `harmony_create_project` - Create a new project with template columns (kanban, scrum, or simple)
+- `harmony_create_project` - Create a new project with template columns (kanban, scrum, or simple) <!-- copy-guard-ignore: template enum value of the public API, not copy -->
 - `harmony_send_invitations` - Send workspace invitations to team members
 - `harmony_generate_api_key` - Generate an API key for the authenticated user