@postman/postman-mcp-server 2.7.1 → 2.8.1

package/dist/src/tools/getAnalyticsData.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { asMcpError, McpError } from './utils/toolHelpers.js';
+export const method = 'getAnalyticsData';
+export const description = 'Gets analytics data based on the specified resource, metrics, and given filters for team, internal, and public workspaces, as well as Partner Workspaces.\n\n**Note:**\n\nThis endpoint only accepts the following resource:metric query parameter combinations:\n- \\`user\\` — \\`workspace_active_users\\`, \\`active_users\\`\n- \\`workspace\\` — \\`elements_in_workspace\\`, \\`active_workspaces\\`, \\`api_calls\\`, \\`active_collections\\`, \\`response_status\\`, \\`pending_invites\\`, \\`needs_attention\\`, \\`success_rate\\`, \\`user_requests\\`, \\`collection_error_aggregate\\`\n- \\`team\\` — \\`user_api_journey\\`, \\`workspace_distribution\\`, \\`internal_workspace_distribution\\`, \\`license_consumption\\`, \\`partner_engagement_funnel\\`\n\nThe \\`view\\` query parameter only accepts the following values when called with the following resource:metric pairs:\n- \\`detailed\\` or \\`summary\\` — \\`user:active_users\\`, \\`workspace:active_workspaces\\`, \\`workspace:pending_invites\\`, \\`workspace:needs_attention\\`, \\`workspace:success_rate\\`, \\`team:partner_engagement_funnel\\`\n\\`summary\\` only — \\`workspace:elements_in_workspace\\`, \\`workspace:workspace_active_users\\`, \\`workspace:api_calls\\`, \\`workspace:response_status\\`, \\`team:user_api_journey\\`, \\`team:workspace_distribution\\`, \\`team:internal_workspace_distribution\\`, \\`team:license_consumption\\`\n- \\`detailed\\` only — \\`workspace:active_collections\\`, \\`workspace:user_requests\\`\n';
+export const parameters = z.object({
+    resource: z
+        .enum(['user', 'team', 'workspace'])
+        .describe('Returns metrics and insights for API usage, success, and workspace/team trends in Postman:\n\n- `user` — Data related to individual user activities and engagement within Postman workspaces.\n- `team` — Team-level analytics, license consumption, and organizational trends.\n- `workspace` — Workspace-level activities, elements, and collaboration patterns.\n'),
+    metrics: z
+        .string()
+        .describe('Filters the response by only the given metrics. The metric must match the given `resource` value.\n\nFor a list of metrics and their related `resource` value, call the GET `/analytics-metadata` endpoint.\n'),
+    view: z
+        .enum(['detailed', 'summary'])
+        .describe('The view type for the analytics data:\n  - `detailed` — Return extensive information.\n  - `summary` — Return aggregated information.\n')
+        .optional(),
+    workspaceType: z
+        .string()
+        .describe('A comma-separated list of `internal`, `public`, and `partner` workspace types to filter the results by.')
+        .optional(),
+    userId: z
+        .string()
+        .describe('A comma-separated list of user IDs to filter the results by. Only pass this parameter when calling the `user_requests` metric for the `workspace` resource.')
+        .optional(),
+    duration: z
+        .enum(['last_30_days', 'last_180_days', 'last_month', 'last_6_months'])
+        .describe('Filters the response by the given duration.')
+        .optional(),
+    requestId: z
+        .string()
+        .describe('A comma-separated list of unique request IDs (`userId`-`requestId`) to filter the response by. Only pass this parameter when using the `user_requests` metric.')
+        .optional(),
+    responseStatus: z
+        .string()
+        .describe('A comma-separated list of HTTP response status codes to filter the results by. Accepts values `100` through `600`. Only pass this parameter when using the `user_requests` metric.')
+        .optional(),
+    attentionType: z
+        .string()
+        .describe('A comma-separated list of issues types to filter the results by. Attention types provide details about issues users or partners are facing. Accepts the `high_non_200OK_rate_for_partner` and `no_success_on_tried_request` values. Only pass this parameter when using the `needs_attention` metric.')
+        .optional(),
+    limit: z
+        .number()
+        .int()
+        .gte(1)
+        .lte(10000)
+        .describe('The maximum number of rows to return in the response.')
+        .default(100),
+    offset: z
+        .number()
+        .int()
+        .gte(0)
+        .lte(10000)
+        .describe('The zero-based offset of the first item to return.')
+        .default(0),
+});
+export const annotations = {
+    title: 'Gets analytics data based on the specified resource, metrics, and given filters for team, internal, and public workspaces, as well as Partner Workspaces.',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+};
+export async function handler(args, extra) {
+    try {
+        const endpoint = `/analytics`;
+        const query = new URLSearchParams();
+        if (args.resource !== undefined)
+            query.set('resource', String(args.resource));
+        if (args.metrics !== undefined)
+            query.set('metrics', String(args.metrics));
+        if (args.view !== undefined)
+            query.set('view', String(args.view));
+        if (args.workspaceType !== undefined)
+            query.set('workspaceType', String(args.workspaceType));
+        if (args.userId !== undefined)
+            query.set('userId', String(args.userId));
+        if (args.duration !== undefined)
+            query.set('duration', String(args.duration));
+        if (args.requestId !== undefined)
+            query.set('requestId', String(args.requestId));
+        if (args.responseStatus !== undefined)
+            query.set('responseStatus', String(args.responseStatus));
+        if (args.attentionType !== undefined)
+            query.set('attentionType', String(args.attentionType));
+        if (args.limit !== undefined)
+            query.set('limit', String(args.limit));
+        if (args.offset !== undefined)
+            query.set('offset', String(args.offset));
+        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/getAnalyticsMetadata.js

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+import { asMcpError, McpError } from './utils/toolHelpers.js';
+export const method = 'getAnalyticsMetadata';
+export const description = 'Returns a catalog of analytics resources and their corresponding metrics for use with the GET /analytics endpoint. These metrics provide insights on API usage, success, workspace, and team trends in Postman.';
+export const parameters = z.object({
+    include: z
+        .string()
+        .describe('A comma-separated list of the additional information to include in the response. Accepts the `parameters` and `response` values.\n\nWhen you pass this query parameter and its values, the response provides detailed information, including parameters and response schemas for the given metrics.\n')
+        .optional(),
+    resources: z
+        .string()
+        .describe('A comma-separated list of resource types to filter the metrics by. Accepts the `user`, `workspace`, and `team` values.')
+        .optional(),
+    metrics: z
+        .string()
+        .describe("A comma-separated list of metrics values to use to filter the response.\n\nIf you don't pass this query parameter, then the response returns all metadata for all available metrics.\n")
+        .optional(),
+});
+export const annotations = {
+    title: 'Returns a catalog of analytics resources and their corresponding metrics for use with the GET /analytics endpoint. These metrics provide insights on API usage, success, workspace, and team trends in Postman.',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+};
+export async function handler(args, extra) {
+    try {
+        const endpoint = `/analytics-metadata`;
+        const query = new URLSearchParams();
+        if (args.include !== undefined)
+            query.set('include', String(args.include));
+        if (args.resources !== undefined)
+            query.set('resources', String(args.resources));
+        if (args.metrics !== undefined)
+            query.set('metrics', String(args.metrics));
+        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/getWorkspace.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'getWorkspace';
-export const description = "Gets information about a workspace.\n\n**Note:**\n\nThis endpoint's response contains the \\`visibility\\` field. [Visibility](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/managing-workspaces/#changing-workspace-visibility) determines who can access the workspace:\n- \\`personal\\` — Only you can access the workspace.\n- \\`team\\` — All team members can access the workspace.\n- \\`private\\` — Only invited team members can access the workspace ([**Professional** and **Enterprise** plans only](https://www.postman.com/pricing)).\n- \\`public\\` — Everyone can access the workspace.\n- \\`partner\\` — Only invited team members and [partners](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/partner-workspaces/) can access the workspace ([**Professional** and **Enterprise** plans only](https://www.postman.com/pricing)).\n";
+export const description = "Gets information about a workspace.\n\n**Note:**\n\nThis endpoint's response contains the \\`visibility\\` field. [Visibility](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/managing-workspaces/#changing-workspace-visibility) determines who can access the workspace:\n- \\`personal\\` — Only you can access the workspace.\n- \\`team\\` — All team members can access the workspace.\n- \\`private\\` — Only invited team members can access the workspace ([**Team** and **Enterprise** plans only](https://www.postman.com/pricing)).\n- \\`public\\` — Everyone can access the workspace.\n- \\`partner\\` — Only invited team members and [partners](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/partner-workspaces/) can access the workspace ([**Team** and **Enterprise** plans only](https://www.postman.com/pricing)).\n";
 export const parameters = z.object({
     workspaceId: z.string().describe("The workspace's ID."),
     include: z

package/dist/src/tools/{getAllPanAddElementRequests.js → listPrivateNetworkAddRequests.js}

@@ -1,31 +1,24 @@
 import { z } from 'zod';
 import { asMcpError, McpError } from './utils/toolHelpers.js';
-export const method = 'getAllPanAddElementRequests';
-export const description = "Gets a list requests to add elements to your team's [Private API Network](https://learning.postman.com/docs/collaborating-in-postman/adding-private-network/).";
+export const method = 'listPrivateNetworkAddRequests';
+export const description = "Gets all requests to add workspaces to your team's Private API Network.\n\nWARNING: This tool is for Private API Network management, not for general workspace operations. For workspace management use: getWorkspaces, getWorkspace, createWorkspace, updateWorkspace, deleteWorkspace.\n";
 export const parameters = z.object({
     since: z
         .string()
         .datetime({ offset: true })
-        .describe('Return only results created since the given time, in [ISO 8601](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) format. This value cannot be later than the `until` value. To use time-numoffset format, you must use `%2B` URL-encoding for the `+` character.')
+        .describe('Return only results created since the given time, in [ISO 8601](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) format. This value cannot be later than the `until` value. To use `time-numoffset` format, you must use `%2B` URL-encoding for the `+` character.')
         .optional(),
     until: z
         .string()
         .datetime({ offset: true })
-        .describe('Return only results created until this given time, in [ISO 8601](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) format. This value cannot be earlier than the `since` value. To use time-numoffset format, you must use `%2B` URL-encoding for the `+` character.')
-        .optional(),
-    requestedBy: z
-        .number()
-        .int()
-        .describe("Return a user's element requests by their user ID.")
-        .optional(),
-    type: z
-        .enum(['api', 'folder', 'collection', 'workspace'])
-        .describe('Filter by the element type.')
+        .describe('Return only results created until this given time, in [ISO 8601](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) format. This value cannot be earlier than the `since` value. To use `time-numoffset` format, you must use `%2B` URL-encoding for the `+` character.')
         .optional(),
+    requestedBy: z.number().int().describe("Return a user's requests by their user ID.").optional(),
+    type: z.literal('workspace').describe('The `workspace` value.').optional(),
     status: z.enum(['pending', 'denied']).describe('Filter by the request status.').optional(),
     name: z
         .string()
-        .describe('Return only elements whose name includes the given value. Matching is not case-sensitive.')
+        .describe('Return only workspaces whose name includes the given value. Matching is not case-sensitive.')
         .optional(),
     sort: z
         .enum(['createdAt', 'updatedAt'])
@@ -43,11 +36,11 @@ export const parameters = z.object({
     limit: z
         .number()
         .int()
-        .describe('The maximum number of elements to return. If the value exceeds the maximum value of `1000`, then the system uses the `1000` value.')
+        .describe('The maximum number of results to return. If the value exceeds the maximum value of `1000`, then the system uses the `1000` value.')
         .default(1000),
 });
 export const annotations = {
-    title: "Gets a list requests to add elements to your team's [Private API Network](https://learning.postman.com/docs/collaborating-in-postman/adding-private-network/).",
+    title: "Gets all requests to add workspaces to your team's Private API Network.",
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/{getAllElementsAndFolders.js → listPrivateNetworkWorkspaces.js}

@@ -1,8 +1,21 @@
 import { z } from 'zod';
 import { asMcpError, McpError } from './utils/toolHelpers.js';
-export const method = 'getAllElementsAndFolders';
-export const description = "Gets information about the folders and their elements added to your team's [Private API Network](https://learning.postman.com/docs/collaborating-in-postman/adding-private-network/).\n\n**Note:**\n\nThe \\`limit\\` and \\`offset\\` parameters are separately applied to elements and folders. For example, if you query a \\`limit\\` value of \\`10\\` and an \\`offset\\` value \\`0\\`, the endpoint returns 10 elements and 10 folders for a total of 20 items. The \\`totalCount\\` property in the \\`meta\\` response is the total count of both elements and folders.\n";
+export const method = 'listPrivateNetworkWorkspaces';
+export const description = "Gets information about workspaces added to your team's Private API Network.\n\nWARNING: This tool is for Private API Network management, not for general workspace operations. For workspace management use: getWorkspaces, getWorkspace, createWorkspace, updateWorkspace, deleteWorkspace.\n";
 export const parameters = z.object({
+    type: z.literal('workspace').describe('The `workspace` value.').optional(),
+    name: z
+        .string()
+        .describe('Return only workspaces whose name includes the given value. Matching is not case-sensitive.')
+        .optional(),
+    summary: z
+        .string()
+        .describe('Return only workspaces whose summary includes the given value. Matching is not case-sensitive.')
+        .optional(),
+    description: z
+        .string()
+        .describe('Return only workspaces whose description includes the given value. Matching is not case-sensitive.')
+        .optional(),
     since: z
         .string()
         .datetime({ offset: true })
@@ -16,19 +29,7 @@ export const parameters = z.object({
     addedBy: z
         .number()
         .int()
-        .describe('Return only elements published by the given user ID.')
-        .optional(),
-    name: z
-        .string()
-        .describe('Return only elements whose name includes the given value. Matching is not case-sensitive.')
-        .optional(),
-    summary: z
-        .string()
-        .describe('Return only elements whose summary includes the given value. Matching is not case-sensitive.')
-        .optional(),
-    description: z
-        .string()
-        .describe('Return only elements whose description includes the given value. Matching is not case-sensitive.')
+        .describe('Return only workspaces published by the given user ID.')
         .optional(),
     sort: z
         .enum(['createdAt', 'updatedAt'])
@@ -51,20 +52,12 @@ export const parameters = z.object({
     limit: z
         .number()
         .int()
-        .describe('The maximum number of elements to return. If the value exceeds the maximum value of `1000`, then the system uses the `1000` value.')
+        .describe('The maximum number of results to return. If the value exceeds the maximum value of `1000`, then the system uses the `1000` value.')
         .default(1000),
-    parentFolderId: z
-        .number()
-        .int()
-        .describe("Return the folders and elements in a specific folder. If this value is `0`, then the endpoint only returns the root folder's elements.")
-        .default(0),
-    type: z
-        .enum(['api', 'folder', 'collection', 'workspace'])
-        .describe('Filter by the element type.')
-        .optional(),
+    parentFolderId: z.number().int().describe('This parameter is deprecated.').default(0),
 });
 export const annotations = {
-    title: "Gets information about the folders and their elements added to your team's [Private API Network](https://learning.postman.com/docs/collaborating-in-postman/adding-private-network/).",
+    title: "Gets information about workspaces added to your team's Private API Network.",
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,
@@ -73,18 +66,20 @@ export async function handler(args, extra) {
     try {
         const endpoint = `/network/private`;
         const query = new URLSearchParams();
-        if (args.since !== undefined)
-            query.set('since', String(args.since));
-        if (args.until !== undefined)
-            query.set('until', String(args.until));
-        if (args.addedBy !== undefined)
-            query.set('addedBy', String(args.addedBy));
+        if (args.type !== undefined)
+            query.set('type', String(args.type));
         if (args.name !== undefined)
             query.set('name', String(args.name));
         if (args.summary !== undefined)
             query.set('summary', String(args.summary));
         if (args.description !== undefined)
             query.set('description', String(args.description));
+        if (args.since !== undefined)
+            query.set('since', String(args.since));
+        if (args.until !== undefined)
+            query.set('until', String(args.until));
+        if (args.addedBy !== undefined)
+            query.set('addedBy', String(args.addedBy));
         if (args.sort !== undefined)
             query.set('sort', String(args.sort));
         if (args.direction !== undefined)
@@ -97,8 +92,6 @@ export async function handler(args, extra) {
             query.set('limit', String(args.limit));
         if (args.parentFolderId !== undefined)
             query.set('parentFolderId', String(args.parentFolderId));
-        if (args.type !== undefined)
-            query.set('type', String(args.type));
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {
             headers: extra.headers,

package/dist/src/tools/publishDocumentation.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
 import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'publishDocumentation';
-export const description = "Publishes a collection's documentation. This makes it publicly available to anyone with the link to the documentation.\n\n**Note:**\n\n- Your [Postman plan](https://www.postman.com/pricing/) impacts your use of these endpoints:\n  - For **Free** and **Basic** users, you must have permissions to edit the collection.\n  - If [API Governance and Security](https://learning.postman.com/docs/api-governance/configurable-rules/configurable-rules-overview/) is enabled for your [**Enterprise**](https://www.postman.com/pricing/) team, only users with the [Community Manager role](https://learning.postman.com/docs/collaborating-in-postman/roles-and-permissions/#team-roles) can publish documentation.\n- Publishing is only supported for collections with HTTP requests.\n- You cannot publish a collection added to an API.\n";
+export const description = "Publishes a collection's documentation. This makes it publicly available to anyone with the link to the documentation.\n\n**Note:**\n\n- Your [Postman plan](https://www.postman.com/pricing/) impacts your use of these endpoints:\n  - For **Free** and **Solo** users, you must have permissions to edit the collection.\n  - If [API Governance and Security](https://learning.postman.com/docs/api-governance/configurable-rules/configurable-rules-overview/) is enabled for your [**Enterprise**](https://www.postman.com/pricing/) team, only users with the [Community Manager role](https://learning.postman.com/docs/collaborating-in-postman/roles-and-permissions/#team-roles) can publish documentation.\n- Publishing is only supported for collections with HTTP requests.\n- You cannot publish a collection added to an API.\n";
 export const parameters = z.object({
     collectionId: z.string().describe("The collection's unique ID."),
     environmentUid: z

package/dist/src/tools/putCollection.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
 import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'putCollection';
-export const description = "Replaces the contents of 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). Include the collection's ID values in the request body. If you do not, the endpoint removes the existing items and creates new items.\n\nTo perform an update asynchronously, use the \\`Prefer\\` header with the \\`respond-async\\` value. When performing an async update, this endpoint returns a HTTP \\`202 Accepted\\` response.\n\n**Note:**\n\n- The maximum collection size this endpoint accepts cannot exceed 100 MB.\n- If you don't include the collection items' ID values from the request body, the endpoint **removes** the existing items and recreates the items with new ID values.\n- To copy another collection's contents to the given collection, remove all ID values before you pass it in this endpoint. If you do not, this endpoint returns an error. These values include the \\`id\\`, \\`uid\\`, and \\`postman_id\\` values.\n- For protocol profile behavior, refer to Postman's [Protocol Profile Behavior documentation](https://github.com/postmanlabs/postman-runtime/blob/develop/docs/protocol-profile-behavior.md).\n";
+export const description = "Replaces the contents of 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). Include the collection's ID values in the request body. If you do not, the endpoint removes the existing items and creates new items.\n\n- To perform an update asynchronously, use the \\`Prefer\\` header with the \\`respond-async\\` value. When performing an async update, this endpoint returns a HTTP \\`202 Accepted\\` response.\n- For a complete list of properties and information, see the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html).\n- For protocol profile behavior, refer to Postman's [Protocol Profile Behavior documentation](https://github.com/postmanlabs/postman-runtime/blob/develop/docs/protocol-profile-behavior.md).\n\n**Note:**\n\n- The maximum collection size this endpoint accepts cannot exceed 100 MB.\n- Use the GET \\`/collection-updates-tasks/{taskId}\\` endpoint to get the collection's update status when performing an asynchronous update.\n- If you don't include the collection items' ID values from the request body, the endpoint **removes** the existing items and recreates the items with new ID values.\n- To copy another collection's contents to the given collection, remove all ID values before you pass it in this endpoint. If you do not, this endpoint returns an error. These values include the \\`id\\`, \\`uid\\`, and \\`postman_id\\` values.\n";
 export const parameters = z.object({
     collectionId: z
         .string()

package/dist/src/tools/removeWorkspaceFromPrivateNetwork.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { asMcpError, McpError } from './utils/toolHelpers.js';
+export const method = 'removeWorkspaceFromPrivateNetwork';
+export const description = "Removes a workspace from your team's Private API Network. This does not delete the workspace itself — it only removes it from the Private API Network folder.\n\nWARNING: This tool is for Private API Network management, not for general workspace operations. For workspace management use: getWorkspaces, getWorkspace, createWorkspace, updateWorkspace, deleteWorkspace.\n";
+export const parameters = z.object({ workspaceId: z.string().describe("The workspace's ID.") });
+export const annotations = {
+    title: "Removes a workspace from your team's Private API Network. This does not delete the workspace itself — it only removes it from the Private API Network folder.",
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: true,
+};
+export async function handler(args, extra) {
+    try {
+        const endpoint = `/network/private/workspace/${args.workspaceId}`;
+        const query = new URLSearchParams();
+        const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
+        const options = {
+            headers: extra.headers,
+        };
+        const result = await extra.client.delete(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/resolveCommentThread.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'resolveCommentThread';
-export const description = 'Resolves a comment and any associated replies. On success, this returns an HTTP \\`204 No Content\\` response.\n\nComment thread IDs return in the GET comments response for [APIs](https://www.postman.com/postman/workspace/postman-public-workspace/request/12959542-2103ea20-f7de-4628-90e6-b823b3084a52), [collections](https://www.postman.com/postman/workspace/postman-public-workspace/request/12959542-a6582e0a-9382-4760-8b91-53a8aa6cb8d7), and [collection items](https://www.postman.com/postman/workspace/postman-public-workspace/folder/12959542-efeda219-66e1-474c-a83b-253d15723bf7).\n';
+export const description = 'Resolves a comment and any associated replies. On success, this returns an HTTP \\`204 No Content\\` response.\n\nComment thread IDs return in the GET \\`/comments\\` response for [collections](https://www.postman.com/postman/workspace/postman-public-workspace/request/12959542-a6582e0a-9382-4760-8b91-53a8aa6cb8d7) and [collection items](https://www.postman.com/postman/workspace/postman-public-workspace/folder/12959542-efeda219-66e1-474c-a83b-253d15723bf7).\n';
 export const parameters = z.object({
     threadId: z.number().int().describe("The comment's thread ID."),
 });

package/dist/src/tools/respondPrivateNetworkAddRequest.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { ContentType } from '../clients/postman.js';
+import { asMcpError, McpError } from './utils/toolHelpers.js';
+export const method = 'respondPrivateNetworkAddRequest';
+export const description = "Responds to a user's request to add a workspace to your team's Private API Network. Only managers can approve or deny a request. Once approved, the workspace will appear in the team's Private API Network.\n\nWARNING: This tool is for Private API Network management, not for general workspace operations. For workspace management use: getWorkspaces, getWorkspace, createWorkspace, updateWorkspace, deleteWorkspace.\n";
+export const parameters = z.object({
+    requestId: z.number().int().describe("The request's ID."),
+    status: z.enum(['denied', 'approved']).describe("The request's approval status."),
+    response: z
+        .object({
+        message: z
+            .string()
+            .describe("A message that details why the user's request was denied.")
+            .optional(),
+    })
+        .describe("If the request is denied, the response to the user's request.")
+        .optional(),
+});
+export const annotations = {
+    title: "Responds to a user's request to add a workspace to your team's Private API Network. Only managers can approve or deny a request. Once approved, the workspace will appear in the team's Private API Network.",
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: true,
+};
+export async function handler(args, extra) {
+    try {
+        const endpoint = `/network/private/network-entity/request/${args.requestId}`;
+        const query = new URLSearchParams();
+        const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
+        const bodyPayload = {};
+        if (args.status !== undefined)
+            bodyPayload.status = args.status;
+        if (args.response !== undefined)
+            bodyPayload.response = args.response;
+        const options = {
+            body: JSON.stringify(bodyPayload),
+            contentType: ContentType.Json,
+            headers: extra.headers,
+        };
+        const result = await extra.client.put(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/updateCollectionRequest.js

@@ -6,7 +6,7 @@ export const description = 'Updates a request in a collection. For a complete li
 export const parameters = z.object({
     requestId: z.string().describe("The request's ID."),
     collectionId: z.string().describe("The collection's ID."),
-    name: z.string().describe('Name of the request. Only provided fields are updated.').optional(),
+    name: z.string().describe("The request's name.").optional(),
     description: z.string().nullable().describe("The request's description.").optional(),
     method: z
         .enum([
@@ -26,7 +26,6 @@ export const parameters = z.object({
         'PROPFIND',
         'VIEW',
     ])
-        .nullable()
         .describe("The request's HTTP method.")
         .optional(),
     url: z.string().nullable().describe("The request's URL.").optional(),
@@ -34,7 +33,7 @@ export const parameters = z.object({
         .array(z.object({
         key: z.string().describe("The header's key.").optional(),
         value: z.string().describe("The header's value.").optional(),
-        description: z.string().nullable().describe("The header's description.").optional(),
+        description: z.string().describe("The header's description.").optional(),
     }))
         .describe("The request's headers.")
         .optional(),
@@ -42,25 +41,20 @@ export const parameters = z.object({
         .array(z.object({
         key: z.string().describe("The query parameter's key.").optional(),
         value: z.string().describe("The query parameter's value.").optional(),
-        description: z
-            .string()
-            .nullable()
-            .describe("The query parameter's description.")
-            .optional(),
+        description: z.string().describe("The query parameter's description.").optional(),
         enabled: z.boolean().describe('If true, the query parameter is enabled.').optional(),
     }))
         .describe("The request's query parameters.")
         .optional(),
     dataMode: z
         .enum(['raw', 'urlencoded', 'formdata', 'binary', 'graphql'])
-        .nullable()
         .describe("The request body's data mode.")
         .optional(),
     data: z
         .array(z.object({
         key: z.string().describe("The form data's key.").optional(),
         value: z.string().describe("The form data's value.").optional(),
-        description: z.string().nullable().describe("The form data's description.").optional(),
+        description: z.string().describe("The form data's description.").optional(),
         enabled: z.boolean().describe('If true, the form data entry is enabled.').optional(),
         type: z.enum(['text', 'file']).describe("The form data's type.").optional(),
         uuid: z.string().describe("The form data entry's unique identifier.").optional(),
@@ -81,7 +75,6 @@ export const parameters = z.object({
         .object({
         raw: z
             .object({ language: z.string().describe("The raw mode data's language type.").optional() })
-            .catchall(z.unknown())
             .describe('Options for the `raw` data mode.')
             .optional(),
         urlencoded: z
@@ -321,7 +314,7 @@ export const parameters = z.object({
         .optional(),
     events: z
         .array(z.object({
-        listen: z.enum(['test', 'prerequest']).describe('The event type.'),
+        listen: z.enum(['test', 'prerequest']).describe('The event type.').optional(),
         script: z
             .object({
             id: z.string().describe("The script's ID.").optional(),
@@ -337,6 +330,7 @@ export const parameters = z.object({
             .describe('Information about the Javascript code that can be used to to perform setup or teardown operations in a response.')
             .optional(),
     }))
+        .nullable()
         .describe('A list of scripts configured to run when specific events occur.')
         .optional(),
 });