@ecubelabs/atlassian-mcp 1.9.0 → 1.10.0

package/dist/confluence-tools/add-labels-to-page.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerAddLabelsToPage = (server, confluenceService) => {
     server.tool('add-labels-to-page', 'Add one or more labels to a Confluence page', {
         pageId: z.string().describe('ID of the page to add labels to'),
@@ -14,14 +15,9 @@ export const registerAddLabelsToPage = (server, confluenceService) => {
     }, async ({ pageId, labels }) => {
         try {
             const result = await confluenceService.addLabelsToPage(pageId, labels);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'add-labels-to-page',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/create-folder.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerCreateFolder = (server, confluenceService) => {
     server.tool('create-folder', 'Create a new folder in a Confluence space. Folders can contain pages and other folders.', {
         spaceId: z.string().describe('ID of the space where the folder will be created'),
@@ -14,14 +15,9 @@ export const registerCreateFolder = (server, confluenceService) => {
                 title,
                 parentId,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'create-folder',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/create-page.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerCreatePage = (server, confluenceService) => {
     server.tool('create-page', '⚠️ Create a new Confluence page. 🚫 CRITICAL: NEVER use wiki markup ({info}, {code}), placeholder text ([Info Panel]), or plain text for Jira/dates/users. ✅ MANDATORY: MUST use confluence-storage-format-help tool BEFORE calling this. ONLY use storage format XML: <ac:structured-macro> for macros, <time> for dates, <ac:link> for users.', {
         spaceId: z.string().describe('ID of the space where the page will be created'),
@@ -28,14 +29,9 @@ export const registerCreatePage = (server, confluenceService) => {
                 status,
                 parentId,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'create-page',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/delete-folder.js

@@ -1,18 +1,14 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerDeleteFolder = (server, confluenceService) => {
     server.tool('delete-folder', 'Delete a Confluence folder. The folder will be moved to trash where it can be restored later.', {
         folderId: z.string().describe('ID of the folder to delete'),
     }, async ({ folderId }) => {
         try {
             await confluenceService.deleteFolder(folderId);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({ success: true, message: `Folder ${folderId} has been deleted (moved to trash)` }),
-                    },
-                ],
-            };
+            return formatToolResponse({ success: true, message: `Folder ${folderId} has been deleted (moved to trash)` }, {
+                toolName: 'delete-folder',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/find-label-by-name.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerFindLabelByName = (server, confluenceService) => {
     server.tool('find-label-by-name', 'Find a specific label by its name', {
         labelName: z.string().describe('Name of the label to find'),
@@ -6,14 +7,9 @@ export const registerFindLabelByName = (server, confluenceService) => {
         try {
             const label = await confluenceService.findLabelByName(labelName);
             if (label) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify(label),
-                        },
-                    ],
-                };
+                return formatToolResponse(label, {
+                    toolName: 'find-label-by-name',
+                });
             }
             else {
                 return {

package/dist/confluence-tools/find-pages-by-label-name.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerFindPagesByLabelName = (server, confluenceService) => {
     server.tool('find-pages-by-label-name', 'Find pages by label name (convenience tool that combines label search and page retrieval)', {
         labelName: z
@@ -36,14 +37,9 @@ export const registerFindPagesByLabelName = (server, confluenceService) => {
                 cursor,
                 limit,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'find-pages-by-label-name',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/find-space-by-name.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerFindSpaceByName = (server, confluenceService) => {
     server.tool('find-space-by-name', 'Find a space by its name', {
         spaceName: z.string().describe('Name of the space to find'),
@@ -6,14 +7,9 @@ export const registerFindSpaceByName = (server, confluenceService) => {
         try {
             const space = await confluenceService.findSpaceByName(spaceName);
             if (space) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify(space),
-                        },
-                    ],
-                };
+                return formatToolResponse(space, {
+                    toolName: 'find-space-by-name',
+                });
             }
             else {
                 return {

package/dist/confluence-tools/get-folder-by-id.js

@@ -1,18 +1,14 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetFolderById = (server, confluenceService) => {
     server.tool('get-folder-by-id', 'Get details of a specific Confluence folder by its ID.', {
         folderId: z.string().describe('ID of the folder to retrieve'),
     }, async ({ folderId }) => {
         try {
             const result = await confluenceService.getFolderById(folderId);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'get-folder-by-id',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/get-folder-children.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetFolderChildren = (server, confluenceService) => {
     server.tool('get-folder-children', 'Get direct children (pages, folders, etc.) of a Confluence folder. Use type filter to retrieve only specific content types.', {
         folderId: z.string().describe('ID of the folder'),
@@ -38,17 +39,12 @@ export const registerGetFolderChildren = (server, confluenceService) => {
             if (type) {
                 filteredResults = result.results.filter((child) => child.type === type);
             }
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            ...result,
-                            results: filteredResults,
-                        }),
-                    },
-                ],
-            };
+            return formatToolResponse({
+                ...result,
+                results: filteredResults,
+            }, {
+                toolName: 'get-folder-children',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/get-labels.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetLabels = (server, confluenceService) => {
     server.tool('get-labels', 'Get list of labels from Confluence', {
         ids: z.array(z.string()).optional().describe('Filter labels by IDs'),
@@ -23,14 +24,9 @@ export const registerGetLabels = (server, confluenceService) => {
                 limit,
                 sort,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'get-labels',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/get-page-by-id.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetPageById = (server, confluenceService) => {
     server.tool('get-page-by-id', 'Get a specific page by its ID', {
         pageId: z.string().describe('ID of the page to retrieve'),
@@ -15,14 +16,10 @@ export const registerGetPageById = (server, confluenceService) => {
                 getDraft,
                 version,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(page),
-                    },
-                ],
-            };
+            return formatToolResponse(page, {
+                toolName: 'get-page-by-id',
+                summary: `Page: ${page.title ?? ''} (id: ${page.id ?? pageId})`,
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/get-page-children-tree.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetPageChildrenTree = (server, confluenceService) => {
     server.tool('get-page-children-tree', 'Get the complete hierarchical tree of child pages for a specific page (recursive)', {
         pageId: z.string().describe('ID of the root page'),
@@ -34,14 +35,10 @@ export const registerGetPageChildrenTree = (server, confluenceService) => {
                 limit,
                 sort,
             }, maxDepth);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
+            return formatToolResponse(JSON.stringify(result, null, 2), {
+                toolName: 'get-page-children-tree',
+                summary: `Page tree: ${Array.isArray(result) ? result.length : 0} items`,
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/get-page-children.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetPageChildren = (server, confluenceService) => {
     server.tool('get-page-children', 'Get direct children (pages, folders, etc.) of a specific page. Use type filter to retrieve only specific content types.', {
         pageId: z.string().describe('ID of the parent page'),
@@ -38,17 +39,12 @@ export const registerGetPageChildren = (server, confluenceService) => {
             if (type) {
                 filteredResults = result.results.filter((child) => child.type === type);
             }
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            ...result,
-                            results: filteredResults,
-                        }),
-                    },
-                ],
-            };
+            return formatToolResponse({
+                ...result,
+                results: filteredResults,
+            }, {
+                toolName: 'get-page-children',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/get-page-descendants.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetPageDescendants = (server, confluenceService) => {
     server.tool('get-page-descendants', 'Get all descendants (children, grandchildren, etc.) of a specific page. Useful for getting the entire hierarchy under a page.', {
         pageId: z.string().describe('ID of the page'),
@@ -26,14 +27,9 @@ export const registerGetPageDescendants = (server, confluenceService) => {
                 start,
                 limit,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'get-page-descendants',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/get-pages-for-label.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetPagesForLabel = (server, confluenceService) => {
     server.tool('get-pages-for-label', 'Get pages associated with a specific label', {
         labelId: z.string().describe('ID of the label to search for'),
@@ -34,14 +35,9 @@ export const registerGetPagesForLabel = (server, confluenceService) => {
                 cursor,
                 limit,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'get-pages-for-label',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/get-pages.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetPages = (server, confluenceService) => {
     server.tool('get-pages', 'Get list of pages from Confluence', {
         id: z.array(z.string()).optional().describe('List of page IDs to retrieve'),
@@ -44,14 +45,10 @@ export const registerGetPages = (server, confluenceService) => {
                 limit,
                 sort,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'get-pages',
+                summary: `Found ${result.results?.length ?? 0} pages`,
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/get-recently-created-pages.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetRecentlyCreatedPages = (server, confluenceService) => {
     server.tool('get-recently-created-pages', 'Get recently created pages from Confluence (sorted by creation date)', {
         spaceId: z.array(z.string()).optional().describe('Filter by space IDs'),
@@ -19,14 +20,9 @@ export const registerGetRecentlyCreatedPages = (server, confluenceService) => {
                 limit,
                 bodyFormat,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'get-recently-created-pages',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/get-recently-updated-pages.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetRecentlyUpdatedPages = (server, confluenceService) => {
     server.tool('get-recently-updated-pages', 'Get recently updated pages from Confluence (sorted by modification date)', {
         spaceId: z.array(z.string()).optional().describe('Filter by space IDs'),
@@ -19,14 +20,9 @@ export const registerGetRecentlyUpdatedPages = (server, confluenceService) => {
                 limit,
                 bodyFormat,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'get-recently-updated-pages',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/get-space-by-id.js

@@ -1,18 +1,14 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetSpaceById = (server, confluenceService) => {
     server.tool('get-space-by-id', 'Get a specific space by its ID', {
         spaceId: z.string().describe('ID of the space to retrieve'),
     }, async ({ spaceId }) => {
         try {
             const space = await confluenceService.getSpaceById(spaceId);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(space),
-                    },
-                ],
-            };
+            return formatToolResponse(space, {
+                toolName: 'get-space-by-id',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/get-space-root-content.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetSpaceRootContent = (server, confluenceService) => {
     server.tool('get-space-root-content', "Get root-level content (pages, folders, etc.) of a Confluence space. This retrieves the direct children of the space's homepage.", {
         spaceId: z.string().describe('ID of the space'),
@@ -34,14 +35,9 @@ export const registerGetSpaceRootContent = (server, confluenceService) => {
                 limit,
                 sort,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'get-space-root-content',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/get-spaces.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetSpaces = (server, confluenceService) => {
     server.tool('get-spaces', 'Get list of spaces from Confluence', {
         id: z.array(z.string()).optional().describe('Filter spaces by IDs'),
@@ -44,14 +45,9 @@ export const registerGetSpaces = (server, confluenceService) => {
                 cursor,
                 limit,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'get-spaces',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/get-template-by-id.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetTemplateById = (server, confluenceService) => {
     server.tool('get-template-by-id', 'Get a specific content template by its ID. Returns detailed template information including name, description, space, labels, and optionally the template body content.', {
         contentTemplateId: z.string().describe('The ID of the content template to retrieve'),
@@ -11,14 +12,9 @@ export const registerGetTemplateById = (server, confluenceService) => {
             const result = await confluenceService.getTemplateById(contentTemplateId, {
                 expand,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'get-template-by-id',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/get-templates.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerGetTemplates = (server, confluenceService) => {
     server.tool('get-templates', 'Get list of content templates from Confluence. Returns global templates if no spaceKey is provided, or space-specific templates when spaceKey is specified.', {
         spaceKey: z
@@ -28,14 +29,9 @@ export const registerGetTemplates = (server, confluenceService) => {
                 limit,
                 expand,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'get-templates',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/move-page.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerMovePage = (server, confluenceService) => {
     server.tool('move-page', 'Move a Confluence page to a new location. Use position "append" to move the page as a child of the target (page or folder). Use "before" or "after" to move the page as a sibling of the target.', {
         pageId: z.string().describe('ID of the page to move'),
@@ -15,14 +16,9 @@ export const registerMovePage = (server, confluenceService) => {
                 targetId,
                 position,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'move-page',
+            });
         }
         catch (error) {
             return {

package/dist/confluence-tools/update-page.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { formatToolResponse } from '../libs/response-formatter.js';
 export const registerUpdatePage = (server, confluenceService) => {
     server.tool('update-page', '⚠️ Update an existing Confluence page. 🚫 CRITICAL: NEVER use wiki markup ({info}, {code}), placeholder text ([Info Panel]), or plain text for Jira/dates/users. ✅ MANDATORY: MUST use confluence-storage-format-help tool BEFORE calling this. ONLY use storage format XML: <ac:structured-macro> for macros, <time> for dates, <ac:link> for users.', {
         pageId: z.string().describe('ID of the page to update'),
@@ -31,14 +32,9 @@ export const registerUpdatePage = (server, confluenceService) => {
                 },
                 status,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result),
-                    },
-                ],
-            };
+            return formatToolResponse(result, {
+                toolName: 'update-page',
+            });
         }
         catch (error) {
             return {

package/dist/index.js

@@ -4,6 +4,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { registerJiraTools } from './jira-tools-register.js';
 import { registerConfluenceTools } from './confluence-tools-register.js';
+import { cleanupOldTempFiles } from './libs/response-formatter.js';
 // Create server instance
 const server = new McpServer({
     name: 'atlassian',
@@ -13,6 +14,7 @@ registerJiraTools(server);
 registerConfluenceTools(server);
 // Start the server
 async function main() {
+    cleanupOldTempFiles();
     const transport = new StdioServerTransport();
     await server.connect(transport);
     /**