@postman/postman-mcp-server 2.6.1 → 2.7.0

package/dist/src/tools/createMock.js

@@ -21,7 +21,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Creates a mock server in a collection.\n\n- Pass the collection UID (ownerId-collectionId), not the bare collection ID.\n- If you only have a \\`collectionId\\`, resolve the UID first:\n  1) Prefer GET \\`/collections/{collectionId}\\` and read \\`uid\\`, or\n  2) Construct \\`{ownerId}-{collectionId}\\` using ownerId from GET \\`/me\\`:\n    - For team-owned collections: \\`ownerId = me.teamId\\`\n    - For personal collections: \\`ownerId = me.user.id\\`\n- Use the \\`workspace\\` query to place the mock in a specific workspace. Prefer explicit workspace scoping.\n',
+    title: 'Creates a mock server in a collection.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,

package/dist/src/tools/createMonitor.js

@@ -112,7 +112,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Creates a monitor.\n\n**Note:**\n\n- You cannot create monitors for collections added to an API definition.\n- If you do not pass the \\`workspace\\` query parameter, the system creates the monitor in the oldest personal Internal workspace you own.\n',
+    title: 'Creates a monitor.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,

package/dist/src/tools/createRequestComment.js

@@ -28,7 +28,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: "The request ID must contain the team ID as a prefix, in \\`teamId-requestId\\` format.\n\nFor example, if you're creating a comment on collection ID \\`24585957-7b2c98f7-30db-4b67-8685-0079f48a0947\\` (note on the prefix), and\nthe collection request's ID is \\`2c450b59-9bbf-729b-6ac0-f92535a7c336\\`, then the \\`{requestId}\\` must be \\`24585957-2c450b59-9bbf-729b-6ac0-f92535a7c336\\`.\n",
+    title: 'The request ID must contain the team ID as a prefix, in \\`teamId-requestId\\` format.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,

package/dist/src/tools/createResponseComment.js

@@ -26,7 +26,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Creates a comment on a response. To create a reply on an existing comment, include the \\`threadId\\` property in the request body.\n\n**Note:**\n\nThis endpoint accepts a max of 10,000 characters.\n',
+    title: 'Creates a comment on a response. To create a reply on an existing comment, include the \\`threadId\\` property in the request body.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,

package/dist/src/tools/createSpec.js

@@ -26,7 +26,7 @@ export const parameters = z.object({
         .describe("A list of the specification's files and their contents."),
 });
 export const annotations = {
-    title: "Creates an API specification in Postman's [Spec Hub](https://learning.postman.com/docs/design-apis/specifications/overview/). Specifications can be single or multi-file.\n\n**Note:**\n- Postman supports OpenAPI 2.0, OpenAPI 3.0, OpenAPI 3.1, and AsyncAPI 2.0 specifications.\n- If the file path contains a \\`/\\` (forward slash) character, then a folder is created. For example, if the path is the \\`components/schemas.json\\` value, then a \\`components\\` folder is created with the \\`schemas.json\\` file inside.\n- Multi-file specifications can only have one root file.\n- Files cannot exceed a maximum of 10 MB in size.\n",
+    title: "Creates an API specification in Postman's [Spec Hub](https://learning.postman.com/docs/design-apis/specifications/overview/). Specifications can be single or multi-file.",
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,

package/dist/src/tools/createSpecFile.js

@@ -9,7 +9,7 @@ export const parameters = z.object({
     content: z.string().describe("The file's stringified contents."),
 });
 export const annotations = {
-    title: 'Creates an API specification file.\n\n**Note:**\n\n- If the file path contains a \\`/\\` (forward slash) character, then a folder is created. For example, if the path is the \\`components/schemas.json\\` value, then a \\`components\\` folder is created with the \\`schemas.json\\` file inside.\n- Creating a spec file assigns it the \\`DEFAULT\\` file type.\n- Multi-file specifications can only have one root file.\n- Files cannot exceed a maximum of 10 MB in size.\n',
+    title: 'Creates an API specification file.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,

package/dist/src/tools/createWorkspace.js

@@ -17,7 +17,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Creates a new [workspace](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/creating-workspaces/).\n\n**Note:**\n\n- This endpoint returns a 403 \\`Forbidden\\` response if the user does not have permission to create workspaces. [Admins and Super Admins](https://learning.postman.com/docs/collaborating-in-postman/roles-and-permissions/#team-roles) can configure workspace permissions to restrict users and/or user groups from creating workspaces or require approvals for the creation of team workspaces.\n- There are rate limits when publishing public workspaces.\n- Public team workspace names must be unique.\n\n### Important\n\nWe deprecated linking collections or environments between workspaces. We do not recommend that you do this.\n\nIf you have a linked collection or environment, note the following:\n- The endpoint does not create a clone of a collection or environment.\n- Any changes you make to a linked collection or environment changes them in all workspaces.\n- If you delete a collection or environment linked between workspaces, the system deletes it in all the workspaces.\n',
+    title: 'Creates a new [workspace](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/creating-workspaces/).',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,

package/dist/src/tools/deleteApiCollectionComment.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 an API's collection. 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 an API's collection. On success, this returns an HTTP \\`204 No Content\\` response.",
     readOnlyHint: false,
     destructiveHint: true,
     idempotentHint: true,

package/dist/src/tools/deleteCollectionComment.js

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

package/dist/src/tools/deleteFolderComment.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 folder. 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 folder. On success, this returns an HTTP \\`204 No Content\\` response.',
     readOnlyHint: false,
     destructiveHint: true,
     idempotentHint: true,

package/dist/src/tools/deleteMock.js

@@ -4,7 +4,7 @@ export const method = 'deleteMock';
 export const description = 'Deletes a mock server.\n- Resource: Mock server entity. This is destructive.\n- Ensure you are targeting the correct mock ID.\n';
 export const parameters = z.object({ mockId: z.string().describe("The mock's ID.") });
 export const annotations = {
-    title: 'Deletes a mock server.\n- Resource: Mock server entity. This is destructive.\n- Ensure you are targeting the correct mock ID.\n',
+    title: 'Deletes a mock server.',
     readOnlyHint: false,
     destructiveHint: true,
     idempotentHint: true,

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

@@ -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

@@ -48,7 +48,7 @@ First, locate the collection the user wants to work with. Determine whether the
 
 Use \`searchPostmanElements\` 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.
+- \`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.
 
 ### For Internal APIs
 
@@ -250,10 +250,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 +337,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/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

@@ -4,7 +4,7 @@ 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 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

@@ -877,7 +877,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/searchPostmanElements.js

@@ -1,11 +1,11 @@
 import { z } from 'zod';
 import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'searchPostmanElements';
-export const description = 'Searches for Postman elements in the public network.\n\n**When to Use This Tool:**\n- When the user asks for a specific named request (e.g., "find PayPal requests", "search for Stripe API requests")\n- When the user explicitly wants to search the public network\n- Do NOT use this for searching the user\'s own workspaces or collections (use getCollections or getWorkspaces instead)\n\n**Search Scope:**\n- Only searches the public network (public workspaces and collections)\n- Does not search private workspaces, team workspaces, or personal collections\n- Currently supports searching for requests (entityType: "requests")\n';
+export const 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
-        .literal('requests')
-        .describe('The type of Postman [entity](https://learning.postman.com/docs/getting-started/basics/postman-elements/) (element) to search for. At this time, this only accepts the `requests` value.'),
+        .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)
@@ -29,14 +29,14 @@ export const parameters = z.object({
         .default(10),
 });
 export const annotations = {
-    title: 'Searches for Postman elements in the public network.\n\n**When to Use This Tool:**\n- When the user asks for a specific named request (e.g., "find PayPal requests", "search for Stripe API requests")\n- When the user explicitly wants to search the public network\n- Do NOT use this for searching the user\'s own workspaces or collections (use getCollections or getWorkspaces instead)\n\n**Search Scope:**\n- Only searches the public network (public workspaces and collections)\n- Does not search private workspaces, team workspaces, or personal collections\n- Currently supports searching for requests (entityType: "requests")\n',
+    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/${args.entityType}`;
+        const endpoint = '/search/requests';
         const query = new URLSearchParams();
         if (args.q !== undefined)
             query.set('q', String(args.q));
@@ -51,11 +51,43 @@ export async function handler(args, extra) {
             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)}`,
+                    text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
                 },
             ],
         };

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,

package/dist/src/tools/syncSpecWithCollection.js

@@ -7,7 +7,7 @@ export const parameters = z.object({
     collectionUid: z.string().describe("The collection's unique ID."),
 });
 export const annotations = {
-    title: 'Syncs an API specification linked to a collection. This is an asynchronous endpoint that returns an HTTP \\`202 Accepted\\` response.\n\n**Note:**\n\n- This endpoint only supports the OpenAPI 3.0 specification type.\n- You can only sync specs generated from the given collection ID.\n',
+    title: 'Syncs an API specification linked to a collection. This is an asynchronous endpoint that returns an HTTP \\`202 Accepted\\` response.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/updateApiCollectionComment.js

@@ -22,7 +22,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: "Updates a comment on an API's collection.\n\n**Note:**\n\nThis endpoint accepts a max of 10,000 characters.\n",
+    title: "Updates a comment on an API's collection.",
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/updateCollectionComment.js

@@ -21,7 +21,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Updates a comment on a collection.\n\n**Note:**\n\nThis endpoint accepts a max of 10,000 characters.\n',
+    title: 'Updates a comment on a collection.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/updateCollectionFolder.js

@@ -10,7 +10,7 @@ export const parameters = z.object({
     description: z.string().describe("The folder's description.").optional(),
 });
 export const annotations = {
-    title: 'Updates a folder in a collection. For a complete list of properties, refer to the **Folder** entry in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html).\n\n**Note:**\n\nThis endpoint acts like a PATCH method. It only updates the values that you pass in the request body (for example, the \\`name\\` property). The endpoint does not update the entire resource.\n',
+    title: 'Updates a folder in a collection. For a complete list of properties, refer to the **Folder** entry in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html).',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/updateCollectionRequest.js

@@ -180,7 +180,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Updates a request in a collection. For a complete list of properties, refer to the **Request** entry in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html).\n\n**Note:**\n\n- You must pass a collection ID (\\`12ece9e1-2abf-4edc-8e34-de66e74114d2\\`), not a collection(\\`12345678-12ece9e1-2abf-4edc-8e34-de66e74114d2\\`), in this endpoint.\n- This endpoint does not support changing the folder of a request.\n- This endpoint acts like a PATCH method. It only updates the values that you pass in the request body.',
+    title: 'Updates a request in a collection. For a complete list of properties, refer to the **Request** entry in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html).',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/updateCollectionResponse.js

@@ -16,7 +16,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Updates a response in a collection. For a complete list of properties, see the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html).\n\n**Note:**\n\n- You must pass a collection ID (\\`12ece9e1-2abf-4edc-8e34-de66e74114d2\\`), not a collection UID (\\`12345678-12ece9e1-2abf-4edc-8e34-de66e74114d2\\`), in this endpoint.\n- This endpoint acts like a PATCH method. It only updates the values that you pass in the request body (for example, the \\`name\\` property). The endpoint does not update the entire resource.\n',
+    title: 'Updates a response in a collection. For a complete list of properties, see the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html).',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/updateFolderComment.js

@@ -22,7 +22,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Updates a comment on a folder.\n\n**Note:**\n\nThis endpoint accepts a max of 10,000 characters.\n',
+    title: 'Updates a comment on a folder.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,

package/dist/src/tools/updateMock.js

@@ -32,7 +32,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Updates a mock server.\n- Resource: Mock server entity associated with a collection UID.\n- Use this to change name, environment, privacy, or default server response.\n',
+    title: 'Updates a mock server.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,