wolfpack-mcp 1.0.93 → 1.0.94

package/README.md

@@ -355,6 +355,51 @@ Get a specific radar item.
 - `item_id` (required): UUID or reference number
 - `team_id` (optional): Required when using reference number
 
+### Tags
+
+Tags label work items, issues, wiki pages and journal entries, and are filed under nestable groups. Project admins define them; a key with `mcp:tags:manage` lets an admin's agent keep them in step with an external system (for example, one tag per CRM customer account keyed on `external_id`). There is no delete tool — removing a tag is done in the browser.
+
+#### `list_tags`
+
+List a project's tags with id, name, colour, `externalId` and the group each is filed under. Any key that can read a tagged module may list them.
+
+- `project_slug` (optional): Project slug
+
+#### `create_tag`
+
+- `name` (required): Tag name, unique within the project
+- `colour` (optional): Hex colour such as `#e879f9`
+- `group` (optional): Tag group name or id
+- `external_id` (optional): Id of this tag in the system that maintains it, unique within the project
+- `project_slug` (optional): Project slug
+
+#### `update_tag`
+
+Only the fields given change; pass `null` for `colour`, `group` or `external_id` to clear it.
+
+- `tag` (required): Tag id or current name
+- `name`, `colour`, `group`, `external_id` (optional)
+- `project_slug` (optional): Project slug
+
+#### `list_tag_groups`
+
+List a project's tag groups with their parent and full path (e.g. `Customers › EMEA`).
+
+- `project_slug` (optional): Project slug
+
+#### `create_tag_group`
+
+- `name` (required): Group name, unique within the project
+- `parent` (optional): Parent group name or id
+- `project_slug` (optional): Project slug
+
+#### `update_tag_group`
+
+- `group` (required): Group id or current name
+- `name` (optional): New name
+- `parent` (optional): Parent group name or id, or `null` for the top level
+- `project_slug` (optional): Project slug
+
 ### Images
 
 #### `upload_image`

package/dist/client.js

@@ -525,6 +525,28 @@ export class WolfpackClient {
         const query = params.toString();
         return this.api.get(`/tags${query ? `?${query}` : ''}`);
     }
+    async createTag(input, teamSlug) {
+        return this.api.post('/tags', { ...input, teamSlug });
+    }
+    async updateTag(tag, input, teamSlug) {
+        return this.api.patch(`/tags/${encodeURIComponent(tag)}`, { ...input, teamSlug });
+    }
+    async listTagGroups(teamSlug) {
+        const params = new URLSearchParams();
+        if (teamSlug)
+            params.append('teamSlug', teamSlug);
+        const query = params.toString();
+        return this.api.get(`/tag-groups${query ? `?${query}` : ''}`);
+    }
+    async createTagGroup(input, teamSlug) {
+        return this.api.post('/tag-groups', { ...input, teamSlug });
+    }
+    async updateTagGroup(group, input, teamSlug) {
+        return this.api.patch(`/tag-groups/${encodeURIComponent(group)}`, {
+            ...input,
+            teamSlug,
+        });
+    }
     /**
      * Upload an image and get back a URL that can be used in markdown content.
      */

package/dist/index.js

@@ -600,6 +600,55 @@ const ListTagsSchema = z.object({
         .optional()
         .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
 });
+const CreateTagSchema = z.object({
+    project_slug: z
+        .string()
+        .optional()
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+    name: z.string().describe('Tag name, unique within the project'),
+    colour: z.string().optional().describe('Hex colour such as #e879f9'),
+    group: z.string().optional().describe('Tag group name or id to file the tag under'),
+    external_id: z
+        .string()
+        .optional()
+        .describe('Id of this tag in the system that maintains it, unique within the project'),
+});
+const UpdateTagSchema = z.object({
+    project_slug: z
+        .string()
+        .optional()
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+    tag: z.string().describe('Tag id or current name'),
+    name: z.string().optional().describe('New name'),
+    colour: z.string().nullable().optional().describe('Hex colour, or null to clear'),
+    group: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Tag group name or id, or null to move the tag out of its group'),
+    external_id: z.string().nullable().optional().describe('External id, or null to clear'),
+});
+const CreateTagGroupSchema = z.object({
+    project_slug: z
+        .string()
+        .optional()
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+    name: z.string().describe('Group name, unique within the project'),
+    parent: z.string().optional().describe('Parent group name or id'),
+});
+const UpdateTagGroupSchema = z.object({
+    project_slug: z
+        .string()
+        .optional()
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+    group: z.string().describe('Group id or current name'),
+    name: z.string().optional().describe('New name'),
+    parent: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Parent group name or id, or null for the top level'),
+});
 // Team member schemas
 const ListTeamMembersSchema = z.object({
     project_slug: z
@@ -1937,8 +1986,9 @@ class WolfpackMCPServer {
                     // Tag tools
                     {
                         name: 'list_tags',
-                        description: 'List all tags available in a project. Returns tag names and colours. ' +
-                            'Work items are tagged by name via update_work_item.',
+                        description: 'List all tags available in a project: id, name, colour, external id and the group each is filed under. ' +
+                            'Items are tagged by name via update_work_item / update_issue. ' +
+                            'A sync from an external system (e.g. a CRM) keys on externalId.',
                         inputSchema: {
                             type: 'object',
                             properties: {
@@ -1949,6 +1999,107 @@ class WolfpackMCPServer {
                             },
                         },
                     },
+                    {
+                        name: 'create_tag',
+                        description: 'Create a tag in a project. Project admins only (mcp:tags:manage). ' +
+                            'Set external_id when the tag mirrors a record in another system, so a later sync can find it by id rather than name.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                name: { type: 'string', description: 'Tag name, unique within the project' },
+                                colour: { type: 'string', description: 'Hex colour such as #e879f9 (optional)' },
+                                group: {
+                                    type: 'string',
+                                    description: 'Tag group name or id to file the tag under (optional, see list_tag_groups)',
+                                },
+                                external_id: {
+                                    type: 'string',
+                                    description: 'Id of this tag in the system that maintains it, unique within the project (optional)',
+                                },
+                            },
+                            required: ['name'],
+                        },
+                    },
+                    {
+                        name: 'update_tag',
+                        description: 'Rename, recolour, regroup or re-key a tag. Project admins only (mcp:tags:manage). ' +
+                            'Only the fields given change; pass null for colour, group or external_id to clear it.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                tag: { type: 'string', description: 'Tag id or current name' },
+                                name: { type: 'string', description: 'New name' },
+                                colour: { type: ['string', 'null'], description: 'Hex colour, or null to clear' },
+                                group: {
+                                    type: ['string', 'null'],
+                                    description: 'Tag group name or id, or null to move the tag out of its group',
+                                },
+                                external_id: {
+                                    type: ['string', 'null'],
+                                    description: 'External id, or null to clear',
+                                },
+                            },
+                            required: ['tag'],
+                        },
+                    },
+                    {
+                        name: 'list_tag_groups',
+                        description: 'List the tag groups of a project with their parent and full path (groups nest, e.g. "Customers › EMEA").',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                            },
+                        },
+                    },
+                    {
+                        name: 'create_tag_group',
+                        description: 'Create a tag group, optionally inside a parent group. Project admins only (mcp:tags:manage).',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                name: { type: 'string', description: 'Group name, unique within the project' },
+                                parent: { type: 'string', description: 'Parent group name or id (optional)' },
+                            },
+                            required: ['name'],
+                        },
+                    },
+                    {
+                        name: 'update_tag_group',
+                        description: 'Rename a tag group or move it under another parent. Project admins only (mcp:tags:manage). ' +
+                            'Pass parent: null for the top level.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                group: { type: 'string', description: 'Group id or current name' },
+                                name: { type: 'string', description: 'New name' },
+                                parent: {
+                                    type: ['string', 'null'],
+                                    description: 'Parent group name or id, or null for the top level',
+                                },
+                            },
+                            required: ['group'],
+                        },
+                    },
                     // Team member tools
                     {
                         name: 'list_team_members',
@@ -3086,6 +3237,51 @@ class WolfpackMCPServer {
                             content: [{ type: 'text', text: JSON.stringify(tags, null, 2) }],
                         };
                     }
+                    case 'create_tag': {
+                        const parsed = CreateTagSchema.parse(args);
+                        const tag = await this.client.createTag({
+                            name: parsed.name,
+                            colour: parsed.colour,
+                            group: parsed.group,
+                            externalId: parsed.external_id,
+                        }, parsed.project_slug || this.client.getProjectSlug() || undefined);
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify(tag, null, 2) }],
+                        };
+                    }
+                    case 'update_tag': {
+                        const parsed = UpdateTagSchema.parse(args);
+                        const tag = await this.client.updateTag(parsed.tag, {
+                            name: parsed.name,
+                            colour: parsed.colour,
+                            group: parsed.group,
+                            externalId: parsed.external_id,
+                        }, parsed.project_slug || this.client.getProjectSlug() || undefined);
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify(tag, null, 2) }],
+                        };
+                    }
+                    case 'list_tag_groups': {
+                        const parsed = ListTagsSchema.parse(args);
+                        const groups = await this.client.listTagGroups(parsed.project_slug || this.client.getProjectSlug() || undefined);
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify(groups, null, 2) }],
+                        };
+                    }
+                    case 'create_tag_group': {
+                        const parsed = CreateTagGroupSchema.parse(args);
+                        const group = await this.client.createTagGroup({ name: parsed.name, parent: parsed.parent }, parsed.project_slug || this.client.getProjectSlug() || undefined);
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify(group, null, 2) }],
+                        };
+                    }
+                    case 'update_tag_group': {
+                        const parsed = UpdateTagGroupSchema.parse(args);
+                        const group = await this.client.updateTagGroup(parsed.group, { name: parsed.name, parent: parsed.parent }, parsed.project_slug || this.client.getProjectSlug() || undefined);
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify(group, null, 2) }],
+                        };
+                    }
                     // Team member handlers
                     case 'list_team_members': {
                         const parsed = ListTeamMembersSchema.parse(args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolfpack-mcp",
-  "version": "1.0.93",
+  "version": "1.0.94",
   "description": "MCP server for Wolfpack AI-enhanced software delivery tools",
   "main": "dist/index.js",
   "type": "module",
@@ -45,9 +45,9 @@
     "@eslint/js": "^9.17.0",
     "@types/node": "^22.12.0",
     "eslint": "^9.17.0",
-    "tsx": "^4.20.0",
+    "tsx": "^4.23.12",
     "typescript": "^5.7.3",
-    "typescript-eslint": "^8.21.0",
-    "vitest": "^4.0.16"
+    "typescript-eslint": "^8.68.0",
+    "vitest": "^4.1.11"
   }
 }