wolfpack-mcp 1.0.31 → 1.0.33

package/dist/client.js

@@ -5,42 +5,38 @@ const MAX_ITEMS_THRESHOLD = 200;
 const PAGE_SIZE = 50;
 export class WolfpackClient {
     api;
-    projectId = null;
+    projectSlug = null;
     constructor() {
         this.api = new ApiClient();
     }
     /**
-     * Fetch and cache the project ID from a project slug.
-     * Uses the MCP team endpoint to resolve slug to ID.
+     * Fetch and cache the project slug by verifying it exists.
+     * Uses the MCP team endpoint to validate the slug.
      */
     async resolveProjectSlug(projectSlug) {
         try {
-            const project = await this.api.get(`/team/${projectSlug}`);
-            this.projectId = project.id;
-            return project.id;
+            await this.api.get(`/team/${projectSlug}`);
+            this.projectSlug = projectSlug;
+            return projectSlug;
         }
         catch (error) {
             throw new Error(`Failed to resolve project slug "${projectSlug}": ${error instanceof Error ? error.message : String(error)}`);
         }
     }
-    getProjectId() {
-        return this.projectId;
+    getProjectSlug() {
+        return this.projectSlug;
     }
-    setProjectId(projectId) {
-        this.projectId = projectId;
+    setProjectSlug(slug) {
+        this.projectSlug = slug;
     }
     /**
-     * Resolve a project slug from a project ID or the cached project ID.
+     * Resolve a project slug from the provided slug or the cached project slug.
      */
-    async resolveSlug(projectId) {
-        const id = projectId || this.projectId;
-        if (!id)
+    async resolveSlug(teamSlug) {
+        const slug = teamSlug || this.projectSlug;
+        if (!slug)
             throw new Error('No project selected. Use list_projects first.');
-        const projects = await this.listProjects();
-        const project = projects.find((t) => t.id === id);
-        if (!project)
-            throw new Error(`Project with ID ${id} not found`);
-        return project.slug;
+        return slug;
     }
     /**
      * List all projects the authenticated user is a member of.
@@ -98,8 +94,8 @@ export class WolfpackClient {
     // Work Item methods
     async listWorkItems(options) {
         const params = new URLSearchParams();
-        if (options?.teamId)
-            params.append('teamId', options.teamId.toString());
+        if (options?.teamSlug)
+            params.append('teamSlug', options.teamSlug);
         if (options?.status)
             params.append('status', options.status);
         if (options?.assignedToId)
@@ -145,11 +141,11 @@ export class WolfpackClient {
         // Otherwise, fetch all pages automatically
         return this.fetchAllPages('/work-items', params);
     }
-    async getWorkItem(workItemId, teamId) {
+    async getWorkItem(workItemId, teamSlug) {
         try {
             const params = new URLSearchParams();
-            if (teamId)
-                params.append('teamId', teamId.toString());
+            if (teamSlug)
+                params.append('teamSlug', teamSlug);
             const query = params.toString();
             return await this.api.get(`/work-items/${workItemId}${query ? `?${query}` : ''}`);
         }
@@ -209,8 +205,8 @@ export class WolfpackClient {
     // Radar Item (Initiative/Roadmap) methods
     async listRadarItems(options) {
         const params = new URLSearchParams();
-        if (options?.teamId)
-            params.append('teamId', options.teamId.toString());
+        if (options?.teamSlug)
+            params.append('teamSlug', options.teamSlug);
         if (options?.stage)
             params.append('stage', options.stage);
         if (options?.search)
@@ -235,11 +231,11 @@ export class WolfpackClient {
         }
         return this.fetchAllPages('/radar-items', params);
     }
-    async getRadarItem(itemId, teamId) {
+    async getRadarItem(itemId, teamSlug) {
         try {
             const params = new URLSearchParams();
-            if (teamId)
-                params.append('teamId', teamId.toString());
+            if (teamSlug)
+                params.append('teamSlug', teamSlug);
             const query = params.toString();
             return await this.api.get(`/radar-items/${itemId}${query ? `?${query}` : ''}`);
         }
@@ -253,8 +249,8 @@ export class WolfpackClient {
     // Issue methods
     async listIssues(options) {
         const params = new URLSearchParams();
-        if (options?.teamId)
-            params.append('teamId', options.teamId.toString());
+        if (options?.teamSlug)
+            params.append('teamSlug', options.teamSlug);
         if (options?.status)
             params.append('status', options.status);
         if (options?.severity)
@@ -293,11 +289,11 @@ export class WolfpackClient {
         }
         return this.fetchAllPages('/issues', params);
     }
-    async getIssue(issueId, teamId) {
+    async getIssue(issueId, teamSlug) {
         try {
             const params = new URLSearchParams();
-            if (teamId)
-                params.append('teamId', teamId.toString());
+            if (teamSlug)
+                params.append('teamSlug', teamSlug);
             const query = params.toString();
             return await this.api.get(`/issues/${issueId}${query ? `?${query}` : ''}`);
         }
@@ -310,10 +306,12 @@ export class WolfpackClient {
     }
     // Create methods
     async createWorkItem(data) {
-        return this.api.post('/work-items', data);
+        const { teamSlug, ...rest } = data;
+        return this.api.post('/work-items', { ...rest, teamSlug });
     }
     async createIssue(data) {
-        return this.api.post('/issues', data);
+        const { teamSlug, ...rest } = data;
+        return this.api.post('/issues', { ...rest, teamSlug });
     }
     async updateIssue(issueId, data) {
         return this.api.patch(`/issues/${issueId}`, data);
@@ -321,6 +319,8 @@ export class WolfpackClient {
     // Wiki Page methods
     async listWikiPages(options) {
         const params = new URLSearchParams();
+        if (options?.teamSlug)
+            params.append('teamSlug', options.teamSlug);
         if (options?.search)
             params.append('search', options.search);
         if (options?.dateFrom)
@@ -359,7 +359,8 @@ export class WolfpackClient {
         }
     }
     async createWikiPage(data) {
-        return this.api.post('/wiki-pages', data);
+        const { teamSlug, ...rest } = data;
+        return this.api.post('/wiki-pages', { ...rest, teamSlug });
     }
     async updateWikiPage(pageId, data) {
         return this.api.patch(`/wiki-pages/${pageId}`, data);
@@ -367,6 +368,8 @@ export class WolfpackClient {
     // Journal Entry methods
     async listJournalEntries(options) {
         const params = new URLSearchParams();
+        if (options?.teamSlug)
+            params.append('teamSlug', options.teamSlug);
         if (options?.search)
             params.append('search', options.search);
         if (options?.dateFrom)
@@ -389,11 +392,11 @@ export class WolfpackClient {
         }
         return this.fetchAllPages('/journal-entries', params);
     }
-    async getJournalEntry(entryId, teamId) {
+    async getJournalEntry(entryId, teamSlug) {
         try {
             const params = new URLSearchParams();
-            if (teamId)
-                params.append('teamId', teamId.toString());
+            if (teamSlug)
+                params.append('teamSlug', teamSlug);
             const query = params.toString();
             return await this.api.get(`/journal-entries/${entryId}${query ? `?${query}` : ''}`);
         }
@@ -405,7 +408,8 @@ export class WolfpackClient {
         }
     }
     async createJournalEntry(data) {
-        return this.api.post('/journal-entries', data);
+        const { teamSlug, ...rest } = data;
+        return this.api.post('/journal-entries', { ...rest, teamSlug });
     }
     async updateJournalEntry(entryId, data) {
         return this.api.patch(`/journal-entries/${entryId}`, data);

package/dist/index.js

@@ -46,7 +46,7 @@ async function checkForUpdates() {
 // Work Item schemas
 // Use z.coerce.string() to handle any type coercion issues from MCP args
 const ListWorkItemsSchema = z.object({
-    project_id: z.number().optional().describe('Project ID to filter work items'),
+    project_slug: z.string().optional().describe('Project slug to filter work items'),
     status: z.coerce
         .string()
         .optional()
@@ -85,15 +85,24 @@ const ListWorkItemsSchema = z.object({
 });
 const GetWorkItemSchema = z.object({
     work_item_id: z.string().describe('The ID (UUID) or refId (number) of the work item'),
-    project_id: z.number().optional().describe('Project ID (required when looking up by refId)'),
+    project_slug: z.string().optional().describe('Project slug (required when looking up by refId)'),
 });
 const UpdateWorkProgressSchema = z.object({
     work_item_id: z.string().describe('The ID of the work item'),
     description: z.string().describe('Updated description/notes for the work item'),
 });
+const VALID_STATUSES = [
+    'pending',
+    'new',
+    'doing',
+    'blocked',
+    'review',
+    'ready',
+    'completed',
+];
 const UpdateWorkItemStatusSchema = z.object({
     work_item_id: z.string().describe('The ID of the work item'),
-    status: z.string().describe('New status'),
+    status: z.enum(VALID_STATUSES).describe('New status'),
 });
 const UpdateWorkItemAssigneeSchema = z.object({
     work_item_id: z.string().describe('The ID of the work item'),
@@ -111,7 +120,7 @@ const PullWorkItemSchema = z.object({
 });
 // Radar Item (Initiative/Roadmap) schemas
 const ListRadarItemsSchema = z.object({
-    project_id: z.number().optional().describe('Project ID to filter radar items'),
+    project_slug: z.string().optional().describe('Project slug to filter radar items'),
     stage: z
         .enum(['pending', 'now', 'next', 'later', 'completed'])
         .optional()
@@ -122,11 +131,11 @@ const ListRadarItemsSchema = z.object({
 });
 const GetRadarItemSchema = z.object({
     item_id: z.string().describe('The ID (UUID) or refId (number) of the radar item'),
-    project_id: z.number().optional().describe('Project ID (required when looking up by refId)'),
+    project_slug: z.string().optional().describe('Project slug (required when looking up by refId)'),
 });
 // Issue schemas
 const ListIssuesSchema = z.object({
-    project_id: z.number().optional().describe('Project ID to filter issues'),
+    project_slug: z.string().optional().describe('Project slug to filter issues'),
     status: z
         .enum(['open', 'in-progress', 'resolved', 'closed'])
         .optional()
@@ -159,17 +168,18 @@ const ListIssuesSchema = z.object({
 });
 const GetIssueSchema = z.object({
     issue_id: z.string().describe('The ID (UUID) or refId (number) of the issue'),
-    project_id: z.number().optional().describe('Project ID (required when looking up by refId)'),
+    project_slug: z.string().optional().describe('Project slug (required when looking up by refId)'),
 });
 // Create schemas
 const CreateWorkItemSchema = z.object({
-    title: z.string().describe('Title of the work item'),
-    description: z
+    project_slug: z
         .string()
         .optional()
-        .describe('Description/notes for the work item (markdown). Supports base64-encoded images which will be auto-uploaded.'),
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+    title: z.string().describe('Title of the work item'),
+    description: z.string().optional().describe('Description/notes for the work item (markdown)'),
     status: z
-        .string()
+        .enum(VALID_STATUSES)
         .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)'),
@@ -178,6 +188,10 @@ const CreateWorkItemSchema = z.object({
     radar_item_id: z.string().optional().describe('Radar/initiative item ID to link to'),
 });
 const CreateIssueSchema = z.object({
+    project_slug: z
+        .string()
+        .optional()
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
     title: z.string().describe('Title of the issue'),
     description: z.string().optional().describe('Description of the issue'),
     severity: z.enum(['low', 'medium', 'high', 'critical']).optional().describe('Severity level'),
@@ -207,6 +221,7 @@ const UpdateIssueSchema = z.object({
 });
 // Wiki Page schemas
 const ListWikiPagesSchema = z.object({
+    project_slug: z.string().optional().describe('Project slug to filter wiki pages'),
     search: z.coerce.string().optional().describe('Text search in title and content'),
     date_from: z.coerce
         .string()
@@ -223,6 +238,10 @@ const GetWikiPageSchema = z.object({
     page_id: z.string().describe('The page UUID or slug'),
 });
 const CreateWikiPageSchema = z.object({
+    project_slug: z
+        .string()
+        .optional()
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
     slug: z
         .string()
         .describe('URL slug for the page (without team prefix). The system automatically prepends the team and wiki path. For example, to create a page at "myteam/wiki/guides/onboarding", pass just "guides/onboarding". Do NOT include the team slug or "wiki/" prefix.')
@@ -232,20 +251,16 @@ const CreateWikiPageSchema = z.object({
         return slug.replace(wikiPrefix, '');
     }),
     title: z.string().describe('Page title'),
-    content: z
-        .string()
-        .describe('Page content (markdown). Supports base64-encoded images (e.g., ![alt](data:image/png;base64,...)) which will be auto-uploaded.'),
+    content: z.string().describe('Page content (markdown)'),
 });
 const UpdateWikiPageSchema = z.object({
     page_id: z.string().describe('The page UUID'),
     title: z.string().optional().describe('Updated title'),
-    content: z
-        .string()
-        .optional()
-        .describe('Updated content (markdown). Supports base64-encoded images which will be auto-uploaded.'),
+    content: z.string().optional().describe('Updated content (markdown)'),
 });
 // Journal Entry schemas
 const ListJournalEntriesSchema = z.object({
+    project_slug: z.string().optional().describe('Project slug to filter journal entries'),
     search: z.coerce.string().optional().describe('Text search in title and content'),
     date_from: z.coerce
         .string()
@@ -260,22 +275,21 @@ const ListJournalEntriesSchema = z.object({
 });
 const GetJournalEntrySchema = z.object({
     entry_id: z.string().describe('The entry UUID or refId'),
-    project_id: z.number().optional().describe('Project ID (required when looking up by refId)'),
+    project_slug: z.string().optional().describe('Project slug (required when looking up by refId)'),
 });
 const CreateJournalEntrySchema = z.object({
-    title: z.string().describe('Entry title'),
-    content: z
+    project_slug: z
         .string()
-        .describe('Entry content (markdown). Supports base64-encoded images which will be auto-uploaded.'),
+        .optional()
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+    title: z.string().describe('Entry title'),
+    content: z.string().describe('Entry content (markdown)'),
     date: z.string().optional().describe('Entry date (ISO format, defaults to now)'),
 });
 const UpdateJournalEntrySchema = z.object({
     entry_id: z.string().describe('The entry UUID'),
     title: z.string().optional().describe('Updated title'),
-    content: z
-        .string()
-        .optional()
-        .describe('Updated content (markdown). Supports base64-encoded images which will be auto-uploaded.'),
+    content: z.string().optional().describe('Updated content (markdown)'),
 });
 // Comment schemas
 const ListWorkItemCommentsSchema = z.object({
@@ -286,15 +300,11 @@ const ListIssueCommentsSchema = z.object({
 });
 const CreateWorkItemCommentSchema = z.object({
     work_item_id: z.string().describe('The work item UUID'),
-    content: z
-        .string()
-        .describe('Comment content (markdown). Supports base64-encoded images which will be auto-uploaded.'),
+    content: z.string().describe('Comment content (markdown)'),
 });
 const CreateIssueCommentSchema = z.object({
     issue_id: z.string().describe('The issue UUID'),
-    content: z
-        .string()
-        .describe('Comment content (markdown). Supports base64-encoded images which will be auto-uploaded.'),
+    content: z.string().describe('Comment content (markdown)'),
 });
 // Image upload schema
 const UploadImageSchema = z.object({
@@ -302,10 +312,10 @@ const UploadImageSchema = z.object({
         .string()
         .describe('Absolute path to an image file on disk (e.g., "/tmp/screenshot.png"). ' +
         'Supported formats: JPEG, PNG, GIF, WebP. Max 5MB.'),
-    project_id: z
-        .number()
+    project_slug: z
+        .string()
         .optional()
-        .describe('Project ID (required for multi-project users, use list_projects to get IDs)'),
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
 });
 const DownloadImageSchema = z.object({
     image_url: z
@@ -353,7 +363,7 @@ class WolfpackMCPServer {
                         '3) NEVER perform bulk actions across multiple projects - always work in one project at a time. ' +
                         '4) If the user mentions a specific project, use that for all subsequent operations. ' +
                         '5) If unclear which project to use, ASK the user before proceeding. ' +
-                        'Returns project IDs, slugs, names, and types. Single-project users have their project auto-selected; multi-project users must specify project_id in other tool calls.',
+                        'Returns project slugs, names, and types. Single-project users have their project auto-selected; multi-project users must specify project_slug in other tool calls.',
                     inputSchema: {
                         type: 'object',
                         properties: {},
@@ -374,9 +384,9 @@ class WolfpackMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            project_id: {
-                                type: 'number',
-                                description: 'Project ID (required for multi-project users, use list_projects to get IDs)',
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
                             },
                             status: {
                                 type: 'string',
@@ -440,9 +450,9 @@ class WolfpackMCPServer {
                                 type: 'string',
                                 description: 'The ID (UUID) or refId (number) of the work item',
                             },
-                            project_id: {
-                                type: 'number',
-                                description: 'Project ID (required when looking up by refId)',
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (required when looking up by refId)',
                             },
                         },
                         required: ['work_item_id'],
@@ -485,6 +495,7 @@ class WolfpackMCPServer {
                             },
                             status: {
                                 type: 'string',
+                                enum: ['pending', 'new', 'doing', 'blocked', 'review', 'ready', 'completed'],
                                 description: 'New status: "pending" (backlog), "new" (to do), "doing" (in progress), "review" (work done), "ready" (awaiting deployment), "blocked", "completed" (deployed)',
                             },
                         },
@@ -541,9 +552,9 @@ class WolfpackMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            project_id: {
-                                type: 'number',
-                                description: 'Project ID (use list_projects to get IDs)',
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (use list_projects to get slugs)',
                             },
                             stage: {
                                 type: 'string',
@@ -570,9 +581,9 @@ class WolfpackMCPServer {
                                 type: 'string',
                                 description: 'The ID (UUID) or refId (number) of the radar item',
                             },
-                            project_id: {
-                                type: 'number',
-                                description: 'Project ID (required when looking up by refId)',
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (required when looking up by refId)',
                             },
                         },
                         required: ['item_id'],
@@ -589,9 +600,9 @@ class WolfpackMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            project_id: {
-                                type: 'number',
-                                description: 'Project ID (required for multi-project users, use list_projects to get IDs)',
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
                             },
                             status: {
                                 type: 'string',
@@ -648,9 +659,9 @@ class WolfpackMCPServer {
                                 type: 'string',
                                 description: 'The ID (UUID) or refId (number) of the issue',
                             },
-                            project_id: {
-                                type: 'number',
-                                description: 'Project ID (required when looking up by refId)',
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (required when looking up by refId)',
                             },
                         },
                         required: ['issue_id'],
@@ -663,13 +674,18 @@ class WolfpackMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                            },
                             title: { type: 'string', description: 'Title of the work item' },
                             description: {
                                 type: 'string',
-                                description: 'Description/notes for the work item (markdown). Supports base64-encoded images which will be auto-uploaded.',
+                                description: 'Description/notes for the work item (markdown)',
                             },
                             status: {
                                 type: 'string',
+                                enum: ['pending', 'new', 'doing', 'blocked', 'review', 'ready', 'completed'],
                                 description: 'Initial status: "pending" (backlog), "new" (to do), "doing", "review", "ready", "blocked", "completed". Defaults to "new".',
                             },
                             priority: {
@@ -698,6 +714,10 @@ class WolfpackMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                            },
                             title: { type: 'string', description: 'Title of the issue' },
                             description: { type: 'string', description: 'Description of the issue' },
                             severity: {
@@ -756,6 +776,10 @@ class WolfpackMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                            },
                             search: {
                                 type: 'string',
                                 description: 'Text search in title and content',
@@ -794,6 +818,10 @@ class WolfpackMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                            },
                             slug: {
                                 type: 'string',
                                 description: 'URL slug for the page (without team prefix). The system automatically prepends the team and wiki path. For example, to create a page at "myteam/wiki/guides/onboarding", pass just "guides/onboarding". Do NOT include the team slug or "wiki/" prefix.',
@@ -801,7 +829,7 @@ class WolfpackMCPServer {
                             title: { type: 'string', description: 'Page title' },
                             content: {
                                 type: 'string',
-                                description: 'Page content (markdown). Supports base64-encoded images (e.g., ![alt](data:image/png;base64,...)) which will be auto-uploaded.',
+                                description: 'Page content (markdown)',
                             },
                         },
                         required: ['slug', 'title', 'content'],
@@ -817,7 +845,7 @@ class WolfpackMCPServer {
                             title: { type: 'string', description: 'Updated title' },
                             content: {
                                 type: 'string',
-                                description: 'Updated content (markdown). Supports base64-encoded images which will be auto-uploaded.',
+                                description: 'Updated content (markdown)',
                             },
                         },
                         required: ['page_id'],
@@ -830,6 +858,10 @@ class WolfpackMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                            },
                             search: {
                                 type: 'string',
                                 description: 'Text search in title and content',
@@ -855,9 +887,9 @@ class WolfpackMCPServer {
                         type: 'object',
                         properties: {
                             entry_id: { type: 'string', description: 'The entry UUID or refId' },
-                            project_id: {
-                                type: 'number',
-                                description: 'Project ID (required when looking up by refId)',
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (required when looking up by refId)',
                             },
                         },
                         required: ['entry_id'],
@@ -869,10 +901,14 @@ class WolfpackMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                            },
                             title: { type: 'string', description: 'Entry title' },
                             content: {
                                 type: 'string',
-                                description: 'Entry content (markdown). Supports base64-encoded images which will be auto-uploaded.',
+                                description: 'Entry content (markdown)',
                             },
                             date: { type: 'string', description: 'Entry date (ISO format, defaults to now)' },
                         },
@@ -889,7 +925,7 @@ class WolfpackMCPServer {
                             title: { type: 'string', description: 'Updated title' },
                             content: {
                                 type: 'string',
-                                description: 'Updated content (markdown). Supports base64-encoded images which will be auto-uploaded.',
+                                description: 'Updated content (markdown)',
                             },
                         },
                         required: ['entry_id'],
@@ -934,7 +970,7 @@ class WolfpackMCPServer {
                             work_item_id: { type: 'string', description: 'The work item UUID' },
                             content: {
                                 type: 'string',
-                                description: 'Comment content (markdown). Supports base64-encoded images which will be auto-uploaded.',
+                                description: 'Comment content (markdown)',
                             },
                         },
                         required: ['work_item_id', 'content'],
@@ -949,7 +985,7 @@ class WolfpackMCPServer {
                             issue_id: { type: 'string', description: 'The issue UUID' },
                             content: {
                                 type: 'string',
-                                description: 'Comment content (markdown). Supports base64-encoded images which will be auto-uploaded.',
+                                description: 'Comment content (markdown)',
                             },
                         },
                         required: ['issue_id', 'content'],
@@ -959,8 +995,10 @@ class WolfpackMCPServer {
                 {
                     name: 'upload_image',
                     description: 'Upload an image file from disk and get back a permanent URL. ' +
-                        'Reads the file directly from disk, avoiding slow base64 token generation. ' +
+                        'Reads the file directly from disk. ' +
                         'Returns a markdown image URL you can include in any content field. ' +
+                        'IMPORTANT: This tool requires direct filesystem access and may not work in sandboxed environments (e.g. Claude.ai, Claude Desktop). ' +
+                        'If the MCP server cannot access the file path, inform the user that image uploads are not supported in their environment. ' +
                         'Requires mcp:images:upload permission.',
                     inputSchema: {
                         type: 'object',
@@ -970,9 +1008,9 @@ class WolfpackMCPServer {
                                 description: 'Absolute path to an image file on disk (e.g., "/tmp/screenshot.png"). ' +
                                     'Supported formats: JPEG, PNG, GIF, WebP. Max 5MB.',
                             },
-                            project_id: {
-                                type: 'number',
-                                description: 'Project ID (required for multi-project users, use list_projects to get IDs)',
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
                             },
                         },
                         required: ['file_path'],
@@ -1004,17 +1042,17 @@ class WolfpackMCPServer {
                     // Project handlers
                     case 'list_projects': {
                         const teams = await this.client.listProjects();
-                        const currentTeamId = this.client.getProjectId();
+                        const currentProjectSlug = this.client.getProjectSlug();
                         return {
                             content: [
                                 {
                                     type: 'text',
                                     text: JSON.stringify({
                                         projects: teams,
-                                        currentProjectId: currentTeamId,
+                                        currentProjectSlug,
                                         hint: teams.length === 1
                                             ? 'Only one project available - it will be used automatically.'
-                                            : 'Multiple projects available. Use project_id parameter in other tools to specify which project to use.',
+                                            : 'Multiple projects available. Use project_slug parameter in other tools to specify which project to use.',
                                     }, null, 2),
                                 },
                             ],
@@ -1024,7 +1062,7 @@ class WolfpackMCPServer {
                     case 'list_work_items': {
                         const parsed = ListWorkItemsSchema.parse(args);
                         const result = await this.client.listWorkItems({
-                            teamId: parsed.project_id || this.client.getProjectId() || undefined,
+                            teamSlug: parsed.project_slug || this.client.getProjectSlug() || undefined,
                             status: parsed.status,
                             assignedToId: parsed.assigned_to_id,
                             search: parsed.search,
@@ -1050,7 +1088,7 @@ class WolfpackMCPServer {
                     }
                     case 'get_work_item': {
                         const parsed = GetWorkItemSchema.parse(args);
-                        const workItem = await this.client.getWorkItem(parsed.work_item_id, parsed.project_id || this.client.getProjectId() || undefined);
+                        const workItem = await this.client.getWorkItem(parsed.work_item_id, parsed.project_slug || this.client.getProjectSlug() || undefined);
                         if (workItem) {
                             let text = JSON.stringify(workItem, null, 2);
                             // Add hint if no plan detected in description
@@ -1146,7 +1184,7 @@ class WolfpackMCPServer {
                     case 'list_radar_items': {
                         const parsed = ListRadarItemsSchema.parse(args);
                         const result = await this.client.listRadarItems({
-                            teamId: parsed.project_id,
+                            teamSlug: parsed.project_slug,
                             stage: parsed.stage,
                             search: parsed.search,
                             limit: parsed.limit,
@@ -1162,7 +1200,7 @@ class WolfpackMCPServer {
                     }
                     case 'get_radar_item': {
                         const parsed = GetRadarItemSchema.parse(args);
-                        const radarItem = await this.client.getRadarItem(parsed.item_id, parsed.project_id);
+                        const radarItem = await this.client.getRadarItem(parsed.item_id, parsed.project_slug);
                         if (radarItem) {
                             return {
                                 content: [{ type: 'text', text: JSON.stringify(radarItem, null, 2) }],
@@ -1176,7 +1214,7 @@ class WolfpackMCPServer {
                     case 'list_issues': {
                         const parsed = ListIssuesSchema.parse(args);
                         const result = await this.client.listIssues({
-                            teamId: parsed.project_id,
+                            teamSlug: parsed.project_slug,
                             status: parsed.status,
                             severity: parsed.severity,
                             type: parsed.type,
@@ -1199,7 +1237,7 @@ class WolfpackMCPServer {
                     }
                     case 'get_issue': {
                         const parsed = GetIssueSchema.parse(args);
-                        const issue = await this.client.getIssue(parsed.issue_id, parsed.project_id);
+                        const issue = await this.client.getIssue(parsed.issue_id, parsed.project_slug);
                         if (issue) {
                             return {
                                 content: [{ type: 'text', text: JSON.stringify(issue, null, 2) }],
@@ -1220,6 +1258,7 @@ class WolfpackMCPServer {
                             leadingUserId: parsed.leading_user_id,
                             categoryId: parsed.category_id,
                             radarItemId: parsed.radar_item_id,
+                            teamSlug: parsed.project_slug || this.client.getProjectSlug() || undefined,
                         });
                         return {
                             content: [
@@ -1244,6 +1283,7 @@ class WolfpackMCPServer {
                             stepsToReproduce: parsed.steps_to_reproduce,
                             expectedBehavior: parsed.expected_behavior,
                             actualBehavior: parsed.actual_behavior,
+                            teamSlug: parsed.project_slug || this.client.getProjectSlug() || undefined,
                         });
                         return {
                             content: [
@@ -1277,6 +1317,7 @@ class WolfpackMCPServer {
                     case 'list_wiki_pages': {
                         const parsed = ListWikiPagesSchema.parse(args);
                         const result = await this.client.listWikiPages({
+                            teamSlug: parsed.project_slug || this.client.getProjectSlug() || undefined,
                             search: parsed.search,
                             dateFrom: parsed.date_from,
                             dateTo: parsed.date_to,
@@ -1309,6 +1350,7 @@ class WolfpackMCPServer {
                             slug: parsed.slug,
                             title: parsed.title,
                             content: parsed.content,
+                            teamSlug: parsed.project_slug || this.client.getProjectSlug() || undefined,
                         });
                         return {
                             content: [
@@ -1338,6 +1380,7 @@ class WolfpackMCPServer {
                     case 'list_journal_entries': {
                         const parsed = ListJournalEntriesSchema.parse(args);
                         const result = await this.client.listJournalEntries({
+                            teamSlug: parsed.project_slug || this.client.getProjectSlug() || undefined,
                             search: parsed.search,
                             dateFrom: parsed.date_from,
                             dateTo: parsed.date_to,
@@ -1354,7 +1397,7 @@ class WolfpackMCPServer {
                     }
                     case 'get_journal_entry': {
                         const parsed = GetJournalEntrySchema.parse(args);
-                        const entry = await this.client.getJournalEntry(parsed.entry_id, parsed.project_id);
+                        const entry = await this.client.getJournalEntry(parsed.entry_id, parsed.project_slug);
                         if (entry) {
                             return {
                                 content: [{ type: 'text', text: JSON.stringify(entry, null, 2) }],
@@ -1370,6 +1413,7 @@ class WolfpackMCPServer {
                             title: parsed.title,
                             content: parsed.content,
                             date: parsed.date,
+                            teamSlug: parsed.project_slug || this.client.getProjectSlug() || undefined,
                         });
                         return {
                             content: [
@@ -1440,7 +1484,7 @@ class WolfpackMCPServer {
                     }
                     case 'upload_image': {
                         const parsed = UploadImageSchema.parse(args);
-                        const teamSlug = await this.client.resolveSlug(parsed.project_id || this.client.getProjectId() || undefined);
+                        const teamSlug = await this.client.resolveSlug(parsed.project_slug || this.client.getProjectSlug() || undefined);
                         const filePath = resolve(parsed.file_path);
                         // Validate file extension
                         const ext = extname(filePath).toLowerCase();
@@ -1540,8 +1584,8 @@ class WolfpackMCPServer {
         if (config.projectSlug) {
             // Explicit project slug configured - use it
             try {
-                const teamId = await this.client.resolveProjectSlug(config.projectSlug);
-                console.error(`Resolved project "${config.projectSlug}" to ID: ${teamId}`);
+                await this.client.resolveProjectSlug(config.projectSlug);
+                console.error(`Resolved project: "${config.projectSlug}"`);
             }
             catch (error) {
                 console.error(`Failed to resolve project slug: ${error instanceof Error ? error.message : String(error)}`);
@@ -1554,14 +1598,14 @@ class WolfpackMCPServer {
                 const teams = await this.client.listProjects();
                 if (teams.length === 1) {
                     // Auto-select the only project
-                    this.client.setProjectId(teams[0].id);
+                    this.client.setProjectSlug(teams[0].slug);
                     console.error(`Auto-selected project: ${teams[0].name} (${teams[0].slug})`);
                 }
                 else if (teams.length === 0) {
                     console.error('Warning: No projects found for this API key');
                 }
                 else {
-                    console.error(`Multiple projects available (${teams.length}). Use list_projects tool to see them, then specify project_id in tool calls.`);
+                    console.error(`Multiple projects available (${teams.length}). Use list_projects tool to see them, then specify project_slug in tool calls.`);
                 }
             }
             catch (error) {

package/package.json

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