@postman/postman-mcp-server 2.4.2 → 2.5.1

package/README.md

@@ -6,6 +6,7 @@ Postman supports the following tool configurations:
 
 * **Minimal** — (Default) Only includes essential tools for basic Postman operations This offers faster performance and simplifies use for those who only need basic Postman operations. Ideal for users who want to modify a single Postman elements, such as collections, workspaces, or environments.
 * **Full** — Includes all available Postman API tools (100+ tools). This configuration is ideal for users who engage in advanced collaboration and Postman's Enterprise features.
+* **Code** — Includes tools to generate high-quality, well-organized client code from public and internal API definitions. This configuration is ideal for users who need to consume APIs or simply get context about APIs to their agents.
 
 For a complete list of the Postman MCP Server's tools, see the [Postman MCP Server collection](https://www.postman.com/postman/postman-public-workspace/collection/681dc649440b35935978b8b7). This collection offers both the remote [full](https://www.postman.com/postman/postman-public-workspace/mcp-request/6821a76b17ccb90a86df48d3) and [minimal](https://www.postman.com/postman/postman-public-workspace/mcp-request/689e1c635be722a98b723238) servers, and the [local server](https://www.postman.com/postman/postman-public-workspace/mcp-request/6866a655b36c67cc435b5033).
 
@@ -19,8 +20,9 @@ Postman also offers servers as an [npm package](https://www.npmjs.com/package/@p
 * **Collection management** - Create and [tag](https://learning.postman.com/docs/collections/use-collections/collaborate-with-collections/#tag-a-collection) collections, update collection and request [documentation](https://learning.postman.com/docs/publishing-your-api/api-documentation-overview/), add [comments](https://learning.postman.com/docs/collaborating-in-postman/comments/), or perform actions across multiple collections without leaving your editor.
 * **Workspace and environment management** - Create [workspaces](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/overview/) and [environments](https://learning.postman.com/docs/sending-requests/variables/managing-environments/), plus manage your environment variables.
 * **Automatic spec creation** - Create [specs](https://learning.postman.com/docs/design-apis/specifications/overview/) from your code and use them to generate collections.
+* **Client code generation** - Generate production-ready client code that consumes APIs following best practices and project conventions. The `code` toolset produces code that precisely matches your API definitions, organizes it into an intuitive tree structure mirroring your Postman collections and requests, and leverages example responses to create accurate response types and error handling. 
 
-Designed for developers who want to integrate their AI tools with Postman’s context and features. Supports quick natural language queries queries to advanced agent workflows.
+Designed for developers who want to integrate their AI tools with Postman's context and features. Supports quick natural language queries to advanced agent workflows.
 
 ### Support for EU
 
@@ -55,6 +57,7 @@ The remote Postman MCP Server is hosted by Postman over streamable HTTP and prov
 The remote server supports the following tool configurations:
 
 * **Minimal** — (Default) Only includes essential tools for basic Postman operations, available at `https://mcp.postman.com/minimal` and `https://mcp.eu.postman.com/minimal` for EU users.
+* **Code** — Includes tools for searching public and internal API definitions and generating client code, available at `https://mcp.postman.com/code` and `https://mcp.eu.postman.com/code` for EU users.
 * **Full** — Includes all available Postman API tools (100+ tools), available at `https://mcp.postman.com/mcp` and `https://mcp.eu.postman.com/mcp` for EU users.
 
 ### Install in Cursor
@@ -65,7 +68,7 @@ To install the remote Postman MCP Server in Cursor, click the install button.
 
 **Note:** Ensure that the Authorization header uses the `Bearer <YOUR_API_KEY>` format.
 
-By default, the server uses **Minimal** mode. To access **Full** mode, change the `url` value to `https://mcp.postman.com/mcp` in the `mcp.json` file.
+By default, the server uses **Minimal** mode. To access **Full** mode, change the `url` value to `https://mcp.postman.com/mcp` in the `mcp.json` file. To access **Code** mode, change the value to `https://mcp.postman.com/code`.
 
 ### Install in Visual Studio Code
 
@@ -73,7 +76,7 @@ By default, the server uses **Minimal** mode. To access **Full** mode, change th
 
 To install the remote Postman MCP Server in VS Code, click the install button or use the [Postman VS Code Extension](https://marketplace.visualstudio.com/items?itemName=Postman.postman-for-vscode).
 
-By default, the server uses **Minimal** mode. To access **Full** mode, change the `url` value to `https://mcp.postman.com/mcp` in the `mcp.json` file.
+By default, the server uses **Minimal** mode. To access **Full** mode, change the `url` value to `https://mcp.postman.com/mcp` in the `mcp.json` file. To access **Code** mode, change the value to `https://mcp.postman.com/code`.
 
 #### Manual configuration
 
@@ -84,8 +87,7 @@ You can use the Postman MCP Server with MCP-compatible extensions in VS Code, su
     "servers": {
         "postman-api-http-server": {
             "type": "http",
-            "url": "https://mcp.postman.com/{minimal OR mcp}",
-            // Use "https://mcp.postman.com/mcp" for full or "https://mcp.postman.com/minimal" for minimal mode.
+            "url": "https://mcp.postman.com/{minimal OR code OR mcp}",
             // For the EU server, use the "https://mcp.eu.postman.com" URL.
             "headers": {
                 "Authorization": "Bearer ${input:postman-api-key}"
@@ -111,13 +113,19 @@ To install the MCP server in Claude Code, run the following command in your term
 For **Minimal** mode:
 
 ```bash
-claude mcp add --transport http postman https://mcp.postman.com/minimal
+claude mcp add --transport http postman https://mcp.postman.com/minimal --header "Authorization: Bearer <POSTMAN_API_KEY>"
+```
+
+For **Code** mode:
+
+```bash
+claude mcp add --transport http postman https://mcp.postman.com/code --header "Authorization: Bearer <POSTMAN_API_KEY>"
 ```
 
 For **Full** mode:
 
 ```bash
-claude mcp add --transport http postman https://mcp.postman.com/mcp
+claude mcp add --transport http postman https://mcp.postman.com/mcp --header "Authorization: Bearer <POSTMAN_API_KEY>"
 ```
 
 ---
@@ -133,6 +141,7 @@ STDIO is a lightweight solution that's ideal for integration with editors and to
 The local server supports the following tool configurations:
 
 * **Minimal** — (Default) Only includes essential tools for basic Postman operations.
+* **Code** — Includes tools for searching public and internal API definitions and generating client code
 * **Full** — Includes all available Postman API tools (100+ tools). Use the `--full` flag to enable this configuration.
 
 **Note:** Use the `--region` flag to specify the Postman API region (`us` or `eu`), or set the `POSTMAN_API_BASE_URL` environment variable directly. By default, the server uses the `us` option.
@@ -144,7 +153,7 @@ The local server supports the following tool configurations:
 
 To install the local Postman MCP Server in VS Code, click the install button.
 
-By default, the server uses **Full** mode. To access **Minimal** mode, remove the `--full` flag from the `mcp.json` configuration file.
+By default, the server uses **Full** mode. To access **Minimal** mode, remove the `--full` flag from the `mcp.json` configuration file. To access **Code** mode, replace the `--full` flag with `--code`.
 
 #### Manual configuration
 
@@ -158,7 +167,8 @@ You can manually integrate your MCP server with Cursor or VS Code to use it with
             "command": "npx",
             "args": [
                 "@postman/postman-mcp-server",
-                "--full" // (optional) Use this flag to enable full mode.
+                "--full", // (optional) Use this flag to enable full mode...
+                "--code", // (optional) ...OR this flag to enable code mode.
                 "--region us" // (optional) Use this flag to specify the Postman API region (us or eu). Defaults to us.
             ],
             "env": {
@@ -182,14 +192,15 @@ You can manually integrate your MCP server with Cursor or VS Code to use it with
 
 To install the local Postman MCP Server in Cursor, click the install button.
 
-By default, the server uses **Full** mode. To access **Minimal** mode, remove the `--full` flag from the `mcp.json` configuration file.
+By default, the server uses **Full** mode. To access **Minimal** mode, remove the `--full` flag from the `mcp.json` configuration file. To access **Code** mode, replace the `--full` flag with `--code`.
 
 ### Claude integration
 
 To integrate the MCP server with Claude, check the latest [Postman MCP Server release](https://github.com/postmanlabs/postman-mcp-server/releases) and get the `.mcpb` file.
 
-* **Minimal** - `postman-api-mcp-minimal.mcpb`
-* **Full** - `postman-api-mcp-full.mcpb`
+* **Minimal** - `postman-mcp-server-minimal.mcpb`
+* **Full** - `postman-mcp-server-full.mcpb`
+* **Code** - `postman-mcp-server-code.mcpb`
 
 For more information, see the [Claude Desktop Extensions](https://www.anthropic.com/engineering/desktop-extensions) documentation.
 
@@ -200,13 +211,19 @@ To install the MCP server in Claude Code, run the following command in your term
 For **Minimal** mode:
 
 ```bash
-claude mcp add postman -- npx @postman/mcp-server@latest
+claude mcp add postman --env POSTMAN_API_KEY=YOUR_KEY -- npx @postman/postman-mcp-server@latest 
+```
+
+For **Code** mode:
+
+```bash
+claude mcp add postman --env POSTMAN_API_KEY=YOUR_KEY -- npx @postman/postman-mcp-server@latest  --code
 ```
 
 For **Full** mode:
 
 ```bash
-claude mcp add postman -- npx @postman/mcp-server@latest --full
+claude mcp add postman --env POSTMAN_API_KEY=YOUR_KEY -- npx @postman/postman-mcp-server@latest --full 
 ```
 
 ### Use as a Gemini CLI extension
@@ -239,7 +256,6 @@ If you're migrating from Postman MCP Server version 1.x to 2.x, be aware of the
 
 ## Questions and support
 
-* See the [Postman Agent Generator](https://postman.com/explore/agent-generator) page for updates and new capabilities.
 * See [Add your MCP requests to your collections](https://learning.postman.com/docs/postman-ai-agent-builder/mcp-requests/overview/) to learn how to use Postman to perform MCP requests.
 * Visit the [Postman Community](https://community.postman.com/) to share what you've built, ask questions, and get help.
 * You can connect to both the remote and local servers and test them using the [Postman MCP Server collection](https://www.postman.com/postman/postman-public-workspace/collection/681dc649440b35935978b8b7).

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@postman/postman-mcp-server",
-    "version": "2.4.2",
+    "version": "2.5.1",
     "description": "A simple MCP server to operate on the Postman API",
     "mcpName": "com.postman/postman-mcp-server",
     "main": "dist/src/index.js",
@@ -27,30 +27,21 @@
         "access": "public"
     },
     "dependencies": {
-        "@apidevtools/swagger-parser": "^12.0.0",
-        "@modelcontextprotocol/sdk": "^1.18.1",
-        "dotenv": "^17.2.2",
-        "es-toolkit": "^1.39.10",
-        "express": "^5.1.0",
-        "newman": "^6.2.1"
+        "@modelcontextprotocol/sdk": "^1.22.0",
+        "dotenv": "^17.2.3",
+        "newman": "^6.2.0",
+        "uuid": "^13.0.0"
     },
     "devDependencies": {
-        "@eslint/js": "^9.35.0",
-        "@types/express": "^5.0.3",
+        "@eslint/js": "^9.39.1",
         "@types/node": "^24",
-        "eslint": "^9.35.0",
+        "eslint": "^9.39.1",
         "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",
+        "eslint-plugin-unused-imports": "^4.3.0",
         "prettier": "^3.6.2",
-        "tsx": "^4.20.5",
-        "typescript": "^5.9.2",
-        "typescript-eslint": "^8.44.0",
-        "vitest": "^3.2.4"
+        "typescript": "^5.9.3",
+        "typescript-eslint": "^8.48.0",
+        "vitest": "^4.0.13"
     },
     "engines": {
         "node": ">=20.0.0"

package/dist/src/clients/postman.js

@@ -1,5 +1,5 @@
 import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
-import packageJson from '../../package.json' with { type: 'json' };
+import { USER_AGENT } from '../constants.js';
 export var ContentType;
 (function (ContentType) {
     ContentType["Json"] = "application/json";
@@ -45,9 +45,7 @@ export class PostmanAPIClient {
         const contentType = options.contentType || ContentType.Json;
         const userAgentKey = Object.keys(options.headers ?? {}).find((key) => key.toLowerCase() === 'user-agent');
         const userAgentValue = userAgentKey ? options.headers?.[userAgentKey] : undefined;
-        const userAgentHeader = userAgentValue
-            ? `${userAgentValue}/${packageJson.name}/${packageJson.version}`
-            : `${packageJson.name}/${packageJson.version}`;
+        const userAgentHeader = userAgentValue ? `${userAgentValue}/${USER_AGENT}` : USER_AGENT;
         const disallowed = new Set([
             'content-length',
             'transfer-encoding',

package/dist/src/constants.js

@@ -0,0 +1,5 @@
+import packageJson from '../package.json' with { type: 'json' };
+export const SERVER_NAME = packageJson.name;
+export const APP_VERSION = packageJson.version;
+export const USER_AGENT = `${packageJson.name}/${packageJson.version}`;
+export const RUNNER_ACCEPT_HEADER = 'application/vnd.postman.v2+json';

package/dist/src/enabledResources.js

@@ -35,6 +35,7 @@ const full = [
     'getCollectionResponse',
     'updateCollectionResponse',
     'transferCollectionResponses',
+    'runCollection',
     'createCollectionComment',
     'deleteCollectionComment',
     'getCollectionComments',
@@ -109,7 +110,8 @@ const full = [
     'getDuplicateCollectionTaskStatus',
     'deleteApiCollectionComment',
     'deleteSpecFile',
-    'runCollection',
+    'getEnabledTools',
+    'searchPostmanElements',
 ];
 const minimal = [
     'createCollection',
@@ -151,10 +153,30 @@ const minimal = [
     'duplicateCollection',
     'getStatusOfAnAsyncApiTask',
     'runCollection',
+    'getEnabledTools',
+];
+const code = [
+    'getCodeGenerationInstructions',
+    'getWorkspace',
+    'getWorkspaces',
+    'searchPostmanElements',
+    'getCollectionRequest',
+    'getCollectionResponse',
+    'getCollectionFolder',
+    'getAuthenticatedUser',
+    'getCollectionMap',
+    'getEnvironment',
+    'getEnvironments',
+];
+const excludedFromGeneration = [
+    'runCollection',
+    'getEnabledTools',
+    'getCodeGenerationInstructions',
+    'getCollectionMap',
 ];
-const excludedFromGeneration = ['createCollection', 'putCollection'];
 export const enabledResources = {
     full,
     minimal,
+    code,
     excludedFromGeneration,
 };

package/dist/src/index.js

@@ -3,12 +3,12 @@ import dotenv from 'dotenv';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { ErrorCode, isInitializeRequest, McpError, } from '@modelcontextprotocol/sdk/types.js';
-import packageJson from '../package.json' with { type: 'json' };
 import { readdir } from 'node:fs/promises';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { enabledResources } from './enabledResources.js';
 import { PostmanAPIClient } from './clients/postman.js';
+import { SERVER_NAME, APP_VERSION } from './constants.js';
 const SUPPORTED_REGIONS = {
     us: 'https://api.postman.com',
     eu: 'https://api.eu.postman.com',
@@ -93,13 +93,11 @@ if (dotEnvOutput.error) {
 else {
     log('info', `Environment variables loaded: ${dotEnvOutput.parsed ? Object.keys(dotEnvOutput.parsed).length : 0} environment variables: ${Object.keys(dotEnvOutput.parsed || {}).join(', ')}`);
 }
-const SERVER_NAME = packageJson.name;
-const APP_VERSION = packageJson.version;
-export const USER_AGENT = `${SERVER_NAME}/${APP_VERSION}`;
 let clientInfo = undefined;
 async function run() {
     const args = process.argv.slice(2);
     const useFull = args.includes('--full');
+    const useCode = args.includes('--code');
     const regionIndex = args.findIndex((arg) => arg === '--region');
     if (regionIndex !== -1 && regionIndex + 1 < args.length) {
         const region = args[regionIndex + 1];
@@ -129,7 +127,8 @@ async function run() {
     });
     const fullTools = allGeneratedTools.filter((t) => enabledResources.full.includes(t.method));
     const minimalTools = allGeneratedTools.filter((t) => enabledResources.minimal.includes(t.method));
-    const tools = useFull ? fullTools : minimalTools;
+    const codeTools = allGeneratedTools.filter((t) => enabledResources.code.includes(t.method));
+    const tools = useCode ? codeTools : useFull ? fullTools : minimalTools;
     const server = new McpServer({ name: SERVER_NAME, version: APP_VERSION });
     server.onerror = (error) => {
         const msg = String(error?.message || error);
@@ -141,6 +140,10 @@ async function run() {
         process.exit(0);
     });
     const client = new PostmanAPIClient(apiKey);
+    const serverContext = {
+        serverType: useCode ? 'code' : useFull ? 'full' : 'minimal',
+        availableTools: tools.map((t) => t.method),
+    };
     log('info', 'Registering tools with McpServer');
     for (const tool of tools) {
         server.tool(tool.method, tool.description, tool.parameters.shape, tool.annotations || {}, async (args, extra) => {
@@ -154,6 +157,7 @@ async function run() {
                         ...extra?.requestInfo?.headers,
                         'user-agent': clientInfo?.name,
                     },
+                    serverContext,
                 });
                 const durationMs = Date.now() - start;
                 log('info', `Tool invocation completed: ${toolName} (${durationMs}ms)`, {
@@ -180,7 +184,8 @@ async function run() {
         }
     };
     await server.connect(transport);
-    logBoth(server, 'info', `Server connected and ready: ${SERVER_NAME}@${APP_VERSION} with ${tools.length} tools (${useFull ? 'full' : 'minimal'})`);
+    const toolsetName = useCode ? 'code' : useFull ? 'full' : 'minimal';
+    logBoth(server, 'info', `Server connected and ready: ${SERVER_NAME}@${APP_VERSION} with ${tools.length} tools (${toolsetName})`);
 }
 run().catch((error) => {
     log('error', 'Unhandled error during server execution', {

package/dist/src/tools/createCollection.js

@@ -1,10 +1,6 @@
 import { z } from 'zod';
 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);
-}
+import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'createCollection';
 export const description = 'Creates a collection using the [Postman Collection v2.1.0 schema format](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html).\n\n**Note:**\n\nIf you do not include the \\`workspace\\` query parameter, the system creates the collection in the oldest personal Internal workspace you own.\n';
 export const parameters = z.object({
@@ -126,13 +122,13 @@ export const parameters = z.object({
                         'edgegrid',
                     ])
                         .describe('The authorization type.'),
-                    noauth: z.any().optional(),
+                    noauth: z.unknown().optional(),
                     apikey: z
                         .array(z
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -148,7 +144,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -164,7 +160,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -180,7 +176,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -196,7 +192,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -212,7 +208,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -228,7 +224,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -244,7 +240,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -260,7 +256,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -276,7 +272,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -339,7 +335,7 @@ export const parameters = z.object({
                         .describe('A list of x-www-form-encoded key/value pairs.')
                         .optional(),
                     formdata: z
-                        .array(z.record(z.any()).and(z.union([
+                        .array(z.record(z.string(), z.unknown()).and(z.union([
                         z.object({
                             key: z.string().describe('The key value.').optional(),
                             value: z.string().describe("The key's value.").optional(),
@@ -357,7 +353,7 @@ export const parameters = z.object({
                         z.object({
                             key: z.string().describe('The key value.').optional(),
                             src: z
-                                .any()
+                                .unknown()
                                 .superRefine((x, ctx) => {
                                 const schemas = [z.string().nullable(), z.array(z.string())];
                                 const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
@@ -407,7 +403,7 @@ export const parameters = z.object({
                         .describe('If the `mode` value is `graphql`, an object containing the GraphQL request information.')
                         .optional(),
                     options: z
-                        .record(z.any())
+                        .record(z.string(), z.unknown())
                         .describe('Additional configurations and options set for various modes.')
                         .optional(),
                 })
@@ -416,6 +412,10 @@ export const parameters = z.object({
             })
                 .describe('Information about the collection request.')
                 .optional(),
+            response: z
+                .array(z.unknown().describe("Information about the request's response."))
+                .describe("A list of the collection's responses.")
+                .optional(),
             protocolProfileBehavior: z
                 .object({
                 strictSSL: z
@@ -544,13 +544,13 @@ export const parameters = z.object({
                 'edgegrid',
             ])
                 .describe('The authorization type.'),
-            noauth: z.any().optional(),
+            noauth: z.unknown().optional(),
             apikey: z
                 .array(z
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -566,7 +566,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -582,7 +582,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -598,7 +598,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -614,7 +614,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -630,7 +630,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -646,7 +646,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -662,7 +662,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -678,7 +678,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -694,7 +694,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -783,16 +783,16 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: false,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
         const endpoint = `/collections`;
         const query = new URLSearchParams();
-        if (params.workspace !== undefined)
-            query.set('workspace', String(params.workspace));
+        if (args.workspace !== undefined)
+            query.set('workspace', String(args.workspace));
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.collection !== undefined)
-            bodyPayload.collection = params.collection;
+        if (args.collection !== undefined)
+            bodyPayload.collection = args.collection;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/createCollectionComment.js

@@ -1,10 +1,6 @@
 import { z } from 'zod';
 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);
-}
+import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'createCollectionComment';
 export const description = 'Creates a comment on a collection. To create a reply on an existing comment, include the \\`threadId\\` property in the request body.\n\n**Note:**\n\nThis endpoint accepts a max of 10,000 characters.\n';
 export const parameters = z.object({

package/dist/src/tools/createCollectionFolder.js

@@ -1,10 +1,6 @@
 import { z } from 'zod';
 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);
-}
+import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'createCollectionFolder';
 export const description = 'Creates a folder in a collection. For a complete list of properties, refer to the **Folder** entry in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html).\n\nYou can use this endpoint to to import requests and responses into a newly-created folder. To do this, include the \\`requests\\` field and the list of request objects in the request body. For more information, see the provided example.\n\n**Note:**\n\nIt is recommended that you pass the \\`name\\` property in the request body. If you do not, the system uses a null value. As a result, this creates a folder with a blank name.\n';
 export const parameters = z.object({

package/dist/src/tools/createCollectionFork.js

@@ -1,10 +1,6 @@
 import { z } from 'zod';
 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);
-}
+import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'createCollectionFork';
 export const description = 'Creates a [fork](https://learning.postman.com/docs/collaborating-in-postman/version-control/#creating-a-fork) from an existing collection into a workspace.';
 export const parameters = z.object({