@postman/postman-mcp-server 2.2.1 → 2.3.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@postman/postman-mcp-server",
-    "version": "2.2.1",
+    "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": {

package/dist/src/clients/postman.js

@@ -10,19 +10,12 @@ export class PostmanAPIClient {
     apiKey;
     static instance = null;
     constructor(apiKey, baseUrl = process.env.POSTMAN_API_BASE_URL || 'https://api.postman.com') {
-        if (!apiKey && !process.env.POSTMAN_API_KEY) {
-            throw new Error('API key is required. Provide it as parameter or set POSTMAN_API_KEY environment variable.');
-        }
-        this.apiKey = apiKey || process.env.POSTMAN_API_KEY;
+        this.apiKey = apiKey;
         this.baseUrl = baseUrl;
     }
     static getInstance(apiKey, baseUrl) {
         if (!PostmanAPIClient.instance) {
-            const key = apiKey || process.env.POSTMAN_API_KEY;
-            if (!key) {
-                throw new Error('API key is required. Provide it as parameter or set POSTMAN_API_KEY environment variable.');
-            }
-            PostmanAPIClient.instance = new PostmanAPIClient(key, baseUrl);
+            PostmanAPIClient.instance = new PostmanAPIClient(apiKey, baseUrl);
         }
         return PostmanAPIClient.instance;
     }
@@ -45,20 +38,37 @@ export class PostmanAPIClient {
         return this.request(endpoint, { ...options, method: 'DELETE' });
     }
     async request(endpoint, options) {
+        const currentApiKey = this.apiKey || process.env.POSTMAN_API_KEY;
+        if (!currentApiKey) {
+            throw new Error('API key is required for requests. Provide it via constructor parameter or set POSTMAN_API_KEY environment variable.');
+        }
         const contentType = options.contentType || ContentType.Json;
-        const userAgentHeader = options.headers && 'user-agent' in options.headers
-            ? `${options.headers['user-agent']}/${packageJson.name}/${packageJson.version}`
+        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 disallowed = new Set([
+            'content-length',
+            'transfer-encoding',
+            'connection',
+            'host',
+            'accept-encoding',
+            'keep-alive',
+        ]);
+        const extra = Object.fromEntries(Object.entries(options.headers ?? {}).filter(([k]) => !disallowed.has(k.toLowerCase())));
+        const hasBody = options.body !== undefined && options.body !== null;
         const headers = {
-            'content-type': contentType,
-            'x-api-key': this.apiKey,
+            ...(hasBody ? { 'content-type': contentType } : {}),
+            ...extra,
+            'x-api-key': currentApiKey,
             'user-agent': userAgentHeader,
-            ...options.headers,
         };
-        const { headers: _, ...optionsWithoutHeaders } = options;
+        const { headers: _ignored, ...optionsWithoutHeaders } = options;
         const response = await fetch(`${this.baseUrl}${endpoint}`, {
             ...optionsWithoutHeaders,
             headers,
+            signal: AbortSignal.timeout(300000),
         });
         if (!response.ok) {
             await this.handleErrorResponse(response);

package/dist/src/index.js

@@ -1,9 +1,8 @@
 #!/usr/bin/env node
 import dotenv from 'dotenv';
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ErrorCode, isInitializeRequest, ListToolsRequestSchema, McpError, } from '@modelcontextprotocol/sdk/types.js';
-import zodToJsonSchema from 'zod-to-json-schema';
+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';
@@ -108,7 +107,11 @@ async function run() {
             process.exit(1);
         }
     }
-    const client = PostmanAPIClient.getInstance();
+    const apiKey = process.env.POSTMAN_API_KEY;
+    if (!apiKey) {
+        log('error', 'POSTMAN_API_KEY environment variable is required for STDIO mode');
+        process.exit(1);
+    }
     const allGeneratedTools = await loadAllTools();
     log('info', 'Server initialization starting', {
         serverName: SERVER_NAME,
@@ -118,7 +121,7 @@ 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 server = new Server({ name: SERVER_NAME, version: APP_VERSION }, { capabilities: { tools: {}, logging: {} } });
+    const server = new McpServer({ name: SERVER_NAME, version: APP_VERSION });
     server.onerror = (error) => {
         const msg = String(error?.message || error);
         logBoth(server, 'error', `MCP server error: ${msg}`, { error: msg });
@@ -128,52 +131,37 @@ async function run() {
         await server.close();
         process.exit(0);
     });
-    log('info', 'Setting up request handlers');
-    server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
-        const toolName = request.params.name;
-        const tool = tools.find((t) => t.method === toolName);
-        log('info', `Tool invocation started: ${toolName}`, { toolName });
-        if (!tool) {
-            log('warn', `Unknown tool requested: ${toolName}`, { toolName });
-            throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${toolName}`);
-        }
-        const args = request.params.arguments || {};
-        try {
-            const start = Date.now();
-            const result = await tool.handler(args, {
-                client,
-                headers: {
-                    ...extra.requestInfo?.headers,
-                    'user-agent': clientInfo?.name,
-                },
-            });
-            const durationMs = Date.now() - start;
-            log('info', `Tool invocation completed: ${toolName} (${durationMs}ms)`, {
-                toolName,
-                durationMs,
-            });
-            return result;
-        }
-        catch (error) {
-            const errMsg = String(error?.message || error);
-            logBoth(server, 'error', `Tool invocation failed: ${toolName}: ${errMsg}`, { toolName });
-            if (error instanceof McpError)
-                throw error;
-            throw new McpError(ErrorCode.InternalError, `API error: ${error.message}`);
-        }
-    });
-    server.setRequestHandler(ListToolsRequestSchema, async () => {
-        log('debug', `Tools list requested; ${tools.length} tools available`, {
-            toolCount: tools.length,
+    const client = new PostmanAPIClient(apiKey);
+    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) => {
+            const toolName = tool.method;
+            log('info', `Tool invocation started: ${toolName}`, { toolName });
+            try {
+                const start = Date.now();
+                const result = await tool.handler(args, {
+                    client,
+                    headers: {
+                        ...extra?.requestInfo?.headers,
+                        'user-agent': clientInfo?.name,
+                    },
+                });
+                const durationMs = Date.now() - start;
+                log('info', `Tool invocation completed: ${toolName} (${durationMs}ms)`, {
+                    toolName,
+                    durationMs,
+                });
+                return result;
+            }
+            catch (error) {
+                const errMsg = String(error?.message || error);
+                logBoth(server, 'error', `Tool invocation failed: ${toolName}: ${errMsg}`, { toolName });
+                if (error instanceof McpError)
+                    throw error;
+                throw new McpError(ErrorCode.InternalError, `API error: ${error.message}`);
+            }
         });
-        const transformedTools = tools.map((tool) => ({
-            name: tool.method,
-            description: tool.description,
-            inputSchema: zodToJsonSchema(tool.parameters),
-            annotations: tool.annotations,
-        }));
-        return { tools: transformedTools };
-    });
+    }
     log('info', 'Starting stdio transport');
     const transport = new StdioServerTransport();
     transport.onmessage = (message) => {

package/dist/src/tools/createCollection.js

@@ -6,7 +6,7 @@ function asMcpError(error) {
     return new McpError(ErrorCode.InternalError, cause);
 }
 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\n- If you do not include the \\`workspace\\` query parameter, the system creates the collection in the oldest personal Internal workspace you own.\n- For a complete list of available property values for this endpoint, use the following references available in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html):\n    - \\`info\\` object — Refer to the **Information** entry.\n    - \\`item\\` object — Refer to the **Items** entry.\n- For all other possible values, refer to the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html).\n';
+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({
     workspace: z.string().describe("The workspace's ID."),
     collection: z
@@ -28,18 +28,18 @@ export const parameters = z.object({
                 .array(z
                 .object({
                 key: z.string().describe("The variable's key (name).").optional(),
-                value: z.string().describe("The key's value.").optional(),
-                type: z
-                    .enum(['string', 'boolean', 'integer'])
-                    .describe("The variable's type.")
+                value: z
+                    .union([z.string(), z.boolean(), z.number().int()])
+                    .describe("The key's value.")
                     .optional(),
                 description: z
                     .string()
-                    .describe("The variable's description. Doesn't apply to collection-level variables.")
+                    .max(512)
+                    .describe("The variable's description.")
                     .optional(),
                 disabled: z
                     .boolean()
-                    .describe('If true, the variable is not enabled.')
+                    .describe("If true, the variable is not enabled. Doesn't apply to path parameter variables.")
                     .default(false),
             })
                 .describe('Information about the variable.'))
@@ -514,18 +514,14 @@ export const parameters = z.object({
             .array(z
             .object({
             key: z.string().describe("The variable's key (name).").optional(),
-            value: z.string().describe("The key's value.").optional(),
-            type: z
-                .enum(['string', 'boolean', 'integer'])
-                .describe("The variable's type.")
-                .optional(),
-            description: z
-                .string()
-                .describe("The variable's description. Doesn't apply to collection-level variables.")
+            value: z
+                .union([z.string(), z.boolean(), z.number().int()])
+                .describe("The key's value.")
                 .optional(),
+            description: z.string().max(512).describe("The variable's description.").optional(),
             disabled: z
                 .boolean()
-                .describe('If true, the variable is not enabled.')
+                .describe("If true, the variable is not enabled. Doesn't apply to path parameter variables.")
                 .default(false),
         })
             .describe('Information about the variable.'))
@@ -782,7 +778,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: '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\n- If you do not include the \\`workspace\\` query parameter, the system creates the collection in the oldest personal Internal workspace you own.\n- For a complete list of available property values for this endpoint, use the following references available in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html):\n    - \\`info\\` object — Refer to the **Information** entry.\n    - \\`item\\` object — Refer to the **Items** entry.\n- For all other possible values, refer to the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html).\n',
+    title: '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',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,

package/dist/src/tools/createCollectionComment.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);
@@ -34,18 +34,18 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: false,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/${params.collectionId}/comments`;
+        const endpoint = `/collections/${args.collectionId}/comments`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.body !== undefined)
-            bodyPayload.body = params.body;
-        if (params.threadId !== undefined)
-            bodyPayload.threadId = params.threadId;
-        if (params.tags !== undefined)
-            bodyPayload.tags = params.tags;
+        if (args.body !== undefined)
+            bodyPayload.body = args.body;
+        if (args.threadId !== undefined)
+            bodyPayload.threadId = args.threadId;
+        if (args.tags !== undefined)
+            bodyPayload.tags = args.tags;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/createCollectionFolder.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);
@@ -21,16 +21,16 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: false,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/${params.collectionId}/folders`;
+        const endpoint = `/collections/${args.collectionId}/folders`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.name !== undefined)
-            bodyPayload.name = params.name;
-        if (params.folder !== undefined)
-            bodyPayload.folder = params.folder;
+        if (args.name !== undefined)
+            bodyPayload.name = args.name;
+        if (args.folder !== undefined)
+            bodyPayload.folder = args.folder;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/createCollectionFork.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);
@@ -18,16 +18,16 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: false,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/fork/${params.collectionId}`;
+        const endpoint = `/collections/fork/${args.collectionId}`;
         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.label !== undefined)
-            bodyPayload.label = params.label;
+        if (args.label !== undefined)
+            bodyPayload.label = args.label;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/createCollectionRequest.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);
@@ -24,16 +24,16 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: false,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/${params.collectionId}/requests`;
+        const endpoint = `/collections/${args.collectionId}/requests`;
         const query = new URLSearchParams();
-        if (params.folderId !== undefined)
-            query.set('folderId', String(params.folderId));
+        if (args.folderId !== undefined)
+            query.set('folderId', String(args.folderId));
         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/createCollectionResponse.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);
@@ -21,16 +21,16 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: false,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/${params.collectionId}/responses`;
+        const endpoint = `/collections/${args.collectionId}/responses`;
         const query = new URLSearchParams();
-        if (params.requestId !== undefined)
-            query.set('requestId', String(params.requestId));
+        if (args.requestId !== undefined)
+            query.set('requestId', String(args.requestId));
         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/createEnvironment.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);
@@ -37,16 +37,16 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: false,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
         const endpoint = `/environments`;
         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.environment !== undefined)
-            bodyPayload.environment = params.environment;
+        if (args.environment !== undefined)
+            bodyPayload.environment = args.environment;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/createFolderComment.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);
@@ -35,18 +35,18 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: false,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/${params.collectionId}/folders/${params.folderId}/comments`;
+        const endpoint = `/collections/${args.collectionId}/folders/${args.folderId}/comments`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.body !== undefined)
-            bodyPayload.body = params.body;
-        if (params.threadId !== undefined)
-            bodyPayload.threadId = params.threadId;
-        if (params.tags !== undefined)
-            bodyPayload.tags = params.tags;
+        if (args.body !== undefined)
+            bodyPayload.body = args.body;
+        if (args.threadId !== undefined)
+            bodyPayload.threadId = args.threadId;
+        if (args.tags !== undefined)
+            bodyPayload.tags = args.tags;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/createMock.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 = 'createMock';
-export const description = 'Creates a mock server in a collection.\n\n**Note:**\n\n- You cannot create mocks for collections added to an API definition.\n- If you do not include the \\`workspaceId\\` query parameter, the system creates the mock server in the oldest personal Internal workspace you own.\n';
+export const description = 'Creates a mock server in a collection.\n\n- Pass the collection UID (ownerId-collectionId), not the bare collection ID.\n- If you only have a \\`collectionId\\`, resolve the UID first:\n  1) Prefer GET \\`/collections/{collectionId}\\` and read \\`uid\\`, or\n  2) Construct \\`{ownerId}-{collectionId}\\` using ownerId from GET \\`/me\\`:\n    - For team-owned collections: \\`ownerId = me.teamId\\`\n    - For personal collections: \\`ownerId = me.user.id\\`\n- Use the \\`workspace\\` query to place the mock in a specific workspace. Prefer explicit workspace scoping.\n';
 export const parameters = z.object({
     workspace: z.string().describe("The workspace's ID."),
     mock: z
@@ -25,21 +25,21 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Creates a mock server in a collection.\n\n**Note:**\n\n- You cannot create mocks for collections added to an API definition.\n- If you do not include the \\`workspaceId\\` query parameter, the system creates the mock server in the oldest personal Internal workspace you own.\n',
+    title: 'Creates a mock server in a collection.\n\n- Pass the collection UID (ownerId-collectionId), not the bare collection ID.\n- If you only have a \\`collectionId\\`, resolve the UID first:\n  1) Prefer GET \\`/collections/{collectionId}\\` and read \\`uid\\`, or\n  2) Construct \\`{ownerId}-{collectionId}\\` using ownerId from GET \\`/me\\`:\n    - For team-owned collections: \\`ownerId = me.teamId\\`\n    - For personal collections: \\`ownerId = me.user.id\\`\n- Use the \\`workspace\\` query to place the mock in a specific workspace. Prefer explicit workspace scoping.\n',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
         const endpoint = `/mocks`;
         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.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/createMonitor.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);
@@ -121,16 +121,16 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: false,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
         const endpoint = `/monitors`;
         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.monitor !== undefined)
-            bodyPayload.monitor = params.monitor;
+        if (args.monitor !== undefined)
+            bodyPayload.monitor = args.monitor;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,