wolfpack-mcp 1.0.36 → 1.0.38

package/README.md

@@ -5,36 +5,36 @@
 Connect your AI assistant to Wolfpack to manage work items, track issues, update documentation, and log progress—all
 through natural conversation.
 
-## Installation
+## Quick Start
 
-```bash
-npm install -g wolfpack-mcp
-```
+There are two ways to connect:
 
-Or use directly with npx (no installation required):
+- **Claude Desktop** — Use the remote MCP server with OAuth (no API key needed)
+- **Coding agents** (Claude Code, Cursor, Windsurf, etc.) — Use this npm package via stdio with an API key
 
-```bash
-npx wolfpack-mcp
-```
+### Claude Desktop (Remote MCP)
 
-## Quick Start
+Add to your Claude Desktop config file:
 
-1. Generate an API key at [wolfpacks.work](https://wolfpacks.work) → Account Settings → API Keys
-2. Add the server to Claude Desktop (see [Setup](#setup) below)
-3. Restart Claude Desktop
-4. Start asking Claude about your work!
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
 
-**Try these prompts:**
+```json
+{
+  "mcpServers": {
+    "wolfpack": {
+      "type": "url",
+      "url": "https://wolfpacks.work/mcp"
+    }
+  }
+}
+```
 
-- "What work items are assigned to me?"
-- "Show me open bugs"
-- "Create a work item to refactor the auth module"
-- "Update issue #42 status to in-progress"
-- "Add a journal entry about today's progress"
+Restart Claude Desktop. You'll be prompted to sign in with your Wolfpack account via OAuth.
 
-## Setup
+### Coding Agents (stdio)
 
-### 1. Generate an API Key
+#### 1. Generate an API Key
 
 1. Log in to [wolfpacks.work](https://wolfpacks.work)
 2. Go to **Account Settings** → **API Keys**
@@ -42,12 +42,9 @@ npx wolfpack-mcp
 4. Select the permissions you need (work items, issues, wiki, etc.)
 5. Copy your API key immediately—you won't see it again
 
-### 2. Configure Claude Desktop
+#### 2. Configure Your Agent
 
-Add to your Claude Desktop config file:
-
-**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+**Claude Code** (`~/.claude/settings.json` or project `.mcp.json`):
 
 ```json
 {
@@ -63,9 +60,27 @@ Add to your Claude Desktop config file:
 }
 ```
 
-### 3. Restart Claude Desktop
+**Cursor / Windsurf** — use the same `command`, `args`, and `env` in your editor's MCP configuration.
 
-After saving the configuration, restart Claude Desktop to connect.
+## Installation
+
+```bash
+npm install -g wolfpack-mcp
+```
+
+Or use directly with npx (no installation required):
+
+```bash
+npx wolfpack-mcp
+```
+
+**Try these prompts:**
+
+- "What work items are assigned to me?"
+- "Show me open bugs"
+- "Create a work item to refactor the auth module"
+- "Update issue #42 status to in-progress"
+- "Add a journal entry about today's progress"
 
 ## What You Can Do
 
@@ -79,12 +94,12 @@ After saving the configuration, restart Claude Desktop to connect.
 
 ## Multiple Projects
 
-If you belong to multiple project teams, Claude will ask which team you mean, or you can specify:
+If you belong to multiple project teams, your AI assistant will ask which team you mean, or you can specify:
 
 - "Show my work items for the Platform team"
 - Use `list_teams` to see all your teams
 
-To pre-select a default team, add `WOLFPACK_TEAM_SLUG` to your config:
+To pre-select a default project for coding agents, add `WOLFPACK_TEAM_SLUG` to your env config:
 
 ```json
 {
@@ -100,7 +115,7 @@ The MCP server is designed to work within **one project at a time**:
 - The agent will identify which project you're working in before taking actions
 - Once a project is identified, all operations stay within that project
 - The agent will not perform bulk actions across multiple projects
-- To switch projects, explicitly tell Claude (e.g., "switch to the Platform project")
+- To switch projects, explicitly ask (e.g., "switch to the Platform project")
 
 ## Available Tools Reference
 

package/dist/apiClient.js

@@ -8,6 +8,16 @@ export class ApiError extends Error {
         this.name = 'ApiError';
     }
 }
+function formatError(error) {
+    if (error instanceof Error) {
+        const code = error.code;
+        if (code)
+            return `${error.message} (${code})`;
+        if (error.message)
+            return error.message;
+    }
+    return String(error) || 'unknown error';
+}
 export class ApiClient {
     headers = {
         Authorization: `Bearer ${config.apiKey}`,
@@ -30,7 +40,7 @@ export class ApiClient {
             if (error instanceof ApiError) {
                 throw error;
             }
-            throw new Error(`Failed to GET ${path}: ${error}`);
+            throw new Error(`Failed to GET ${path}: ${formatError(error)}`);
         }
     }
     async post(path, body) {
@@ -51,7 +61,7 @@ export class ApiClient {
             if (error instanceof ApiError) {
                 throw error;
             }
-            throw new Error(`Failed to POST ${path}: ${error}`);
+            throw new Error(`Failed to POST ${path}: ${formatError(error)}`);
         }
     }
     async put(path, body) {
@@ -72,7 +82,7 @@ export class ApiClient {
             if (error instanceof ApiError) {
                 throw error;
             }
-            throw new Error(`Failed to PUT ${path}: ${error}`);
+            throw new Error(`Failed to PUT ${path}: ${formatError(error)}`);
         }
     }
     async patch(path, body) {
@@ -93,7 +103,7 @@ export class ApiClient {
             if (error instanceof ApiError) {
                 throw error;
             }
-            throw new Error(`Failed to PATCH ${path}: ${error}`);
+            throw new Error(`Failed to PATCH ${path}: ${formatError(error)}`);
         }
     }
     async getBuffer(path) {
@@ -119,7 +129,7 @@ export class ApiClient {
             if (error instanceof ApiError) {
                 throw error;
             }
-            throw new Error(`Failed to GET buffer ${path}: ${error}`);
+            throw new Error(`Failed to GET buffer ${path}: ${formatError(error)}`);
         }
     }
     async postMultipart(path, buffer, filename, mimeType) {
@@ -166,7 +176,7 @@ export class ApiClient {
             if (error instanceof ApiError) {
                 throw error;
             }
-            throw new Error(`Failed to DELETE ${path}: ${error}`);
+            throw new Error(`Failed to DELETE ${path}: ${formatError(error)}`);
         }
     }
 }

package/dist/client.js

@@ -191,6 +191,28 @@ export class WolfpackClient {
             throw error;
         }
     }
+    async updateWorkItemTitle(workItemId, title) {
+        try {
+            return await this.api.put(`/work-items/${workItemId}/title`, { title });
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && 'status' in error && error.status === 404) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async updateWorkItemInitiative(workItemId, radarItemId) {
+        try {
+            return await this.api.put(`/work-items/${workItemId}/initiative`, { radarItemId });
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && 'status' in error && error.status === 404) {
+                return null;
+            }
+            throw error;
+        }
+    }
     async pullWorkItem(workItemId, data) {
         try {
             return await this.api.post(`/work-items/${workItemId}/pull`, data || {});
@@ -202,6 +224,19 @@ export class WolfpackClient {
             throw error;
         }
     }
+    async submitWorkItemForm(workItemId, formValues) {
+        try {
+            return await this.api.put(`/work-items/${workItemId}/form`, {
+                formValues,
+            });
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && 'status' in error && error.status === 404) {
+                return null;
+            }
+            throw error;
+        }
+    }
     // Radar Item (Initiative/Roadmap) methods
     async listRadarItems(options) {
         const params = new URLSearchParams();

package/dist/index.js

@@ -113,6 +113,17 @@ const UpdateWorkItemAssigneeSchema = z.object({
         .nullable()
         .describe('User ID to assign as leading user, or null to unassign'),
 });
+const UpdateWorkItemTitleSchema = z.object({
+    work_item_id: z.string().describe('The ID of the work item'),
+    title: z.string().describe('New title for the work item'),
+});
+const UpdateWorkItemInitiativeSchema = z.object({
+    work_item_id: z.string().describe('The ID of the work item'),
+    radar_item_id: z
+        .string()
+        .nullable()
+        .describe('Radar/initiative item ID to link to, or null to unlink'),
+});
 const PullWorkItemSchema = z.object({
     work_item_id: z.string().describe('The ID of the work item to pull from backlog'),
     leading_user_id: z
@@ -120,6 +131,10 @@ const PullWorkItemSchema = z.object({
         .optional()
         .describe('User ID to assign as leading user (defaults to API key owner)'),
 });
+const SubmitWorkItemFormSchema = z.object({
+    work_item_id: z.string().describe('The ID of the work item'),
+    form_values: z.record(z.any()).describe('Key-value pairs matching formDefinition field names'),
+});
 // Radar Item (Initiative/Roadmap) schemas
 const ListRadarItemsSchema = z.object({
     project_slug: z.string().optional().describe('Project slug to filter radar items'),
@@ -185,6 +200,10 @@ const CreateWorkItemSchema = z.object({
         .optional()
         .describe('Initial status: "pending" (backlog), "new" (to do), "doing", "review", "ready", "blocked", "completed". Defaults to "new".'),
     priority: z.number().optional().describe('Priority level (0-4, higher is more important)'),
+    size: z
+        .enum(['S', 'M', 'L'])
+        .optional()
+        .describe('Size estimate: "S" (small), "M" (medium), "L" (large)'),
     leading_user_id: z.string().optional().describe('User ID to assign as leading user'),
     category_id: z.string().optional().describe('Category ID to organize the work item'),
     radar_item_id: z.string().optional().describe('Radar/initiative item ID to link to'),
@@ -444,6 +463,7 @@ class WolfpackMCPServer {
                         'WORKFLOW: When asked to work on an item, check its status and follow the required state transitions ' +
                         '(pending→pull first, new→doing, blocked/ready/completed/closed→new→doing, then review when done). ' +
                         'PLANNING: Check if the description contains a plan (markdown checklist). If not, APPEND one using update_work_progress - preserve all original description text and add your plan below a "---" separator. ' +
+                        'FORMS: Procedure-created work items may include formDefinition (field definitions with name, label, type, required, options) and formValues (current values). Use submit_work_item_form to fill in form values. ' +
                         'IMAGES: Image references in the description (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
@@ -534,6 +554,44 @@ class WolfpackMCPServer {
                         required: ['work_item_id', 'leading_user_id'],
                     },
                 },
+                {
+                    name: 'update_work_item_title',
+                    description: 'Change the title of a work item. ' +
+                        'Use this to rename or update the title of an existing work item.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            work_item_id: {
+                                type: 'string',
+                                description: 'The ID of the work item',
+                            },
+                            title: {
+                                type: 'string',
+                                description: 'New title for the work item',
+                            },
+                        },
+                        required: ['work_item_id', 'title'],
+                    },
+                },
+                {
+                    name: 'update_work_item_initiative',
+                    description: 'Link or unlink a work item to/from a radar item (initiative). ' +
+                        'Pass a radar_item_id to link, or null to remove the initiative link.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            work_item_id: {
+                                type: 'string',
+                                description: 'The ID of the work item',
+                            },
+                            radar_item_id: {
+                                type: ['string', 'null'],
+                                description: 'Radar/initiative item ID to link to, or null to unlink',
+                            },
+                        },
+                        required: ['work_item_id', 'radar_item_id'],
+                    },
+                },
                 {
                     name: 'pull_work_item',
                     description: 'Pull a specific work item from the backlog to the board. ' +
@@ -557,6 +615,26 @@ class WolfpackMCPServer {
                         required: ['work_item_id'],
                     },
                 },
+                {
+                    name: 'submit_work_item_form',
+                    description: 'Submit form values for a procedure-created work item. ' +
+                        'Use get_work_item first to see formDefinition (field names, types, required) and current formValues. ' +
+                        'Then call this with form_values mapping field names to values.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            work_item_id: {
+                                type: 'string',
+                                description: 'The ID of the work item',
+                            },
+                            form_values: {
+                                type: 'object',
+                                description: 'Key-value pairs matching formDefinition field names',
+                            },
+                        },
+                        required: ['work_item_id', 'form_values'],
+                    },
+                },
                 // Radar Item (Initiative/Roadmap) tools
                 {
                     name: 'list_radar_items',
@@ -714,6 +792,11 @@ class WolfpackMCPServer {
                                 type: 'number',
                                 description: 'Priority level (0-4, higher is more important)',
                             },
+                            size: {
+                                type: 'string',
+                                enum: ['S', 'M', 'L'],
+                                description: 'Size estimate: "S" (small), "M" (medium), "L" (large)',
+                            },
                             leading_user_id: {
                                 type: 'string',
                                 description: 'User ID to assign as leading user',
@@ -1183,6 +1266,43 @@ class WolfpackMCPServer {
                             content: [{ type: 'text', text: 'Work item not found' }],
                         };
                     }
+                    case 'update_work_item_title': {
+                        const parsed = UpdateWorkItemTitleSchema.parse(args);
+                        const workItem = await this.client.updateWorkItemTitle(parsed.work_item_id, parsed.title);
+                        if (workItem) {
+                            return {
+                                content: [
+                                    {
+                                        type: 'text',
+                                        text: `Updated title to "${workItem.title}"\n\n${JSON.stringify(workItem, null, 2)}`,
+                                    },
+                                ],
+                            };
+                        }
+                        return {
+                            content: [{ type: 'text', text: 'Work item not found' }],
+                        };
+                    }
+                    case 'update_work_item_initiative': {
+                        const parsed = UpdateWorkItemInitiativeSchema.parse(args);
+                        const workItem = await this.client.updateWorkItemInitiative(parsed.work_item_id, parsed.radar_item_id);
+                        if (workItem) {
+                            const initiativeText = parsed.radar_item_id
+                                ? `linked to initiative ${parsed.radar_item_id}`
+                                : 'unlinked from initiative';
+                            return {
+                                content: [
+                                    {
+                                        type: 'text',
+                                        text: `Updated "${workItem.title}" - ${initiativeText}\n\n${JSON.stringify(workItem, null, 2)}`,
+                                    },
+                                ],
+                            };
+                        }
+                        return {
+                            content: [{ type: 'text', text: 'Work item not found' }],
+                        };
+                    }
                     case 'pull_work_item': {
                         const parsed = PullWorkItemSchema.parse(args);
                         const workItem = await this.client.pullWorkItem(parsed.work_item_id, {
@@ -1202,6 +1322,23 @@ class WolfpackMCPServer {
                             content: [{ type: 'text', text: 'Work item not found' }],
                         };
                     }
+                    case 'submit_work_item_form': {
+                        const parsed = SubmitWorkItemFormSchema.parse(args);
+                        const workItem = await this.client.submitWorkItemForm(parsed.work_item_id, parsed.form_values);
+                        if (workItem) {
+                            return {
+                                content: [
+                                    {
+                                        type: 'text',
+                                        text: `Submitted form values for "${workItem.title}"\n\n${JSON.stringify(workItem, null, 2)}`,
+                                    },
+                                ],
+                            };
+                        }
+                        return {
+                            content: [{ type: 'text', text: 'Work item not found' }],
+                        };
+                    }
                     // Radar Item handlers
                     case 'list_radar_items': {
                         const parsed = ListRadarItemsSchema.parse(args);
@@ -1277,6 +1414,7 @@ class WolfpackMCPServer {
                             description: parsed.description,
                             status: parsed.status,
                             priority: parsed.priority,
+                            size: parsed.size,
                             leadingUserId: parsed.leading_user_id,
                             categoryId: parsed.category_id,
                             radarItemId: parsed.radar_item_id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolfpack-mcp",
-  "version": "1.0.36",
+  "version": "1.0.38",
   "description": "MCP server for Wolfpack AI-enhanced software delivery tools",
   "main": "dist/index.js",
   "type": "module",