@postman/postman-mcp-server 2.6.1 → 2.7.1

package/dist/src/tools/deletePanElementOrFolder.js

@@ -9,7 +9,7 @@ export const parameters = z.object({
     elementType: z.enum(['api', 'folder', 'collection', 'workspace']).describe('The element type.'),
 });
 export const annotations = {
-    title: "Removes an element or delete a folder from your team's [Private API Network](https://learning.postman.com/docs/collaborating-in-postman/adding-private-network/).\n\n**Note:**\n\nRemoving an API, collection, or workspace element does not delete it. It only removes it from the Private API Network folder.\n",
+    title: "Removes an element or delete a folder from your team's [Private API Network](https://learning.postman.com/docs/collaborating-in-postman/adding-private-network/).",
     readOnlyHint: false,
     destructiveHint: true,
     idempotentHint: true,

package/dist/src/tools/deleteRequestComment.js

@@ -8,7 +8,7 @@ export const parameters = z.object({
     commentId: z.number().int().describe("The comment's ID."),
 });
 export const annotations = {
-    title: 'Deletes a comment from a request. On success, this returns an HTTP \\`204 No Content\\` response.\n\n**Note:**\n\nDeleting the first comment of a thread deletes all the comments in the thread.\n',
+    title: 'Deletes a comment from a request. On success, this returns an HTTP \\`204 No Content\\` response.',
     readOnlyHint: false,
     destructiveHint: true,
     idempotentHint: true,

package/dist/src/tools/deleteResponseComment.js

@@ -8,7 +8,7 @@ export const parameters = z.object({
     commentId: z.number().int().describe("The comment's ID."),
 });
 export const annotations = {
-    title: 'Deletes a comment from a response. On success, this returns an HTTP \\`204 No Content\\` response.\n\n**Note:**\n\nDeleting the first comment of a thread deletes all the comments in the thread.\n',
+    title: 'Deletes a comment from a response. On success, this returns an HTTP \\`204 No Content\\` response.',
     readOnlyHint: false,
     destructiveHint: true,
     idempotentHint: true,

package/dist/src/tools/deleteWorkspace.js

@@ -4,7 +4,7 @@ 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 parameters = z.object({ workspaceId: z.string().describe("The workspace's ID.") });
 export const annotations = {
-    title: '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',
+    title: 'Deletes an existing workspace.',
     readOnlyHint: false,
     destructiveHint: true,
     idempotentHint: true,

package/dist/src/tools/duplicateCollection.js

@@ -12,7 +12,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: "Creates a duplicate of the given collection in another workspace.\n\nUse the GET \\`/collection-duplicate-tasks/{taskId}\\` endpoint to get the duplication task's current status.\n",
+    title: 'Creates a duplicate of the given collection in another workspace.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,

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'])
@@ -54,7 +54,7 @@ export const parameters = z.object({
         .default({ enableOptionalParameters: true, folderStrategy: 'Paths' }),
 });
 export const annotations = {
-    title: 'Creates a collection from the given API specification.\nThe specification must already exist or be created before it can be used to generate a collection.\nThe response contains a polling link to the task status.\n',
+    title: 'Creates a collection from the given API specification.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,

package/dist/src/tools/getAllElementsAndFolders.js

@@ -64,7 +64,7 @@ export const parameters = z.object({
         .optional(),
 });
 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/).\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",
+    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/).",
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/getAuthenticatedUser.js

@@ -4,7 +4,7 @@ export const method = 'getAuthenticatedUser';
 export const description = 'Gets information about the authenticated user.\n- This endpoint provides “current user” context (\\`user.id\\`, \\`username\\`, \\`teamId\\`, roles).\n- When a user asks for “my …” (e.g., “my workspaces, my information, etc.”), call this first to resolve the user ID.\n';
 export const parameters = z.object({});
 export const annotations = {
-    title: 'Gets information about the authenticated user.\n- This endpoint provides “current user” context (\\`user.id\\`, \\`username\\`, \\`teamId\\`, roles).\n- When a user asks for “my …” (e.g., “my workspaces, my information, etc.”), call this first to resolve the user ID.\n',
+    title: 'Gets information about the authenticated user.',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,

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: requests)\` - Search for public collections by finding requests and extracting the unique collection uids from the response. E.g. if the user says "find the Stripe API and build a demo" then call this tool with the query "stripe" and entityType "requests". Ignore the individual requests returned and extract the collection uids for the collection(s) that appear to be 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.
 
@@ -250,10 +256,10 @@ JavaScript/TypeScript:
 \`\`\`javascript
 /**
  * Generated by Postman Code
- * 
+ *
  * Collection: Stripe API
  * Collection UID: 12345678-1234-1234-1234-123456789abc
- * 
+ *
  * Request: Payment Intents > Create Payment Intent
  * Request UID: 87654321-4321-4321-4321-cba987654321
  * Request modified at: 2024-11-10T15:45:30.000Z
@@ -337,15 +343,15 @@ switch (response.status) {
   case 404:
     console.error('Resource not found');
     throw new NotFoundError(await response.json());
-  
+
   case 401:
     console.error('Authentication failed');
     throw new UnauthorizedError(await response.json());
-  
+
   case 422:
     console.error('Validation failed');
     throw new ValidationError(await response.json());
-  
+
   default:
     console.error('Unexpected error');
     throw new Error(await response.text());

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

@@ -4,7 +4,7 @@ export const method = 'getMock';
 export const description = 'Gets information about a mock server.\n- Resource: Mock server entity. Response includes the associated \\`collection\\` UID and \\`mockUrl\\`.\n- Use the \\`collection\\` UID to navigate back to the source collection.\n';
 export const parameters = z.object({ mockId: z.string().describe("The mock's ID.") });
 export const annotations = {
-    title: 'Gets information about a mock server.\n- Resource: Mock server entity. Response includes the associated \\`collection\\` UID and \\`mockUrl\\`.\n- Use the \\`collection\\` UID to navigate back to the source collection.\n',
+    title: 'Gets information about a mock server.',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/getMocks.js

@@ -13,7 +13,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Gets all active mock servers. By default, returns only mock servers you created across all workspaces.\n\n- Always pass either the \\`workspace\\` or \\`teamId\\` query to scope results. Prefer \\`workspace\\` when known.\n- If you need team-scoped results, set \\`teamId\\` from the current user: call GET \\`/me\\` and use \\`me.teamId\\`.\n- If both \\`teamId\\` and \\`workspace\\` are passed, only \\`workspace\\` is used.\n',
+    title: 'Gets all active mock servers. By default, returns only mock servers you created across all workspaces.',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/getSourceCollectionStatus.js

@@ -4,7 +4,7 @@ export const method = 'getSourceCollectionStatus';
 export const description = 'Checks whether there is a change between the forked collection and its parent (source) collection.\n\nIf the value of the \\`isSourceAhead\\` property is \\`true\\` in the response, then there is a difference between the forked collection and its source collection.\n\n**Note:**\n\nThis endpoint may take a few minutes to return an updated \\`isSourceAhead\\` status.\n';
 export const parameters = z.object({ collectionId: z.string().describe("The collection's ID.") });
 export const annotations = {
-    title: 'Checks whether there is a change between the forked collection and its parent (source) collection.\n\nIf the value of the \\`isSourceAhead\\` property is \\`true\\` in the response, then there is a difference between the forked collection and its source collection.\n\n**Note:**\n\nThis endpoint may take a few minutes to return an updated \\`isSourceAhead\\` status.\n',
+    title: 'Checks whether there is a change between the forked collection and its parent (source) collection.',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/getTaggedEntities.js

@@ -29,7 +29,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Gets Postman elements (entities) by a given tag. Tags enable you to organize and search [workspaces](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/managing-workspaces/#tagging-a-workspace), [APIs](https://learning.postman.com/docs/designing-and-developing-your-api/managing-apis/#tagging-apis), and [collections](https://learning.postman.com/docs/collections/using-collections/#tagging-a-collection) that contain shared tags.\n\n**Note:**\n\nTagging is available on Postman [**Enterprise** plans](https://www.postman.com/pricing/).\n',
+    title: 'Gets Postman elements (entities) by a given tag. Tags enable you to organize and search [workspaces](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/managing-workspaces/#tagging-a-workspace), [APIs](https://learning.postman.com/docs/designing-and-developing-your-api/managing-apis/#tagging-apis), and [collections](https://learning.postman.com/docs/collections/using-collections/#tagging-a-collection) that contain shared tags.',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/getWorkspace.js

@@ -10,7 +10,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: "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",
+    title: 'Gets information about a workspace.',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/getWorkspaces.js

@@ -18,7 +18,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: "Gets all workspaces you have access to.\n- For “my …” requests, first call GET \\`/me\\` and pass \\`createdBy={me.user.id}\\`.\n- This endpoint's response contains the visibility field. 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).\n  - \\`public\\` — Everyone can access the workspace.\n  - \\`partner\\` — Invited team members and partners (Professional and Enterprise).\n- For tools that require the workspace ID, and no workspace ID is provided, ask the user to provide the workspace ID. If the user does not provide the workspace ID, call this first with the createdBy parameter to use the first workspace.\n- Examples:\n  - “List my workspaces” → GET \\`/me\\`, then GET \\`/workspaces?createdBy={me.user.id}\\`\n  - “List my personal workspaces” → GET \\`/me\\`, then GET \\`/workspaces?type=personal&createdBy={me.user.id}\\`\n  - “List all public workspaces” → GET \\`/workspaces?type=public\\`\n",
+    title: 'Gets all workspaces you have access to.',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/mergeCollectionFork.js

@@ -12,7 +12,7 @@ export const parameters = z.object({
         .default('updateSourceWithDestination'),
 });
 export const annotations = {
-    title: '**This endpoint is deprecated.**\n\nMerges a forked collection back into its parent collection. You must have the [Editor role](https://learning.postman.com/docs/collaborating-in-postman/roles-and-permissions/#collection-roles) for the collection to merge a fork.\n',
+    title: '**This endpoint is deprecated.**',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,

package/dist/src/tools/patchCollection.js

@@ -279,7 +279,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Updates specific collection information, such as its name, events, or its variables. For more information, see the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html).\n',
+    title: 'Updates specific collection information, such as its name, events, or its variables. For more information, see the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html).',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/patchEnvironment.js

@@ -47,7 +47,7 @@ export const parameters = z.object({
     ]),
 });
 export const annotations = {
-    title: 'Updates specific environment properties, such as its name and variables.\n\n**Note:**\n\n- You can only perform one type of operation at a time. For example, you cannot perform an \\`add\\` and \\`replace\\` operation in the same call.\n- The request body size cannot exceed the maximum allowed size of 30MB.\n- If you receive an HTTP \\`411 Length Required\\` error response, manually pass the \\`Content-Length\\` header and its value in the request header.\n- To add a description to an existing variable, use the \\`add\\` operation.\n',
+    title: 'Updates specific environment properties, such as its name and variables.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/postPanElementOrFolder.js

@@ -49,7 +49,7 @@ export const parameters = z.object({
     ]),
 });
 export const annotations = {
-    title: "Publishes a element or creates a folder in your team's [Private API Network](https://learning.postman.com/docs/collaborating-in-postman/adding-private-network/). An element is a Postman API, collection, or workspace.\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",
+    title: "Publishes a element or creates a folder in your team's [Private API Network](https://learning.postman.com/docs/collaborating-in-postman/adding-private-network/). An element is a Postman API, collection, or workspace.",
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,

package/dist/src/tools/publishDocumentation.js

@@ -81,7 +81,7 @@ export const parameters = z.object({
         .describe("Information about the documentation's customization."),
 });
 export const annotations = {
-    title: "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",
+    title: "Publishes a collection's documentation. This makes it publicly available to anyone with the link to the documentation.",
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/pullCollectionChanges.js

@@ -2,9 +2,11 @@ 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:\n\n- The \\`destinationId\\` is the ID of the forked collection.\n- The \\`sourceId\\` is the ID of the source collection.\n",
+    title: "Pulls the changes from a parent (source) collection into the forked collection. In the endpoint's response:",
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/putCollection.js

@@ -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.')),
@@ -877,7 +887,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: "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",
+    title: "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.",
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/putEnvironment.js

@@ -28,7 +28,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Replaces all the contents of an environment with the given information.\n\n**Note:**\n\n- The request body size cannot exceed the maximum allowed size of 30MB.\n- If you receive an HTTP \\`411 Length Required\\` error response, manually pass the \\`Content-Length\\` header and its value in the request header.\n',
+    title: 'Replaces all the contents of an environment with the given information.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/resolveCommentThread.js

@@ -6,7 +6,7 @@ export const parameters = z.object({
     threadId: z.number().int().describe("The comment's thread ID."),
 });
 export const annotations = {
-    title: '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',
+    title: 'Resolves a comment and any associated replies. On success, this returns an HTTP \\`204 No Content\\` response.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,

package/dist/src/tools/runMonitor.js

@@ -10,7 +10,7 @@ export const parameters = z.object({
         .default(false),
 });
 export const annotations = {
-    title: "Runs a monitor and returns its run results.\n\n**Note:**\n\n- If you pass the \\`async=true\\` query parameter, the response does not return the \\`stats\\`, \\`executions\\`, and \\`failures\\` responses. To get this information for an asynchronous run, call the GET \\`/monitors/{id}\\` endpoint.\n- If the call exceeds 300 seconds, the endpoint returns an HTTP \\`202 Accepted\\` response. Use the GET \\`/monitors/{id}\\` endpoint to check the run's status in the response's \\`lastRun\\` property. To avoid this, it is recommended that you include the \\`async=true\\` query parameter when using this endpoint.\n",
+    title: 'Runs a monitor and returns its run results.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,

package/dist/src/tools/searchPostmanElementsInPrivateNetwork.js

@@ -0,0 +1,127 @@
+import { z } from 'zod';
+import { ContentType } from '../clients/postman.js';
+import { asMcpError, McpError } from './utils/toolHelpers.js';
+export const method = 'searchPostmanElementsInPrivateNetwork';
+export const description = `Search for API requests and collections in your organization's Private API Network—a curated repository of trusted, internal APIs shared by your team.
+
+**What is the Private API Network?**
+The Private API Network is where your organization stores vetted APIs for internal use. These are trusted team workspaces containing approved microservices, internal tools, and shared API collections.
+
+**When to Use This Tool:**
+- Finding internal/company trusted APIs (e.g., "find a trusted api for notification service", "find our payment APIs", "search for internal microservices")
+- Discovering trusted APIs shared within your organization
+- Looking up team-approved API collections and requests
+- When the user wants to find collections in the private network (e.g., "find internal access control collections", "search for payment API collections in our network")
+
+**Search Scope:**
+- Searches only trusted internal APIs in the Private API Network
+- Returns requests or collections from team workspaces published to the network
+
+**Entity Types:**
+- \`requests\`: Search for individual API requests (default)
+- \`collections\`: Search for collections (unique collections extracted from request results; pagination applies to underlying requests)`;
+export const parameters = z.object({
+    entityType: z
+        .enum(['requests', 'collections'])
+        .describe('The type of Postman element to search for. Use `requests` to search for individual API requests, or `collections` to search for collections (unique collections extracted from request results; pagination applies to underlying requests).')
+        .default('requests'),
+    q: z
+        .string()
+        .min(1)
+        .max(512)
+        .describe('The search query for API elements in the Private API Network (e.g. "invoices API", "notification service", "payment APIs").'),
+    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)
+        .optional(),
+});
+export const annotations = {
+    title: "Search for API requests and collections in your organization's Private API Network—a curated repository of trusted, internal APIs shared by your team.",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+};
+const PRIVATE_NETWORK_FILTER = {
+    $and: [
+        {
+            privateNetwork: {
+                $eq: true,
+            },
+        },
+    ],
+};
+export async function handler(args, extra) {
+    try {
+        const query = new URLSearchParams();
+        if (args.limit !== undefined)
+            query.set('limit', String(args.limit));
+        if (args.nextCursor !== undefined)
+            query.set('nextCursor', String(args.nextCursor));
+        const endpoint = query.toString() ? `/search?${query.toString()}` : '/search';
+        const body = {
+            q: args.q,
+            elementType: 'requests',
+            filters: PRIVATE_NETWORK_FILTER,
+        };
+        const options = {
+            body: JSON.stringify(body),
+            contentType: ContentType.Json,
+            headers: extra.headers,
+        };
+        const result = await extra.client.post(endpoint, options);
+        if (args.entityType === 'collections') {
+            const collectionsMap = new Map();
+            const data = result?.data || [];
+            for (const item of data) {
+                if (item.collection && !collectionsMap.has(item.collection.id)) {
+                    collectionsMap.set(item.collection.id, {
+                        collectionId: item.collection.id,
+                        collectionName: item.collection.name,
+                        workspaceId: item.workspace?.id,
+                        workspaceName: item.workspace?.name,
+                        publisher: item.publisher?.name,
+                        publisherVerified: item.publisher?.isVerified,
+                    });
+                }
+            }
+            const collections = Array.from(collectionsMap.values());
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            data: collections,
+                            meta: {
+                                nextCursor: result?.meta?.nextCursor,
+                                collectionsCount: collections.length,
+                                note: 'Collections extracted from request results. Pagination applies to underlying requests.',
+                            },
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        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/searchPostmanElementsInPublicNetwork.js

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+import { asMcpError, McpError } from './utils/toolHelpers.js';
+export const method = 'searchPostmanElementsInPublicNetwork';
+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 wants to find collections (e.g., "find Stripe collections", "search for payment API collections")\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\n**Entity Types:**\n- `requests`: Search for individual API requests\n- `collections`: Search for collections (unique collections extracted from request results; pagination applies to underlying requests)\n';
+export const parameters = z.object({
+    entityType: z
+        .enum(['requests', 'collections'])
+        .describe('The type of Postman [entity](https://learning.postman.com/docs/getting-started/basics/postman-elements/) to search for. Use `requests` to search for individual API requests, or `collections` to search for collections (unique collections extracted from request results; pagination applies to underlying requests).'),
+    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.',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+};
+export async function handler(args, extra) {
+    try {
+        const endpoint = '/search/requests';
+        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);
+        if (args.entityType === 'collections') {
+            const collectionsMap = new Map();
+            const data = result?.data || [];
+            for (const item of data) {
+                if (!collectionsMap.has(item.collection.id)) {
+                    collectionsMap.set(item.collection.id, {
+                        collectionId: item.collection.id,
+                        collectionName: item.collection.name,
+                        workspaceId: item.workspace.id,
+                        workspaceName: item.workspace.name,
+                        publisher: item.publisher.name,
+                        publisherVerified: item.publisher.isVerified,
+                    });
+                }
+            }
+            const collections = Array.from(collectionsMap.values());
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            data: collections,
+                            meta: {
+                                nextCursor: result?.meta?.nextCursor,
+                                collectionsCount: collections.length,
+                                note: 'Collections extracted from request results. Pagination applies to underlying requests.',
+                            },
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        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

@@ -7,7 +7,7 @@ export const parameters = z.object({
     specId: z.string().describe("The spec's ID."),
 });
 export const annotations = {
-    title: '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',
+    title: 'Syncs a collection generated from an API specification. This is an asynchronous endpoint that returns an HTTP \\`202 Accepted\\` response.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,