@postman/postman-mcp-server 2.4.2 → 2.5.1

package/dist/src/tools/runner/telemetry.js

@@ -0,0 +1,178 @@
+import { RUNNER_ACCEPT_HEADER } from '../../constants.js';
+import { v4 as uuidv4 } from 'uuid';
+export function buildTelemetryPayload(collectionId, collectionName, result) {
+    const durationMs = result.durationMs;
+    const stats = result.summary?.run?.stats || {};
+    const iterations = stats.iterations || { total: 0, pending: 0, failed: 0 };
+    const items = stats.items || { total: 0, pending: 0, failed: 0 };
+    const scripts = stats.scripts || { total: 0, pending: 0, failed: 0 };
+    const prerequests = stats.prerequests || { total: 0, pending: 0, failed: 0 };
+    const requests = stats.requests || { total: 0, pending: 0, failed: 0 };
+    const tests = stats.tests || { total: 0, pending: 0, failed: 0 };
+    const assertions = stats.assertions || { total: 0, pending: 0, failed: 0 };
+    const testScripts = stats.testScripts || { total: 0, pending: 0, failed: 0 };
+    const prerequestScripts = stats.prerequestScripts || { total: 0, pending: 0, failed: 0 };
+    const responses = result.summary?.run?.executions || [];
+    const totalResponseTime = responses.reduce((sum, exec) => {
+        return sum + (exec?.response?.responseTime || 0);
+    }, 0);
+    const averageResponseTime = responses.length > 0 ? totalResponseTime / responses.length : 0;
+    const totalDataReceived = responses.reduce((sum, exec) => {
+        return sum + (exec?.response?.responseSize || 0);
+    }, 0);
+    const iterationsData = (result.summary?.run?.executions || []).map((exec) => {
+        const item = exec.item || {};
+        const request = exec.request || {};
+        const response = exec.response || {};
+        const assertions = exec.assertions || [];
+        const testResults = assertions.map((assertion) => ({
+            name: assertion.assertion || 'Unnamed test',
+            status: assertion.error ? 'fail' : 'pass',
+            error: assertion.error
+                ? {
+                    name: assertion.error.name || 'AssertionError',
+                    message: assertion.error.message || 'Unknown error',
+                    stack: assertion.error.stack || '',
+                }
+                : null,
+        }));
+        const requestData = {
+            url: request.url?.toString() || '',
+            method: request.method || 'GET',
+            headers: request.headers || {},
+        };
+        if (request.body) {
+            requestData.body = {
+                mode: request.body.mode || 'raw',
+                raw: request.body.raw || '',
+            };
+            if (request.body.options) {
+                requestData.body.options = request.body.options;
+            }
+        }
+        const responseData = {
+            code: response.code || 0,
+            name: response.status || '',
+            time: response.responseTime || 0,
+            size: response.responseSize || 0,
+            headers: response.headers || [],
+        };
+        if (response.stream) {
+            try {
+                responseData.body = response.stream.toString();
+            }
+            catch {
+                responseData.body = '';
+            }
+        }
+        return {
+            id: uuidv4(),
+            name: item.name || 'Request',
+            error: exec.requestError
+                ? {
+                    name: exec.requestError.name || 'Error',
+                    message: exec.requestError.message || 'Unknown error',
+                }
+                : null,
+            tests: testResults,
+            request: requestData,
+            response: responseData,
+        };
+    });
+    return {
+        collectionRun: {
+            id: uuidv4(),
+            collection: collectionId,
+            name: collectionName,
+            status: 'finished',
+            source: 'postman-cli',
+            delay: 0,
+            currentIteration: iterations.total || 1,
+            failedTestCount: result.testStats.failed,
+            skippedTestCount: 0,
+            passedTestCount: result.testStats.passed,
+            totalTestCount: result.testStats.total,
+            iterations: iterationsData.length > 0 ? [iterationsData] : [],
+            totalTime: durationMs,
+            totalRequests: requests.total || 0,
+            startedAt: result.startTime,
+            createdAt: result.endTime,
+            branchSource: 'local',
+            branch: process.env.GIT_BRANCH || 'main',
+        },
+        runOverview: {
+            collectionName: collectionName,
+            runDurationInMiliseconds: durationMs,
+            averageResponseTimeInMiliseconds: Math.round(averageResponseTime),
+            totalDataReceivedInBytes: totalDataReceived,
+            statistics: {
+                iterations: {
+                    total: iterations.total || 0,
+                    pending: iterations.pending || 0,
+                    failed: iterations.failed || 0,
+                },
+                items: {
+                    total: items.total || 0,
+                    pending: items.pending || 0,
+                    failed: items.failed || 0,
+                },
+                scripts: {
+                    total: scripts.total || 0,
+                    pending: scripts.pending || 0,
+                    failed: scripts.failed || 0,
+                },
+                prerequests: {
+                    total: prerequests.total || 0,
+                    pending: prerequests.pending || 0,
+                    failed: prerequests.failed || 0,
+                },
+                requests: {
+                    total: requests.total || 0,
+                    pending: requests.pending || 0,
+                    failed: requests.failed || 0,
+                },
+                tests: {
+                    total: tests.total || 0,
+                    pending: tests.pending || 0,
+                    failed: tests.failed || 0,
+                },
+                assertions: {
+                    total: assertions.total || 0,
+                    pending: assertions.pending || 0,
+                    failed: assertions.failed || 0,
+                },
+                testScripts: {
+                    total: testScripts.total || 0,
+                    pending: testScripts.pending || 0,
+                    failed: testScripts.failed || 0,
+                },
+                prerequestScripts: {
+                    total: prerequestScripts.total || 0,
+                    pending: prerequestScripts.pending || 0,
+                    failed: prerequestScripts.failed || 0,
+                },
+                responses: {
+                    total: responses.length || 0,
+                    pending: 0,
+                    failed: requests.failed || 0,
+                    totalResponseTime: Math.round(totalResponseTime),
+                },
+            },
+        },
+    };
+}
+export function reportTelemetryAsync(payload, client) {
+    setImmediate(async () => {
+        try {
+            await client.post('/collectionruns', {
+                body: JSON.stringify(payload),
+                headers: {
+                    Accept: RUNNER_ACCEPT_HEADER,
+                },
+            });
+        }
+        catch (error) {
+            console.error('[TelemetryReporter] Failed to post collection run data:', error.message);
+        }
+    });
+}

package/dist/src/tools/searchPostmanElements.js

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+import { asMcpError, McpError } from './utils/toolHelpers.js';
+export const method = 'searchPostmanElements';
+export const description = 'Searches for Postman elements in the public network.\n\n**When to Use This Tool:**\n- When the user asks for a specific named request (e.g., "find PayPal requests", "search for Stripe API requests")\n- When the user explicitly wants to search the public network\n- Do NOT use this for searching the user\'s own workspaces or collections (use getCollections or getWorkspaces instead)\n\n**Search Scope:**\n- Only searches the public network (public workspaces and collections)\n- Does not search private workspaces, team workspaces, or personal collections\n- Currently supports searching for requests (entityType: "requests")\n';
+export const parameters = z.object({
+    entityType: z
+        .literal('requests')
+        .describe('The type of Postman [entity](https://learning.postman.com/docs/getting-started/basics/postman-elements/) (element) to search for. At this time, this only accepts the `requests` value.'),
+    q: z
+        .string()
+        .min(1)
+        .max(512)
+        .describe('The query used to search for Postman elements.')
+        .optional(),
+    publisherIsVerified: z
+        .boolean()
+        .describe('Filter the search results to only return entities from publishers [verified](https://learning.postman.com/docs/collaborating-in-postman/public-api-network/verify-your-team/) by Postman.')
+        .optional(),
+    nextCursor: z
+        .string()
+        .describe('The cursor to get the next set of results in the paginated response. If you pass an invalid value, the API returns empty results.')
+        .optional(),
+    limit: z
+        .number()
+        .int()
+        .gte(1)
+        .lte(10)
+        .describe('The max number of search results returned in the response.')
+        .default(10),
+});
+export const annotations = {
+    title: 'Searches for Postman elements in the public network.\n\n**When to Use This Tool:**\n- When the user asks for a specific named request (e.g., "find PayPal requests", "search for Stripe API requests")\n- When the user explicitly wants to search the public network\n- Do NOT use this for searching the user\'s own workspaces or collections (use getCollections or getWorkspaces instead)\n\n**Search Scope:**\n- Only searches the public network (public workspaces and collections)\n- Does not search private workspaces, team workspaces, or personal collections\n- Currently supports searching for requests (entityType: "requests")\n',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+};
+export async function handler(args, extra) {
+    try {
+        const endpoint = `/search/${args.entityType}`;
+        const query = new URLSearchParams();
+        if (args.q !== undefined)
+            query.set('q', String(args.q));
+        if (args.publisherIsVerified !== undefined)
+            query.set('publisherIsVerified', String(args.publisherIsVerified));
+        if (args.nextCursor !== undefined)
+            query.set('nextCursor', String(args.nextCursor));
+        if (args.limit !== undefined)
+            query.set('limit', String(args.limit));
+        const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
+        const options = {
+            headers: extra.headers,
+        };
+        const result = await extra.client.get(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);
+    }
+}

package/dist/src/tools/syncCollectionWithSpec.js

@@ -1,9 +1,5 @@
 import { z } from 'zod';
-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 = 'syncCollectionWithSpec';
 export const description = 'Syncs a collection generated from an API specification. This is an asynchronous endpoint that returns an HTTP \\`202 Accepted\\` response.\n\n**Note:**\n\n- This endpoint only supports the OpenAPI 3.0 specification type.\n- You can only sync collections generated from the given spec ID.\n';
 export const parameters = z.object({

package/dist/src/tools/syncSpecWithCollection.js

@@ -1,9 +1,5 @@
 import { z } from 'zod';
-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 = 'syncSpecWithCollection';
 export const description = 'Syncs an API specification linked to a collection. This is an asynchronous endpoint that returns an HTTP \\`202 Accepted\\` response.\n\n**Note:**\n\n- This endpoint only supports the OpenAPI 3.0 specification type.\n- You can only sync specs generated from the given collection ID.\n';
 export const parameters = z.object({

package/dist/src/tools/transferCollectionFolders.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 = 'transferCollectionFolders';
 export const description = 'Copies or moves folders into a collection or folder.';
 export const parameters = z.object({

package/dist/src/tools/transferCollectionRequests.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 = 'transferCollectionRequests';
 export const description = 'Copies or moves requests into a collection or folder.';
 export const parameters = z.object({

package/dist/src/tools/transferCollectionResponses.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 = 'transferCollectionResponses';
 export const description = 'Copies or moves responses into a request.';
 export const parameters = z.object({

package/dist/src/tools/unpublishDocumentation.js

@@ -1,9 +1,5 @@
 import { z } from 'zod';
-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 = 'unpublishDocumentation';
 export const description = "Unpublishes a collection's documentation. On success, this returns an HTTP \\`204 No Content\\` response.";
 export const parameters = z.object({

package/dist/src/tools/unpublishMock.js

@@ -1,9 +1,5 @@
 import { z } from 'zod';
-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 = 'unpublishMock';
 export const description = 'Unpublishes a mock server. Unpublishing a mock server sets its **Access Control** configuration setting to private.';
 export const parameters = z.object({ mockId: z.string().describe("The mock's ID.") });

package/dist/src/tools/updateApiCollectionComment.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 = 'updateApiCollectionComment';
 export const description = "Updates a comment on an API's collection.\n\n**Note:**\n\nThis endpoint accepts a max of 10,000 characters.\n";
 export const parameters = z.object({

package/dist/src/tools/updateCollectionComment.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 = 'updateCollectionComment';
 export const description = 'Updates a comment on a collection.\n\n**Note:**\n\nThis endpoint accepts a max of 10,000 characters.\n';
 export const parameters = z.object({

package/dist/src/tools/updateCollectionFolder.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 = 'updateCollectionFolder';
 export const description = 'Updates 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\n**Note:**\n\nThis endpoint acts like a PATCH method. It only updates the values that you pass in the request body (for example, the \\`name\\` property). The endpoint does not update the entire resource.\n';
 export const parameters = z.object({

package/dist/src/tools/updateCollectionRequest.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 = 'updateCollectionRequest';
 export const description = 'Updates a request in a collection. For a complete list of properties, refer to the **Request** entry in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html).\n\n**Note:**\n\n- You must pass a collection ID (\\`12ece9e1-2abf-4edc-8e34-de66e74114d2\\`), not a collection(\\`12345678-12ece9e1-2abf-4edc-8e34-de66e74114d2\\`), in this endpoint.\n- This endpoint does not support changing the folder of a request.\n';
 export const parameters = z.object({

package/dist/src/tools/updateCollectionResponse.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 = 'updateCollectionResponse';
 export const description = 'Updates a response in a collection. For a complete list of properties, see the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html).\n\n**Note:**\n\n- You must pass a collection ID (\\`12ece9e1-2abf-4edc-8e34-de66e74114d2\\`), not a collection UID (\\`12345678-12ece9e1-2abf-4edc-8e34-de66e74114d2\\`), in this endpoint.\n- This endpoint acts like a PATCH method. It only updates the values that you pass in the request body (for example, the \\`name\\` property). The endpoint does not update the entire resource.\n';
 export const parameters = z.object({

package/dist/src/tools/updateCollectionTags.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 = 'updateCollectionTags';
 export const description = "Updates a collection's associated tags. This endpoint replaces all existing tags with those you pass in the request body.";
 export const parameters = z.object({

package/dist/src/tools/updateFolderComment.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 = 'updateFolderComment';
 export const description = 'Updates a comment on a folder.\n\n**Note:**\n\nThis endpoint accepts a max of 10,000 characters.\n';
 export const parameters = z.object({

package/dist/src/tools/updateMock.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 = 'updateMock';
 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({

package/dist/src/tools/updateMonitor.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 = 'updateMonitor';
 export const description = "Updates a monitor's [configurations](https://learning.postman.com/docs/monitoring-your-api/setting-up-monitor/#configure-a-monitor).";
 export const parameters = z.object({

package/dist/src/tools/updatePanElementOrFolder.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 = 'updatePanElementOrFolder';
 export const description = "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";
 export const parameters = z.object({

package/dist/src/tools/updateRequestComment.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 = 'updateRequestComment';
 export const description = 'Updates a comment on a request.\n\n**Note:**\n\nThis endpoint accepts a max of 10,000 characters.\n';
 export const parameters = z.object({

package/dist/src/tools/updateResponseComment.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 = 'updateResponseComment';
 export const description = 'Updates a comment on a response.\n\n**Note:**\n\nThis endpoint accepts a max of 10,000 characters.\n';
 export const parameters = z.object({

package/dist/src/tools/updateSpecFile.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 = 'updateSpecFile';
 export const description = "Updates an API specification's file.\n\n**Note:**\n\n- This endpoint does not accept an empty request body. You must pass one of the accepted values.\n- This endpoint does not accept multiple request body properties in a single call. For example, you cannot pass both the \\`content\\` and \\`type\\` property at the same time.\n- Multi-file specifications can only have one root file.\n- When updating a file type to \\`ROOT\\`, the previous root file is updated to the \\`DEFAULT\\` file type.\n- Files cannot exceed a maximum of 10 MB in size.\n";
 export const parameters = z.object({

package/dist/src/tools/updateSpecProperties.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 = 'updateSpecProperties';
 export const description = "Updates an API specification's properties, such as its name.";
 export const parameters = z.object({

package/dist/src/tools/updateWorkspace.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 = 'updateWorkspace';
 export const description = 'Updates a workspace.\n\n**Note:**\n\n- There are rate limits when publishing public workspaces.\n- Public team workspace names must be unique.\n\n### Important\n\nWe deprecated linking collections or environments between workspaces. We do not recommend that you do this.\n\nIf you have a linked collection or environment, note the following:\n- The endpoint does not create a clone of a collection or environment.\n- Any changes you make to a linked collection or environment changes them in all workspaces.\n- If you delete a collection or environment linked between workspaces, the system deletes it in all the workspaces.\n';
 export const parameters = z.object({

package/dist/src/tools/updateWorkspaceGlobalVariables.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 = 'updateWorkspaceGlobalVariables';
 export const description = "Updates and replaces a workspace's global [variables](https://learning.postman.com/docs/sending-requests/variables/#variable-scopes). This endpoint replaces all existing global variables with the variables you pass in the request body.";
 export const parameters = z.object({

package/dist/src/tools/updateWorkspaceTags.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 = 'updateWorkspaceTags';
 export const description = "Updates a workspace's associated tags. This endpoint replaces all existing tags with those you pass in the request body.";
 export const parameters = z.object({

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

@@ -0,0 +1,6 @@
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+export { McpError };
+export function asMcpError(error) {
+    const cause = error?.cause ?? String(error);
+    return new McpError(ErrorCode.InternalError, cause);
+}

package/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"