@postman/postman-mcp-server 2.2.1 → 2.3.0

package/dist/src/tools/getMocks.js

@@ -1,29 +1,35 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
 }
 export const method = 'getMocks';
-export const description = 'Gets all active mock servers. By default, this endpoint returns only mock servers you created across all workspaces.\n\n**Note:**\n\nIf you pass both the \\`teamId\\` and \\`workspace\\` query parameters, this endpoint only accepts the \\`workspace\\` query.\n';
+export const description = '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';
 export const parameters = z.object({
-    teamId: z.string().describe('Return only results that belong to the given team ID.').optional(),
-    workspace: z.string().describe('Return only results found in the given workspace ID.').optional(),
+    teamId: z
+        .string()
+        .describe('Return only results that belong to the given team ID.\n- For team-scoped requests, set this from GET `/me` (`me.teamId`).\n')
+        .optional(),
+    workspace: z
+        .string()
+        .describe('Return only results found in the given workspace ID.\n- Prefer this parameter when the user mentions a specific workspace.\n')
+        .optional(),
 });
 export const annotations = {
-    title: 'Gets all active mock servers. By default, this endpoint returns only mock servers you created across all workspaces.\n\n**Note:**\n\nIf you pass both the \\`teamId\\` and \\`workspace\\` query parameters, this endpoint only accepts the \\`workspace\\` query.\n',
+    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',
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
         const endpoint = `/mocks`;
         const query = new URLSearchParams();
-        if (params.teamId !== undefined)
-            query.set('teamId', String(params.teamId));
-        if (params.workspace !== undefined)
-            query.set('workspace', String(params.workspace));
+        if (args.teamId !== undefined)
+            query.set('teamId', String(args.teamId));
+        if (args.workspace !== undefined)
+            query.set('workspace', String(args.workspace));
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {
             headers: extra.headers,

package/dist/src/tools/getMonitor.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -13,9 +13,9 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/monitors/${params.monitorId}`;
+        const endpoint = `/monitors/${args.monitorId}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {

package/dist/src/tools/getMonitors.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -35,24 +35,24 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
         const endpoint = `/monitors`;
         const query = new URLSearchParams();
-        if (params.workspace !== undefined)
-            query.set('workspace', String(params.workspace));
-        if (params.active !== undefined)
-            query.set('active', String(params.active));
-        if (params.owner !== undefined)
-            query.set('owner', String(params.owner));
-        if (params.collectionUid !== undefined)
-            query.set('collectionUid', String(params.collectionUid));
-        if (params.environmentUid !== undefined)
-            query.set('environmentUid', String(params.environmentUid));
-        if (params.cursor !== undefined)
-            query.set('cursor', String(params.cursor));
-        if (params.limit !== undefined)
-            query.set('limit', String(params.limit));
+        if (args.workspace !== undefined)
+            query.set('workspace', String(args.workspace));
+        if (args.active !== undefined)
+            query.set('active', String(args.active));
+        if (args.owner !== undefined)
+            query.set('owner', String(args.owner));
+        if (args.collectionUid !== undefined)
+            query.set('collectionUid', String(args.collectionUid));
+        if (args.environmentUid !== undefined)
+            query.set('environmentUid', String(args.environmentUid));
+        if (args.cursor !== undefined)
+            query.set('cursor', String(args.cursor));
+        if (args.limit !== undefined)
+            query.set('limit', String(args.limit));
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {
             headers: extra.headers,

package/dist/src/tools/getRequestComments.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -18,9 +18,9 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/${params.collectionId}/requests/${params.requestId}/comments`;
+        const endpoint = `/collections/${args.collectionId}/requests/${args.requestId}/comments`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {

package/dist/src/tools/getResponseComments.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -16,9 +16,9 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/${params.collectionId}/responses/${params.responseId}/comments`;
+        const endpoint = `/collections/${args.collectionId}/responses/${args.responseId}/comments`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {

package/dist/src/tools/getSourceCollectionStatus.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -13,9 +13,9 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/${params.collectionId}/source-status`;
+        const endpoint = `/collections/${args.collectionId}/source-status`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {

package/dist/src/tools/getSpec.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -13,9 +13,9 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/specs/${params.specId}`;
+        const endpoint = `/specs/${args.specId}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {

package/dist/src/tools/getSpecCollections.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -25,14 +25,14 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/specs/${params.specId}/generations/${params.elementType}`;
+        const endpoint = `/specs/${args.specId}/generations/${args.elementType}`;
         const query = new URLSearchParams();
-        if (params.limit !== undefined)
-            query.set('limit', String(params.limit));
-        if (params.cursor !== undefined)
-            query.set('cursor', String(params.cursor));
+        if (args.limit !== undefined)
+            query.set('limit', String(args.limit));
+        if (args.cursor !== undefined)
+            query.set('cursor', String(args.cursor));
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {
             headers: extra.headers,

package/dist/src/tools/getSpecDefinition.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -13,9 +13,9 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/specs/${params.specId}/definitions`;
+        const endpoint = `/specs/${args.specId}/definitions`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {

package/dist/src/tools/getSpecFile.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -16,9 +16,9 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/specs/${params.specId}/files/${params.filePath}`;
+        const endpoint = `/specs/${args.specId}/files/${args.filePath}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {

package/dist/src/tools/getSpecFiles.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -13,9 +13,9 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/specs/${params.specId}/files`;
+        const endpoint = `/specs/${args.specId}/files`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {

package/dist/src/tools/getStatusOfAnAsyncApiTask.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -19,9 +19,9 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/apis/${params.apiId}/tasks/${params.taskId}`;
+        const endpoint = `/apis/${args.apiId}/tasks/${args.taskId}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {

package/dist/src/tools/getTaggedEntities.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -38,18 +38,18 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/tags/${params.slug}/entities`;
+        const endpoint = `/tags/${args.slug}/entities`;
         const query = new URLSearchParams();
-        if (params.limit !== undefined)
-            query.set('limit', String(params.limit));
-        if (params.direction !== undefined)
-            query.set('direction', String(params.direction));
-        if (params.cursor !== undefined)
-            query.set('cursor', String(params.cursor));
-        if (params.entityType !== undefined)
-            query.set('entityType', String(params.entityType));
+        if (args.limit !== undefined)
+            query.set('limit', String(args.limit));
+        if (args.direction !== undefined)
+            query.set('direction', String(args.direction));
+        if (args.cursor !== undefined)
+            query.set('cursor', String(args.cursor));
+        if (args.entityType !== undefined)
+            query.set('entityType', String(args.entityType));
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {
             headers: extra.headers,

package/dist/src/tools/getWorkspace.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -19,12 +19,12 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/workspaces/${params.workspaceId}`;
+        const endpoint = `/workspaces/${args.workspaceId}`;
         const query = new URLSearchParams();
-        if (params.include !== undefined)
-            query.set('include', String(params.include));
+        if (args.include !== undefined)
+            query.set('include', String(args.include));
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {
             headers: extra.headers,

package/dist/src/tools/getWorkspaceGlobalVariables.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -13,9 +13,9 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/workspaces/${params.workspaceId}/global-variables`;
+        const endpoint = `/workspaces/${args.workspaceId}/global-variables`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {

package/dist/src/tools/getWorkspaceTags.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -13,9 +13,9 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/workspaces/${params.workspaceId}/tags`;
+        const endpoint = `/workspaces/${args.workspaceId}/tags`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {

package/dist/src/tools/getWorkspaces.js

@@ -1,20 +1,20 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
 }
 export const method = 'getWorkspaces';
-export const description = "Gets all [workspaces](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/creating-workspaces/). The response includes your workspaces and any workspaces that you have access to.\n\n**Note:**\n\nThis 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** 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 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";
 export const parameters = z.object({
     type: z
         .enum(['personal', 'team', 'private', 'public', 'partner'])
-        .describe('The type of workspace to filter the response by.')
+        .describe('The type of workspace to filter the response by. One of: `personal`, `team`, `private`, `public`, `partner`.\n- For “my …” requests, this can be combined with `createdBy`. If type is not specified, it will search across all types for that user.\n')
         .optional(),
     createdBy: z
         .number()
         .int()
-        .describe('Return only workspaces created by a specific user ID. For multiple users, pass this value as a comma-separated list of user IDs. The response only returns workspaces that you have access to.')
+        .describe("Return only workspaces created by the specified Postman user ID.\n- For “my …” requests, set `createdBy` to the current user’s ID from GET `/me` (`me.user.id`).\n- If the user's ID is not known, first call GET `/me`, then retry with `createdBy`.\n")
         .optional(),
     include: z
         .enum(['mocks:deactivated', 'scim'])
@@ -22,21 +22,21 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: "Gets all [workspaces](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/creating-workspaces/). The response includes your workspaces and any workspaces that you have access to.\n\n**Note:**\n\nThis 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** 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 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",
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
         const endpoint = `/workspaces`;
         const query = new URLSearchParams();
-        if (params.type !== undefined)
-            query.set('type', String(params.type));
-        if (params.createdBy !== undefined)
-            query.set('createdBy', String(params.createdBy));
-        if (params.include !== undefined)
-            query.set('include', String(params.include));
+        if (args.type !== undefined)
+            query.set('type', String(args.type));
+        if (args.createdBy !== undefined)
+            query.set('createdBy', String(args.createdBy));
+        if (args.include !== undefined)
+            query.set('include', String(args.include));
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const options = {
             headers: extra.headers,

package/dist/src/tools/mergeCollectionFork.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -21,18 +21,18 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: false,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
         const endpoint = `/collections/merge`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.destination !== undefined)
-            bodyPayload.destination = params.destination;
-        if (params.source !== undefined)
-            bodyPayload.source = params.source;
-        if (params.strategy !== undefined)
-            bodyPayload.strategy = params.strategy;
+        if (args.destination !== undefined)
+            bodyPayload.destination = args.destination;
+        if (args.source !== undefined)
+            bodyPayload.source = args.source;
+        if (args.strategy !== undefined)
+            bodyPayload.strategy = args.strategy;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/patchCollection.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
@@ -288,14 +288,14 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/${params.collectionId}`;
+        const endpoint = `/collections/${args.collectionId}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.collection !== undefined)
-            bodyPayload.collection = params.collection;
+        if (args.collection !== undefined)
+            bodyPayload.collection = args.collection;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/patchEnvironment.js

@@ -1,24 +1,70 @@
 import { z } from 'zod';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { ContentType } from '../clients/postman.js';
+import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
     return new McpError(ErrorCode.InternalError, cause);
 }
 export const method = 'patchEnvironment';
 export const description = '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';
-export const parameters = z.object({ environmentId: z.string().describe("The environment's ID.") });
+export const parameters = z.object({
+    environmentId: z.string().describe("The environment's ID."),
+    body: z.union([
+        z.array(z.object({
+            op: z.string().describe('The `add` operation.'),
+            path: z
+                .string()
+                .describe('The [JSON Pointer syntax](https://datatracker.ietf.org/doc/html/rfc6901) that indicates the entry to update, in `/values/#` format, where `#` is the entry ID. The first record begins at the `0` value.'),
+            value: z
+                .object({
+                enabled: z.boolean().describe('If true, the variable is enabled.').optional(),
+                key: z.string().describe("The variable's name.").optional(),
+                value: z.string().describe("The variable's value.").optional(),
+                type: z
+                    .enum(['secret', 'default'])
+                    .describe("The variable's type:\n- `secret` — The variable value is masked.\n- `default` — The variable value is visible in plain text.\n")
+                    .optional(),
+                description: z.string().max(512).describe("The variable's description.").optional(),
+            })
+                .describe("Information about the environment's variables."),
+        })),
+        z.array(z
+            .object({
+            op: z.string().describe('The `replace` operation.'),
+            path: z.string().describe('The `/name` value.'),
+            value: z.string().describe("The environment's updated name."),
+        })
+            .describe('Information about the environment.')),
+        z.array(z.object({
+            op: z.string().describe('The `replace` operation.'),
+            path: z
+                .string()
+                .describe('The [JSON Pointer syntax](https://datatracker.ietf.org/doc/html/rfc6901) that indicates the entry to update, in `/values/#/{value}` format, where:\n- `#` — The entry ID. The first record begins at the `0` value.\n- `{value}` — The variable property to update. Accepts `key`, `value`, `type`, and `enable`.\n'),
+            value: z.string().describe("The variable's value."),
+        })),
+        z.array(z.object({
+            op: z.string().describe('The `remove` operation.'),
+            path: z
+                .string()
+                .describe('The [JSON Pointer syntax](https://datatracker.ietf.org/doc/html/rfc6901) that indicates the entry to update, in `/values/#` format, where `#` is the entry ID. The first record begins at the `0` value.'),
+        })),
+    ]),
+});
 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',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/environments/${params.environmentId}`;
+        const endpoint = `/environments/${args.environmentId}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
+        const bodyPayload = args.body;
         const options = {
+            body: JSON.stringify(bodyPayload),
+            contentType: ContentType.Json,
             headers: extra.headers,
         };
         const result = await extra.client.patch(url, options);