harmony-mcp 1.2.1 → 1.2.3

package/README.md

@@ -4,7 +4,9 @@ MCP (Model Context Protocol) server for Harmony Kanban board. Enables AI coding
 
 ## Features
 
-- **20+ MCP Tools** for full board control (cards, columns, labels, subtasks)
+- **25+ MCP Tools** for full board control (cards, columns, labels, subtasks, links)
+- **Card Linking** - create relationships between cards (blocks, relates_to, duplicates, is_part_of)
+- **Prompt Builder** - generate AI-ready prompts from cards with context
 - **Agent Session Tracking** - track work progress with timer badges
 - **Multi-Agent Support** - works with Claude Code, Codex, Cursor, Windsurf
 - **One-Command Setup** - auto-configure all supported agents
@@ -113,7 +115,22 @@ harmony-mcp serve              # Start MCP server
 - `harmony_delete_card` - Delete a card
 - `harmony_assign_card` - Assign to team member
 - `harmony_search_cards` - Search by title/description
-- `harmony_get_card` - Get card details
+- `harmony_get_card` - Get card details by UUID
+- `harmony_get_card_by_short_id` - Get card by short ID (e.g., #42)
+
+### Card Link Operations
+
+- `harmony_add_link_to_card` - Create a link between two cards
+- `harmony_remove_link_from_card` - Remove a link between cards
+- `harmony_get_card_links` - Get all links for a card
+
+**Link Types:**
+| Type | Description |
+|------|-------------|
+| `relates_to` | Generic relationship between cards |
+| `blocks` | Source card blocks target card |
+| `duplicates` | Source card duplicates target card |
+| `is_part_of` | Source card is part of target card |
 
 ### Column Operations
 
@@ -154,6 +171,28 @@ harmony-mcp serve              # Start MCP server
 - `harmony_end_agent_session` - End session (completed/paused)
 - `harmony_get_agent_session` - Get current session state
 
+### Prompt Generation
+
+- `harmony_generate_prompt` - Generate an AI-ready prompt from a card
+
+**Parameters:**
+| Parameter | Description |
+|-----------|-------------|
+| `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) |
+| `includeDescription` | Include card description (default: true) |
+| `includeSubtasks` | Include subtasks in prompt (default: true) |
+| `includeLinks` | Include linked cards in prompt (default: true) |
+| `customConstraints` | Additional instructions to append |
+
+**Variants:**
+- `analysis` - Understand the problem and create a plan
+- `draft` - Design a solution approach
+- `execute` - Full implementation (default)
+
+The prompt builder automatically infers the agent role based on card labels (bug, feature, design, etc.) and includes relevant context from linked cards.
+
 ## Direct API Access
 
 You can also call the Harmony API directly from any HTTP client:
@@ -186,6 +225,10 @@ curl -X GET "https://gethmy.com/api/workspaces" \
 | `/subtasks`                  | POST   | Create subtask             |
 | `/subtasks/:id/toggle`       | POST   | Toggle subtask             |
 | `/subtasks/:id`              | DELETE | Delete subtask             |
+| `/cards/:id/links`           | GET    | Get card links             |
+| `/cards/:id/links`           | POST   | Create card link           |
+| `/links/:id`                 | DELETE | Delete card link           |
+| `/cards/:id/prompt`          | GET    | Generate prompt from card  |
 | `/nlu`                       | POST   | Process natural language   |
 
 ## Configuration

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harmony-mcp",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "MCP server for Harmony Kanban board - enables AI coding agents to manage your boards",
   "type": "module",
   "main": "dist/index.js",
@@ -13,7 +13,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/Way/getharmony"
+    "url": "git+https://github.com/Way/getharmony.git"
   },
   "homepage": "https://gethmy.com",
   "bugs": {