@postman/postman-mcp-server 2.6.0 → 2.7.0

package/dist/src/tools/updatePanElementOrFolder.js

@@ -65,7 +65,7 @@ export const parameters = z.object({
     ]),
 });
 export const annotations = {
-    title: "Updates an element or folder in your team's [Private API Network](https://learning.postman.com/docs/collaborating-in-postman/adding-private-network/).\n\n**Note:**\n\nYou can only pass one element object type per call. For example, you cannot pass both \\`api\\` and \\`collection\\` in a single request.\n",
+    title: "Updates an element or folder in your team's [Private API Network](https://learning.postman.com/docs/collaborating-in-postman/adding-private-network/).",
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/updateRequestComment.js

@@ -22,7 +22,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Updates a comment on a request.\n\n**Note:**\n\nThis endpoint accepts a max of 10,000 characters.\n',
+    title: 'Updates a comment on a request.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/updateResponseComment.js

@@ -22,7 +22,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Updates a comment on a response.\n\n**Note:**\n\nThis endpoint accepts a max of 10,000 characters.\n',
+    title: 'Updates a comment on a response.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/updateSpecFile.js

@@ -14,7 +14,7 @@ export const parameters = z.object({
     content: z.string().describe("The specification's stringified contents.").optional(),
 });
 export const annotations = {
-    title: "Updates an API specification's file.\n\n**Note:**\n\n- This endpoint does not accept an empty request body. You must pass one of the accepted values.\n- This endpoint does not accept multiple request body properties in a single call. For example, you cannot pass both the \\`content\\` and \\`type\\` property at the same time.\n- Multi-file specifications can only have one root file.\n- When updating a file type to \\`ROOT\\`, the previous root file is updated to the \\`DEFAULT\\` file type.\n- Files cannot exceed a maximum of 10 MB in size.\n",
+    title: "Updates an API specification's file.",
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/updateWorkspace.js

@@ -18,7 +18,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Updates a workspace.\n\n**Note:**\n\n- There are rate limits when publishing public workspaces.\n- Public team workspace names must be unique.\n\n### Important\n\nWe deprecated linking collections or environments between workspaces. We do not recommend that you do this.\n\nIf you have a linked collection or environment, note the following:\n- The endpoint does not create a clone of a collection or environment.\n- Any changes you make to a linked collection or environment changes them in all workspaces.\n- If you delete a collection or environment linked between workspaces, the system deletes it in all the workspaces.\n',
+    title: 'Updates a workspace.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/utils/templateRenderer.js

@@ -0,0 +1,23 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import nunjucks from 'nunjucks';
+export function createTemplateRenderer(viewsDir) {
+    const env = nunjucks.configure(viewsDir, {
+        autoescape: false,
+        noCache: false,
+        throwOnUndefined: false,
+    });
+    env.addFilter('default', (val, defaultVal = '') => val === undefined || val === null ? defaultVal : val);
+    return (toolName, rawText) => {
+        const templatePath = join(viewsDir, `${toolName}.njk`);
+        if (!existsSync(templatePath))
+            return null;
+        try {
+            const data = JSON.parse(rawText);
+            return env.render(`${toolName}.njk`, data);
+        }
+        catch {
+            return null;
+        }
+    };
+}

package/dist/src/views/getCollections.njk

@@ -0,0 +1,12 @@
+# Collections
+
+## Meta
+
+- **total**: {{ meta.total }}
+- **offset**: {{ meta.offset }}
+- **limit**: {{ meta.limit }}
+
+| id | name | owner | createdAt | updatedAt | uid | fork | isPublic |
+|---|---|---|---|---|---|---|---|
+{% for item in collections %}| {{ item.id }} | {{ item.name }} | {{ item.owner }} | {{ item.createdAt }} | {{ item.updatedAt }} | {{ item.uid }} | {{ item.fork | dump }} | {{ item.isPublic }} |
+{% endfor %}

package/dist/src/views/getWorkspaces.njk

@@ -0,0 +1,6 @@
+# Workspaces
+
+| id | name | type | visibility | createdBy | scim |
+|---|---|---|---|---|---|
+{% for item in workspaces %}| {{ item.id }} | {{ item.name }} | {{ item.type }} | {{ item.visibility }} | {{ item.createdBy }} | {{ item.scim | dump }} |
+{% endfor %}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postman/postman-mcp-server",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "A simple MCP server to operate on the Postman API",
   "mcpName": "com.postman/postman-mcp-server",
   "main": "dist/src/index.js",
@@ -30,6 +30,7 @@
     "@modelcontextprotocol/sdk": "^1.25.2",
     "dotenv": "^17.2.3",
     "newman": "^6.2.0",
+    "nunjucks": "^3.2.4",
     "uuid": "^13.0.0",
     "zod": "^3.25.76"
   },