@postman/postman-mcp-server 2.7.0 → 2.8.0

package/dist/src/tools/deleteWorkspace.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'deleteWorkspace';
-export const description = 'Deletes an existing workspace.\n\n### Important\n\nIf you delete a workspace that has a linked collection or environment with another workspace, this will delete the collection and environment in all workspaces.\n';
+export const description = 'Deletes an existing workspace.';
 export const parameters = z.object({ workspaceId: z.string().describe("The workspace's ID.") });
 export const annotations = {
     title: 'Deletes an existing workspace.',

package/dist/src/tools/generateCollection.js

@@ -18,8 +18,8 @@ export const parameters = z.object({
             .describe('The option for setting the indentation character type.')
             .default('Space'),
         parametersResolution: z
-            .enum(['Schema', 'Example'])
-            .describe("Whether to generate the request and response parameters based on the specification or the specification's examples.")
+            .string()
+            .describe('Generated collections use examples for parameter generation by default. Any existing collections generated using the schema parameter generation will continue to sync using their existing strategy.')
             .default('Schema'),
         folderStrategy: z
             .enum(['Paths', 'Tags'])

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/getCodeGenerationInstructions.js

@@ -46,13 +46,19 @@ First, locate the collection the user wants to work with. Determine whether the
 
 ### For Public APIs
 
-Use \`searchPostmanElements\` to find public API collections:
+Use \`searchPostmanElementsInPublicNetwork\` to find public API collections:
 
-- \`searchPostmanElements(q, entityType: collections)\` - Search for public collections. E.g. if the user says "find the Stripe API and build a demo" then call this tool with the query "stripe" and entityType "collections". Review the collection(s) returned and select the best match. If multiple collections look viable, ask the user which one to use.
+- \`searchPostmanElementsInPublicNetwork(q, entityType: collections)\` - Search for public collections. E.g. if the user says "find the Stripe API and build a demo" then call this tool with the query "stripe" and entityType "collections". Review the collection(s) returned and select the best match. If multiple collections look viable, ask the user which one to use.
 
-### For Internal APIs
+### For Private APIs in the user's organization
 
-Use \`getWorkspaces\` and \`getWorkspace\` to find internal API collections:
+Use \`searchPostmanElementsInPrivateNetwork\` to find API collections in the Private API Network which is a central repository of trusted Workspaces within the organisation meant for discovery and reuse :
+
+- \`searchPostmanElementsInPrivateNetwork(q, entityType: collections)\` - Search for API collections in the Private API Network. E.g. if the user says "find the notification API and integrate it" then call this tool with the query "notification" and entityType "collections". Review the collection(s) returned and select the best match. If multiple API requests look viable, ask the user which one to use.
+
+### For user owned APIs
+
+Use \`getWorkspaces\` and \`getWorkspace\` to find user's internal API collections:
 
 - \`getWorkspaces()\` - Fetch all workspaces the user has access to. Look for a workspace with a name that matches what the user is looking for.
 
@@ -64,7 +70,7 @@ Once you've identified the target collection (from either path above):
 
 - \`getCollection(collectionId)\` - Fetch the collection details by passing its uid. IMPORTANT: Do NOT pass model=minimal or model=full, omit the model parameter entirely. The response will include collection-level documentation and a recursive itemRefs array with the names and uids of all folders and requests.
 
-**IMPORTANT:** Once you have established the collection, do NOT call searchPostmanElements or getWorkspaces again to find requests. Use getCollectionRequest to explore individual requests within the collection.
+**IMPORTANT:** Once you have established the collection, do NOT call searchPostmanElementsInPublicNetwork or searchPostmanElementsInPrivateNetwork or getWorkspaces again to find requests. Use getCollectionRequest to explore individual requests within the collection.
 
 ## 1.2 Explore Requests and Plan
 
@@ -90,7 +96,7 @@ Once you know which requests need code generated, gather all remaining context t
 
 - \`getCollectionResponse(responseId, collectionId, uid: true, populate: false)\` - Call this for response example uids returned from getCollectionRequest. Use the information for: creating response types in typed languages, adding response schema comments in untyped languages, and understanding both success and error cases.
 
-- \`getEnvironments(workspaceId)\` - Fetch all environments for the workspace that the collection belongs to (the workspaceId was returned from searchPostmanElements). ALWAYS pass a workspaceId. If you do not have a workspaceId, do NOT call this tool.
+- \`getEnvironments(workspaceId)\` - Fetch all environments for the workspace that the collection belongs to (the workspaceId was returned from searchPostmanElementsInPublicNetwork or searchPostmanElementsInPrivateNetwork). ALWAYS pass a workspaceId. If you do not have a workspaceId, do NOT call this tool.
 
 - \`getEnvironment(environmentId)\` - For each environment, fetch the full details to see what variables have been defined and retrieve their values.
 

package/dist/src/tools/getCollection/getCollectionMap.js

@@ -2,8 +2,8 @@ import { z } from 'zod';
 import { asMcpError, McpError } from '../utils/toolHelpers.js';
 export const method = 'getCollectionMap';
 export const description = `Get a Postman collection map with metadata and a complete recursive index of all folders and requests. Response includes collection metadata and description. Response includes itemRefs property (name and id only) instead of the full item array. After calling, present the collection summary and ask the user where they\'d like to explore next, calling getCollectionFolder and/or getCollectionRequest tools in parallel to get more data quickly.
-  Once you've called this tool, DO NOT call searchPostmanElements to find items in or related to this collection. Instead, use the map in itemRefs.
-  Only use searchPostmanElements to find the collection where a request may be. Then, stay in the collection and don't use the search.
+  Once you've called this tool, DO NOT call searchPostmanElementsInPublicNetwork to find items in or related to this collection. Instead, use the map in itemRefs.
+  Only use searchPostmanElementsInPublicNetwork to find the collection where a request may be. Then, stay in the collection and don't use the search.
   When using the getCollectionRequest tool to look up request data, omit the populate parameter to avoid getting all response examples
   back at once (can be very large). Instead, use the response ids from the return value and call getCollectionResponse for each one.
   Prepend the collection's ownerId to the front of each response id when passing it to getCollectionResponse. This is the first part of the collection uid.

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/pullCollectionChanges.js

@@ -2,7 +2,9 @@ import { z } from 'zod';
 import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'pullCollectionChanges';
 export const description = "Pulls the changes from a parent (source) collection into the forked collection. In the endpoint's response:\n\n- The \\`destinationId\\` is the ID of the forked collection.\n- The \\`sourceId\\` is the ID of the source collection.\n";
-export const parameters = z.object({ collectionId: z.string().describe("The collection's ID.") });
+export const parameters = z.object({
+    collectionId: z.string().describe("The forked collection's ID."),
+});
 export const annotations = {
     title: "Pulls the changes from a parent (source) collection into the forked collection. In the endpoint's response:",
     readOnlyHint: false,

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()
@@ -545,6 +545,16 @@ export const parameters = z.object({
             })
                 .describe('The [settings](https://learning.postman.com/docs/sending-requests/create-requests/request-settings/) used to alter the [Protocol Profile Behavior](https://github.com/postmanlabs/postman-runtime/blob/develop/docs/protocol-profile-behavior.md) of sending a request.')
                 .optional(),
+            createdAt: z
+                .string()
+                .datetime({ offset: true })
+                .describe('The date and time at which the collection item was created.')
+                .optional(),
+            updatedAt: z
+                .string()
+                .datetime({ offset: true })
+                .describe('The date and time at which the collection item was updated.')
+                .optional(),
             uid: z.string().describe("The collection item's unique ID.").optional(),
         })
             .describe('Information about the collection request or folder.')),

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);
+    }
+}