@postman/postman-mcp-server 2.7.0 → 2.8.0

package/README.md

@@ -590,6 +590,38 @@ To install the MCP server as a Gemini CLI extension, run the following command i
 gemini extensions install https://github.com/postmanlabs/postman-mcp-server
 ```
 
+### Install in Kiro
+
+To use the Postman MCP Server in Kiro, you can use one of the following methods:
+
+To set up the Postman MCP Server with one-click, see [API Testing with Postman](https://kiro.dev/powers/) on the Kiro Powers page. Click **Add to Kiro**.
+
+To install the Postman MCP Server manually, do the following:
+
+1. Launch Kiro and click the Kiro ghost icon in the left sidebar.
+1. Add an MCP Server and select either **User Config** or **Workspace Config** to install the Postman MCP server.
+1. Add the following JSON block to the `mcp.json` configuration file:
+
+    ```json wordWrap
+    {
+        "mcpServers": {
+            "postman": {
+            "command": "npx",
+                "args": [
+                    "@postman/postman-mcp-server"
+                ],
+                "env": {
+                    "POSTMAN_API_KEY": "postman-api-key"
+                },
+                "disabled": false,
+                "autoApprove": [
+                    "getAuthenticatedUser"
+                ]
+            }
+        }
+    }
+    ```
+
 ### Install in Docker
 
 For Docker set up and installation, see [DOCKER.md](./DOCKER.md).

package/dist/package.json

@@ -1,20 +1,22 @@
 {
     "name": "@postman/postman-mcp-server",
-    "version": "2.7.0",
+    "version": "2.8.0",
     "description": "A simple MCP server to operate on the Postman API",
     "mcpName": "com.postman/postman-mcp-server",
     "main": "dist/src/index.js",
     "type": "module",
+    "packageManager": "pnpm@10.6.2",
     "scripts": {
+        "preinstall": "npx only-allow pnpm",
         "start:stdio": "node dist/src/index.js",
         "build": "eslint --fix ./src && prettier --write \"src/**/*.ts\" && tsc",
-        "prepack": "npm run build",
+        "prepack": "pnpm run build",
         "test": "vitest",
         "lint": "eslint",
         "lint:fix": "eslint --fix",
-        "preversion": "npm run build",
+        "preversion": "pnpm run build",
         "version": "git add dist/",
-        "release": "npm version",
+        "release": "pnpm version",
         "release-custom": "node scripts/release.js"
     },
     "bin": "dist/src/index.js",
@@ -27,23 +29,23 @@
         "access": "public"
     },
     "dependencies": {
-        "@modelcontextprotocol/sdk": "^1.25.2",
-        "dotenv": "^17.2.3",
-        "newman": "^6.2.0",
+        "@modelcontextprotocol/sdk": "^1.27.1",
+        "dotenv": "^17.3.1",
+        "newman": "^6.2.2",
         "nunjucks": "^3.2.4",
         "uuid": "^13.0.0",
         "zod": "^3.25.76"
     },
     "devDependencies": {
-        "@eslint/js": "^9.39.1",
+        "@eslint/js": "^10.0.1",
         "@types/node": "^24",
-        "eslint": "^9.39.1",
+        "eslint": "^10.0.2",
         "eslint-config-prettier": "^10.1.8",
-        "eslint-plugin-unused-imports": "^4.3.0",
-        "prettier": "^3.6.2",
+        "eslint-plugin-unused-imports": "^4.4.1",
+        "prettier": "^3.8.1",
         "typescript": "^5.9.3",
-        "typescript-eslint": "^8.48.0",
-        "vitest": "^4.0.13"
+        "typescript-eslint": "^8.56.1",
+        "vitest": "^4.0.18"
     },
     "engines": {
         "node": ">=20.0.0"

package/dist/src/clients/postman.js

@@ -94,10 +94,12 @@ export class PostmanAPIClient {
             case 403:
                 throw new McpError(ErrorCode.InvalidParams, `API request failed: ${response.status} ${errorText}`, {
                     cause: errorText,
+                    httpStatus: response.status,
                 });
             default:
                 throw new McpError(ErrorCode.InternalError, `API request failed: ${response.status}`, {
                     cause: errorText,
+                    httpStatus: response.status,
                 });
         }
     }

package/dist/src/enabledResources.js

@@ -92,11 +92,11 @@ const full = [
     'updateWorkspaceGlobalVariables',
     'getWorkspaceTags',
     'updateWorkspaceTags',
-    'getAllElementsAndFolders',
-    'getAllPanAddElementRequests',
-    'deletePanElementOrFolder',
-    'postPanElementOrFolder',
-    'updatePanElementOrFolder',
+    'listPrivateNetworkWorkspaces',
+    'listPrivateNetworkAddRequests',
+    'removeWorkspaceFromPrivateNetwork',
+    'addWorkspaceToPrivateNetwork',
+    'respondPrivateNetworkAddRequest',
     'publishDocumentation',
     'unpublishDocumentation',
     'getAsyncSpecTaskStatus',
@@ -112,7 +112,10 @@ const full = [
     'deleteApiCollectionComment',
     'deleteSpecFile',
     'getEnabledTools',
-    'searchPostmanElements',
+    'searchPostmanElementsInPublicNetwork',
+    'searchPostmanElementsInPrivateNetwork',
+    'getAnalyticsData',
+    'getAnalyticsMetadata',
 ];
 const minimal = [
     'createCollection',
@@ -152,7 +155,7 @@ const minimal = [
     'createCollectionRequest',
     'createCollectionResponse',
     'duplicateCollection',
-    'getStatusOfAnAsyncApiTask',
+    'getDuplicateCollectionTaskStatus',
     'runCollection',
     'getEnabledTools',
     'updateCollectionRequest',
@@ -161,7 +164,7 @@ const code = [
     'getCodeGenerationInstructions',
     'getWorkspace',
     'getWorkspaces',
-    'searchPostmanElements',
+    'searchPostmanElementsInPublicNetwork',
     'getCollectionRequest',
     'getCollectionResponse',
     'getCollectionFolder',
@@ -169,6 +172,7 @@ const code = [
     'getCollection',
     'getEnvironment',
     'getEnvironments',
+    'searchPostmanElementsInPrivateNetwork',
 ];
 const excludedFromGeneration = [
     'runCollection',
@@ -176,7 +180,8 @@ const excludedFromGeneration = [
     'getCodeGenerationInstructions',
     'getCollectionMap',
     'getCollection',
-    'searchPostmanElements',
+    'searchPostmanElementsInPublicNetwork',
+    'searchPostmanElementsInPrivateNetwork',
 ];
 const subtools = {
     getCollection: {

package/dist/src/index.js

@@ -11,6 +11,7 @@ import { PostmanAPIClient } from './clients/postman.js';
 import { SERVER_NAME, APP_VERSION } from './constants.js';
 import { env } from './env.js';
 import { createTemplateRenderer } from './tools/utils/templateRenderer.js';
+import { createErrorTemplateRenderer } from './tools/utils/errorTemplateRenderer.js';
 const SUPPORTED_REGIONS = {
     us: 'https://api.postman.com',
     eu: 'https://api.eu.postman.com',
@@ -148,6 +149,8 @@ async function run() {
     const __dirname = dirname(__filename);
     const viewsDir = join(__dirname, './views');
     const renderTemplate = createTemplateRenderer(viewsDir);
+    const errorsDir = join(__dirname, './views/errors');
+    const renderErrorTemplate = createErrorTemplateRenderer(errorsDir);
     const client = new PostmanAPIClient(apiKey, undefined, serverContext);
     log('info', 'Registering tools with McpServer');
     for (const tool of tools) {
@@ -184,8 +187,33 @@ async function run() {
             catch (error) {
                 const errMsg = String(error?.message || error);
                 logBoth(server, 'error', `Tool invocation failed: ${toolName}: ${errMsg}`, { toolName });
-                if (error instanceof McpError)
+                if (error instanceof McpError) {
+                    const httpStatus = error.data?.httpStatus;
+                    if (typeof httpStatus === 'number') {
+                        const rawBody = String(error.data?.cause ?? '');
+                        let parsedBody = null;
+                        try {
+                            parsedBody = JSON.parse(rawBody);
+                        }
+                        catch {
+                        }
+                        const errorObj = parsedBody?.error && typeof parsedBody.error === 'object'
+                            ? parsedBody.error
+                            : parsedBody;
+                        const rendered = renderErrorTemplate(toolName, httpStatus, {
+                            toolName,
+                            statusCode: httpStatus,
+                            args,
+                            errorMessage: error.message,
+                            errorBody: rawBody,
+                            error: errorObj,
+                        });
+                        if (rendered) {
+                            throw new McpError(error.code, rendered, error.data);
+                        }
+                    }
                     throw error;
+                }
                 throw new McpError(ErrorCode.InternalError, `API error: ${error.message}`);
             }
         });

package/dist/src/tools/addWorkspaceToPrivateNetwork.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import { ContentType } from '../clients/postman.js';
+import { asMcpError, McpError } from './utils/toolHelpers.js';
+export const method = 'addWorkspaceToPrivateNetwork';
+export const description = "Publishes a workspace to your team's Private API Network.\n\nWARNING: This tool is for Private API Network management, not for general workspace operations. For workspace management use: getWorkspaces, getWorkspace, createWorkspace, updateWorkspace, deleteWorkspace.\n";
+export const parameters = z.object({
+    workspace: z.object({
+        id: z.string().describe("The workspace's ID."),
+        parentFolderId: z.number().int().describe('The `0` value.').default(0),
+    }),
+});
+export const annotations = {
+    title: "Publishes a workspace to your team's Private API Network.",
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: false,
+};
+export async function handler(args, extra) {
+    try {
+        const endpoint = `/network/private`;
+        const query = new URLSearchParams();
+        const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
+        const bodyPayload = {};
+        if (args.workspace !== undefined)
+            bodyPayload.workspace = args.workspace;
+        const options = {
+            body: JSON.stringify(bodyPayload),
+            contentType: ContentType.Json,
+            headers: extra.headers,
+        };
+        const result = await extra.client.post(url, options);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `${typeof result === 'string' ? result : JSON.stringify(result, null, 2)}`,
+                },
+            ],
+        };
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            throw e;
+        }
+        throw asMcpError(e);
+    }
+}