@postman/postman-mcp-server 2.2.0 → 2.3.0

package/dist/src/tools/updateCollectionResponse.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -25,16 +25,16 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/${params.collectionId}/responses/${params.responseId}`;
+        const endpoint = `/collections/${args.collectionId}/responses/${args.responseId}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.name !== undefined)
-            bodyPayload.name = params.name;
-        if (params.responseCode !== undefined)
-            bodyPayload.responseCode = params.responseCode;
+        if (args.name !== undefined)
+            bodyPayload.name = args.name;
+        if (args.responseCode !== undefined)
+            bodyPayload.responseCode = args.responseCode;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/updateCollectionTags.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -30,14 +30,14 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/${params.collectionId}/tags`;
+        const endpoint = `/collections/${args.collectionId}/tags`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.tags !== undefined)
-            bodyPayload.tags = params.tags;
+        if (args.tags !== undefined)
+            bodyPayload.tags = args.tags;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/updateFolderComment.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -31,16 +31,16 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/${params.collectionId}/folders/${params.folderId}/comments/${params.commentId}`;
+        const endpoint = `/collections/${args.collectionId}/folders/${args.folderId}/comments/${args.commentId}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.body !== undefined)
-            bodyPayload.body = params.body;
-        if (params.tags !== undefined)
-            bodyPayload.tags = params.tags;
+        if (args.body !== undefined)
+            bodyPayload.body = args.body;
+        if (args.tags !== undefined)
+            bodyPayload.tags = args.tags;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/updateMock.js

@@ -1,12 +1,12 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
 }
 export const method = 'updateMock';
-export const description = 'Updates a mock server.';
+export const description = 'Updates a mock server.\n- Resource: Mock server entity associated with a collection UID.\n- Use this to change name, environment, privacy, or default server response.\n';
 export const parameters = z.object({
     mockId: z.string().describe("The mock's ID."),
     mock: z
@@ -33,19 +33,19 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Updates a mock server.',
+    title: 'Updates a mock server.\n- Resource: Mock server entity associated with a collection UID.\n- Use this to change name, environment, privacy, or default server response.\n',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/mocks/${params.mockId}`;
+        const endpoint = `/mocks/${args.mockId}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.mock !== undefined)
-            bodyPayload.mock = params.mock;
+        if (args.mock !== undefined)
+            bodyPayload.mock = args.mock;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/updateMonitor.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -117,14 +117,14 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/monitors/${params.monitorId}`;
+        const endpoint = `/monitors/${args.monitorId}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.monitor !== undefined)
-            bodyPayload.monitor = params.monitor;
+        if (args.monitor !== undefined)
+            bodyPayload.monitor = args.monitor;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/updatePanElementOrFolder.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { ContentType } from '../clients/postman.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -11,6 +12,61 @@ export const parameters = z.object({
         .string()
         .describe("The element's ID or UUID. For Postman Collections you must pass the collection's UID (`userId`-`collectionId`) value."),
     elementType: z.enum(['api', 'folder', 'collection', 'workspace']).describe('The element type.'),
+    body: z.union([
+        z.object({
+            api: z
+                .object({
+                parentFolderId: z.number().int().describe("The API's new parent folder ID.").optional(),
+            })
+                .optional(),
+        }),
+        z.object({
+            collection: z
+                .object({
+                parentFolderId: z
+                    .number()
+                    .int()
+                    .describe("The collection's new parent folder ID.")
+                    .optional(),
+                environments: z
+                    .object({
+                    $add: z
+                        .array(z.string().describe('The ID of environment to add to the collection.'))
+                        .optional(),
+                    $remove: z
+                        .array(z.string().describe('The ID of environment to remove from the collection.'))
+                        .optional(),
+                })
+                    .describe("The collection's updated environments.")
+                    .optional(),
+            })
+                .optional(),
+        }),
+        z.object({
+            workspace: z
+                .object({
+                parentFolderId: z
+                    .number()
+                    .int()
+                    .describe("The workspace's new parent folder ID.")
+                    .optional(),
+            })
+                .optional(),
+        }),
+        z.object({
+            folder: z
+                .object({
+                name: z.string().describe("The folder's new name.").optional(),
+                description: z.string().describe("The folder's updated description.").optional(),
+                parentFolderId: z
+                    .number()
+                    .int()
+                    .describe("The folder's new parent folder ID.")
+                    .optional(),
+            })
+                .optional(),
+        }),
+    ]),
 });
 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",
@@ -18,12 +74,15 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/network/private/${params.elementType}/${params.elementId}`;
+        const endpoint = `/network/private/${args.elementType}/${args.elementId}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
+        const bodyPayload = args.body;
         const options = {
+            body: JSON.stringify(bodyPayload),
+            contentType: ContentType.Json,
             headers: extra.headers,
         };
         const result = await extra.client.put(url, options);

package/dist/src/tools/updateRequestComment.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -31,16 +31,16 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/${params.collectionId}/requests/${params.requestId}/comments/${params.commentId}`;
+        const endpoint = `/collections/${args.collectionId}/requests/${args.requestId}/comments/${args.commentId}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.body !== undefined)
-            bodyPayload.body = params.body;
-        if (params.tags !== undefined)
-            bodyPayload.tags = params.tags;
+        if (args.body !== undefined)
+            bodyPayload.body = args.body;
+        if (args.tags !== undefined)
+            bodyPayload.tags = args.tags;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/updateResponseComment.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -31,16 +31,16 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/${params.collectionId}/responses/${params.responseId}/comments/${params.commentId}`;
+        const endpoint = `/collections/${args.collectionId}/responses/${args.responseId}/comments/${args.commentId}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.body !== undefined)
-            bodyPayload.body = params.body;
-        if (params.tags !== undefined)
-            bodyPayload.tags = params.tags;
+        if (args.body !== undefined)
+            bodyPayload.body = args.body;
+        if (args.tags !== undefined)
+            bodyPayload.tags = args.tags;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/updateSpecFile.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -23,18 +23,18 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/specs/${params.specId}/files/${params.filePath}`;
+        const endpoint = `/specs/${args.specId}/files/${args.filePath}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.name !== undefined)
-            bodyPayload.name = params.name;
-        if (params.type !== undefined)
-            bodyPayload.type = params.type;
-        if (params.content !== undefined)
-            bodyPayload.content = params.content;
+        if (args.name !== undefined)
+            bodyPayload.name = args.name;
+        if (args.type !== undefined)
+            bodyPayload.type = args.type;
+        if (args.content !== undefined)
+            bodyPayload.content = args.content;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/updateSpecProperties.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -17,14 +17,14 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/specs/${params.specId}`;
+        const endpoint = `/specs/${args.specId}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.name !== undefined)
-            bodyPayload.name = params.name;
+        if (args.name !== undefined)
+            bodyPayload.name = args.name;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/updateWorkspace.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -27,14 +27,14 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/workspaces/${params.workspaceId}`;
+        const endpoint = `/workspaces/${args.workspaceId}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.workspace !== undefined)
-            bodyPayload.workspace = params.workspace;
+        if (args.workspace !== undefined)
+            bodyPayload.workspace = args.workspace;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/updateWorkspaceGlobalVariables.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -31,14 +31,14 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/workspaces/${params.workspaceId}/global-variables`;
+        const endpoint = `/workspaces/${args.workspaceId}/global-variables`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.values !== undefined)
-            bodyPayload.values = params.values;
+        if (args.values !== undefined)
+            bodyPayload.values = args.values;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/updateWorkspaceTags.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -30,14 +30,14 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/workspaces/${params.workspaceId}/tags`;
+        const endpoint = `/workspaces/${args.workspaceId}/tags`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.tags !== undefined)
-            bodyPayload.tags = params.tags;
+        if (args.tags !== undefined)
+            bodyPayload.tags = args.tags;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postman/postman-mcp-server",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "A simple MCP server to operate on the Postman API",
   "main": "dist/src/index.js",
   "type": "module",
@@ -22,28 +22,28 @@
     "access": "public"
   },
   "dependencies": {
-    "@apidevtools/swagger-parser": "^11.0.0",
-    "@modelcontextprotocol/sdk": "^1.17.0",
-    "dotenv": "^16.5.0",
-    "es-toolkit": "^1.37.2",
+    "@apidevtools/swagger-parser": "^12.0.0",
+    "@modelcontextprotocol/sdk": "^1.18.1",
+    "dotenv": "^17.2.2",
+    "es-toolkit": "^1.39.10",
     "express": "^5.1.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.26.0",
-    "@types/express": "^5.0.1",
-    "@types/node": "^22",
-    "eslint": "^9.26.0",
-    "eslint-config-prettier": "^10.1.5",
-    "eslint-plugin-prettier": "^5.4.0",
-    "eslint-plugin-unused-imports": "^4.1.4",
-    "fs-extra": "^11.3.0",
-    "jest": "^29.7.0",
+    "@eslint/js": "^9.35.0",
+    "@types/express": "^5.0.3",
+    "@types/node": "^24",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-unused-imports": "^4.2.0",
+    "fs-extra": "^11.3.2",
+    "jest": "^30.1.3",
     "json-schema-to-zod": "^2.6.1",
     "openapi-types": "^12.1.3",
-    "prettier": "^3.5.3",
-    "tsx": "^4.19.4",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.32.1",
+    "prettier": "^3.6.2",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.44.0",
     "vitest": "^3.2.4"
   },
   "engines": {