@fruition/fcp-mcp-server 1.22.0 → 1.23.0

package/dist/index.js

@@ -165,6 +165,7 @@ const TOOL_PERMISSIONS = {
     unroo_list_tasks: 'viewer',
     unroo_get_task: 'viewer',
     unroo_list_comments: 'viewer',
+    unroo_list_attachments: 'viewer',
     unroo_get_my_tasks: 'viewer',
     unroo_get_parking_lot: 'viewer',
     unroo_get_backlog: 'viewer',
@@ -842,6 +843,18 @@ class UnrooClient {
         return this.fetch(`/api/external/fcp/tasks/${encodeURIComponent(taskId)}/comments`);
     }
     // ============================================================================
+    // Attachment APIs
+    // ============================================================================
+    async listAttachments(taskId, opts = {}) {
+        const params = new URLSearchParams();
+        if (opts.includeContent)
+            params.set('include_content', 'true');
+        const query = params.toString();
+        // Inline image fetches can be slow if the bucket has cold objects; give it
+        // a longer timeout than the default 15s.
+        return this.fetch(`/api/external/fcp/tasks/${encodeURIComponent(taskId)}/attachments${query ? `?${query}` : ''}`, {}, 60_000);
+    }
+    // ============================================================================
     // Parking Lot / Backlog APIs
     // ============================================================================
     async logFutureWork(input) {
@@ -1825,6 +1838,24 @@ const TOOLS = [
             required: ['task_id'],
         },
     },
+    {
+        name: 'unroo_list_attachments',
+        description: 'List file attachments on an Unroo task. Use this to see screenshots, logs, or other files attached to a bug report or ticket. By default, image and text attachments are embedded inline so you can view them directly; pass include_content=false to get metadata only (faster for large attachments).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                task_id: {
+                    type: 'string',
+                    description: 'Task ID or Jira key (e.g., task_abc123 or FLYFRU-189)',
+                },
+                include_content: {
+                    type: 'boolean',
+                    description: 'When true (default), embed image and text content inline. Set to false to return metadata only.',
+                },
+            },
+            required: ['task_id'],
+        },
+    },
     {
         name: 'unroo_get_my_tasks',
         description: 'Get tasks assigned to the current user (based on API key). Useful for finding your work items.',
@@ -3643,6 +3674,57 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case 'unroo_list_attachments': {
+                const { task_id, include_content } = args;
+                const includeContent = include_content !== false; // default true
+                const result = await unrooClient.listAttachments(task_id, { includeContent });
+                // Summary block: metadata only, no base64 bodies (those go into image/text blocks below).
+                const summary = {
+                    total: result.total,
+                    attachments: result.attachments.map((a) => ({
+                        id: a.id,
+                        file_name: a.file_name,
+                        file_size: a.file_size,
+                        mime_type: a.mime_type,
+                        uploaded_by: a.uploaded_by,
+                        created_at: a.created_at,
+                        file_url: a.file_url,
+                        jira_attachment_id: a.jira_attachment_id,
+                        inlined: !!a.content_base64,
+                        content_omitted_reason: a.content_omitted_reason,
+                    })),
+                };
+                const content = [
+                    { type: 'text', text: JSON.stringify(summary, null, 2) },
+                ];
+                if (includeContent) {
+                    for (const a of result.attachments) {
+                        if (!a.content_base64)
+                            continue;
+                        if (a.content_kind === 'image') {
+                            content.push({
+                                type: 'image',
+                                data: a.content_base64,
+                                mimeType: a.mime_type || 'application/octet-stream',
+                            });
+                        }
+                        else if (a.content_kind === 'text') {
+                            let decoded;
+                            try {
+                                decoded = Buffer.from(a.content_base64, 'base64').toString('utf8');
+                            }
+                            catch {
+                                decoded = '[failed to decode text content]';
+                            }
+                            content.push({
+                                type: 'text',
+                                text: `--- ${a.file_name} (${a.mime_type || 'text'}) ---\n${decoded}`,
+                            });
+                        }
+                    }
+                }
+                return { content };
+            }
             case 'unroo_get_my_tasks': {
                 const { status, limit } = args;
                 // Note: The API key determines the user, tasks are filtered server-side

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fruition/fcp-mcp-server",
-  "version": "1.22.0",
+  "version": "1.23.0",
   "description": "MCP Server for FCP Launch Coordination System - enables Claude Code to interact with FCP launches and track development time",
   "main": "dist/index.js",
   "type": "module",