@postman/postman-mcp-server 2.6.1 → 2.7.1

package/dist/src/tools/createCollectionResponse.js

@@ -5,14 +5,409 @@ export const method = 'createCollectionResponse';
 export const description = 'Creates a request response in a collection. For a complete list of request body properties, refer to the **Response** 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\nIt is recommended that you pass the \\`name\\` property in the request body. If you do not, the system uses a null value. As a result, this creates a response with a blank name.\n';
 export const parameters = z.object({
     collectionId: z.string().describe("The collection's ID."),
-    requestId: z.string().describe("The parent request's ID."),
+    request: z.string().describe("The parent request's ID."),
     name: z
         .string()
         .describe("The response's name. It is recommended that you pass the `name` property in the request body. If you do not, the system uses a null value. As a result, this creates a response with a blank name.")
         .optional(),
+    originalRequest: z
+        .object({
+        url: z
+            .union([
+            z.string().nullable().describe("The request's raw URL."),
+            z.object({
+                raw: z.string().describe("The request's raw URL.").optional(),
+                protocol: z.string().describe('The request protocol.').optional(),
+                host: z.array(z.string().nullable()).describe("The host's URL.").optional(),
+                path: z.array(z.string()).describe("A list of the URL's path components.").optional(),
+                port: z
+                    .string()
+                    .describe("The URL's port number. An empty value indicates port `80` (http) or `443` (https).")
+                    .optional(),
+                query: z
+                    .array(z.object({
+                    key: z.string().nullable().describe("The query parameter's key.").optional(),
+                    value: z.string().nullable().describe("The key's value.").optional(),
+                    disabled: z
+                        .boolean()
+                        .describe("If true, the query parameter isn't sent with the request.")
+                        .default(false),
+                    description: z
+                        .string()
+                        .nullable()
+                        .describe("The query parameter's description.")
+                        .optional(),
+                }))
+                    .describe('A list of query parameters. These are the query string parts of the URL, parsed as separate variables.')
+                    .optional(),
+            }),
+        ])
+            .describe('Information about the URL.')
+            .optional(),
+        auth: z
+            .object({
+            type: z
+                .enum([
+                'basic',
+                'bearer',
+                'apikey',
+                'digest',
+                'oauth1',
+                'oauth2',
+                'hawk',
+                'awsv4',
+                'ntlm',
+                'edgegrid',
+                'jwt',
+                'asap',
+            ])
+                .describe('The authorization type.'),
+            apikey: z
+                .array(z
+                .object({
+                key: z.string().describe("The auth method's key value."),
+                value: z
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
+                    .describe("The key's value.")
+                    .optional(),
+                type: z
+                    .enum(['string', 'boolean', 'number', 'array', 'object', 'any'])
+                    .describe("The value's type.")
+                    .optional(),
+            })
+                .describe('Information about the supported Postman [authorization type](https://learning.postman.com/docs/sending-requests/authorization/authorization-types/).'))
+                .describe("The API key's authentication information.")
+                .optional(),
+            awsv4: z
+                .array(z
+                .object({
+                key: z.string().describe("The auth method's key value."),
+                value: z
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
+                    .describe("The key's value.")
+                    .optional(),
+                type: z
+                    .enum(['string', 'boolean', 'number', 'array', 'object', 'any'])
+                    .describe("The value's type.")
+                    .optional(),
+            })
+                .describe('Information about the supported Postman [authorization type](https://learning.postman.com/docs/sending-requests/authorization/authorization-types/).'))
+                .describe('The attributes for [AWS Signature](https://learning.postman.com/docs/sending-requests/authorization/aws-signature/) authentication.')
+                .optional(),
+            basic: z
+                .array(z
+                .object({
+                key: z.string().describe("The auth method's key value."),
+                value: z
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
+                    .describe("The key's value.")
+                    .optional(),
+                type: z
+                    .enum(['string', 'boolean', 'number', 'array', 'object', 'any'])
+                    .describe("The value's type.")
+                    .optional(),
+            })
+                .describe('Information about the supported Postman [authorization type](https://learning.postman.com/docs/sending-requests/authorization/authorization-types/).'))
+                .describe('The attributes for [Basic Auth](https://learning.postman.com/docs/sending-requests/authorization/authorization-types/#basic-auth).')
+                .optional(),
+            bearer: z
+                .array(z
+                .object({
+                key: z.string().describe("The auth method's key value."),
+                value: z
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
+                    .describe("The key's value.")
+                    .optional(),
+                type: z
+                    .enum(['string', 'boolean', 'number', 'array', 'object', 'any'])
+                    .describe("The value's type.")
+                    .optional(),
+            })
+                .describe('Information about the supported Postman [authorization type](https://learning.postman.com/docs/sending-requests/authorization/authorization-types/).'))
+                .describe('The attributes for [Bearer Token](https://learning.postman.com/docs/sending-requests/authorization/authorization-types/#bearer-token) authentication.')
+                .optional(),
+            digest: z
+                .array(z
+                .object({
+                key: z.string().describe("The auth method's key value."),
+                value: z
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
+                    .describe("The key's value.")
+                    .optional(),
+                type: z
+                    .enum(['string', 'boolean', 'number', 'array', 'object', 'any'])
+                    .describe("The value's type.")
+                    .optional(),
+            })
+                .describe('Information about the supported Postman [authorization type](https://learning.postman.com/docs/sending-requests/authorization/authorization-types/).'))
+                .describe('The attributes for [Digest](https://learning.postman.com/docs/sending-requests/authorization/digest-auth/) access authentication.')
+                .optional(),
+            edgegrid: z
+                .array(z
+                .object({
+                key: z.string().describe("The auth method's key value."),
+                value: z
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
+                    .describe("The key's value.")
+                    .optional(),
+                type: z
+                    .enum(['string', 'boolean', 'number', 'array', 'object', 'any'])
+                    .describe("The value's type.")
+                    .optional(),
+            })
+                .describe('Information about the supported Postman [authorization type](https://learning.postman.com/docs/sending-requests/authorization/authorization-types/).'))
+                .describe('The attributes for [Akamai Edgegrid](https://learning.postman.com/docs/sending-requests/authorization/akamai-edgegrid/) authentication.')
+                .optional(),
+            hawk: z
+                .array(z
+                .object({
+                key: z.string().describe("The auth method's key value."),
+                value: z
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
+                    .describe("The key's value.")
+                    .optional(),
+                type: z
+                    .enum(['string', 'boolean', 'number', 'array', 'object', 'any'])
+                    .describe("The value's type.")
+                    .optional(),
+            })
+                .describe('Information about the supported Postman [authorization type](https://learning.postman.com/docs/sending-requests/authorization/authorization-types/).'))
+                .describe('The attributes for [Hawk](https://learning.postman.com/docs/sending-requests/authorization/hawk-authentication/) authentication.')
+                .optional(),
+            ntlm: z
+                .array(z
+                .object({
+                key: z.string().describe("The auth method's key value."),
+                value: z
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
+                    .describe("The key's value.")
+                    .optional(),
+                type: z
+                    .enum(['string', 'boolean', 'number', 'array', 'object', 'any'])
+                    .describe("The value's type.")
+                    .optional(),
+            })
+                .describe('Information about the supported Postman [authorization type](https://learning.postman.com/docs/sending-requests/authorization/authorization-types/).'))
+                .describe('The attributes for [NTLM](https://learning.postman.com/docs/sending-requests/authorization/ntlm-authentication/) authentication.')
+                .optional(),
+            oauth1: z
+                .array(z
+                .object({
+                key: z.string().describe("The auth method's key value."),
+                value: z
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
+                    .describe("The key's value.")
+                    .optional(),
+                type: z
+                    .enum(['string', 'boolean', 'number', 'array', 'object', 'any'])
+                    .describe("The value's type.")
+                    .optional(),
+            })
+                .describe('Information about the supported Postman [authorization type](https://learning.postman.com/docs/sending-requests/authorization/authorization-types/).'))
+                .describe('The attributes for [OAuth1](https://learning.postman.com/docs/sending-requests/authorization/oauth-10/) authentication.')
+                .optional(),
+            oauth2: z
+                .array(z
+                .object({
+                key: z.string().describe("The auth method's key value."),
+                value: z
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
+                    .describe("The key's value.")
+                    .optional(),
+                type: z
+                    .enum(['string', 'boolean', 'number', 'array', 'object', 'any'])
+                    .describe("The value's type.")
+                    .optional(),
+            })
+                .describe('Information about the supported Postman [authorization type](https://learning.postman.com/docs/sending-requests/authorization/authorization-types/).'))
+                .describe('The attributes for [OAuth2](https://learning.postman.com/docs/sending-requests/authorization/oauth-20/) authentication.')
+                .optional(),
+            jwt: z
+                .array(z
+                .object({
+                key: z.string().describe("The auth method's key value."),
+                value: z
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
+                    .describe("The key's value.")
+                    .optional(),
+                type: z
+                    .enum(['string', 'boolean', 'number', 'array', 'object', 'any'])
+                    .describe("The value's type.")
+                    .optional(),
+            })
+                .describe('Information about the supported Postman [authorization type](https://learning.postman.com/docs/sending-requests/authorization/authorization-types/).'))
+                .describe('The attributes for JWT (JSON Web Token). Includes the `payload`, `secret`, `algorithm`, `addTokenTo`, and `headerPrefix` properties.')
+                .optional(),
+            asap: z
+                .array(z
+                .object({
+                key: z.string().describe("The auth method's key value."),
+                value: z
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
+                    .describe("The key's value.")
+                    .optional(),
+                type: z
+                    .enum(['string', 'boolean', 'number', 'array', 'object', 'any'])
+                    .describe("The value's type.")
+                    .optional(),
+            })
+                .describe('Information about the supported Postman [authorization type](https://learning.postman.com/docs/sending-requests/authorization/authorization-types/).'))
+                .describe('The attributes for ASAP (Atlassian S2S Authentication Protocol). Includes the `kid`, `aud`, `iss`, `alg`, `privateKey`, and `claims` properties.')
+                .optional(),
+        })
+            .describe('The [authorization type supported by Postman](https://learning.postman.com/docs/sending-requests/authorization/authorization-types/).')
+            .optional(),
+        method: z.string().describe("The request's standard HTTP method.").optional(),
+        description: z.string().nullable().describe("The request's description.").optional(),
+        header: z
+            .array(z
+            .object({
+            key: z
+                .string()
+                .describe("The header's key, such as `Content-Type` or `X-Custom-Header`."),
+            value: z.string().describe("The header key's value."),
+            description: z.string().nullable().describe("The header's description.").optional(),
+        })
+            .describe('Information about the header.'))
+            .describe('A list of headers.')
+            .optional(),
+        body: z
+            .object({
+            mode: z
+                .enum(['raw', 'urlencoded', 'formdata', 'file', 'graphql'])
+                .describe('The data associated with the request.')
+                .optional(),
+            raw: z
+                .string()
+                .describe('If the `mode` value is `raw`, the raw content of the request body.')
+                .optional(),
+            urlencoded: z
+                .array(z.object({
+                key: z.string().describe('The key value.'),
+                value: z.string().describe("The key's value.").optional(),
+                description: z.string().nullable().describe("The key's description.").optional(),
+            }))
+                .describe('A list of x-www-form-encoded key/value pairs.')
+                .optional(),
+            formdata: z
+                .array(z.record(z.string(), z.unknown()).and(z.union([
+                z.object({
+                    key: z.string().describe('The key value.').optional(),
+                    value: z.string().describe("The key's value.").optional(),
+                    type: z.literal('text').describe('The `text` value.').optional(),
+                    contentType: z
+                        .string()
+                        .describe('The form-data Content-Type header.')
+                        .optional(),
+                    description: z
+                        .string()
+                        .nullable()
+                        .describe("The key's description.")
+                        .optional(),
+                }),
+                z.object({
+                    key: z.string().describe('The key value.').optional(),
+                    src: z
+                        .unknown()
+                        .superRefine((x, ctx) => {
+                        const schemas = [z.string().nullable(), z.array(z.string())];
+                        const errors = schemas.reduce((errors, schema) => ((result) => (result.error ? [...errors, result.error] : errors))(schema.safeParse(x)), []);
+                        if (schemas.length - errors.length !== 1) {
+                            ctx.addIssue({
+                                path: ctx.path,
+                                code: 'invalid_union',
+                                unionErrors: errors,
+                                message: 'Invalid input: Should pass single schema',
+                            });
+                        }
+                    })
+                        .optional(),
+                    type: z.literal('file').describe('The `file` value.').optional(),
+                    contentType: z
+                        .string()
+                        .describe('The form-data Content-Type header.')
+                        .optional(),
+                    description: z
+                        .string()
+                        .nullable()
+                        .describe("The key's description.")
+                        .optional(),
+                }),
+            ])))
+                .describe('If the `mode` value is `formdata`, then a list of form-data key/pair values.')
+                .optional(),
+            file: z
+                .object({
+                src: z
+                    .string()
+                    .nullable()
+                    .describe('The name of the file to upload (not its path). A null value indicates that no file is selected as a part of the request body.')
+                    .optional(),
+            })
+                .describe('If the `mode` value is `file`, an object containing the file request information.')
+                .optional(),
+            graphql: z
+                .object({
+                query: z.string().describe('The GraphQL query.').optional(),
+                variables: z
+                    .string()
+                    .nullable()
+                    .describe('The GraphQL query variables, in JSON format.')
+                    .optional(),
+            })
+                .describe('If the `mode` value is `graphql`, an object containing the GraphQL request information.')
+                .optional(),
+            options: z
+                .record(z.string(), z.unknown())
+                .describe('Additional configurations and options set for various modes.')
+                .optional(),
+        })
+            .describe("Information about the collection's request body.")
+            .optional(),
+    })
+        .describe('Information about the collection request.')
+        .optional(),
+    responseTime: z
+        .number()
+        .nullable()
+        .describe('The time taken by the request to complete. The unit is milliseconds.')
+        .optional(),
+    timings: z
+        .record(z.string(), z.unknown())
+        .nullable()
+        .describe('Data related to the request and response timing, in milliseconds.')
+        .optional(),
+    header: z
+        .union([
+        z.string().nullable(),
+        z
+            .array(z
+            .object({
+            key: z
+                .string()
+                .describe("The header's key, such as `Content-Type` or `X-Custom-Header`."),
+            value: z.string().describe("The header key's value."),
+            description: z.string().nullable().describe("The header's description.").optional(),
+        })
+            .describe('Information about the header.'))
+            .describe("A list of the response's headers."),
+    ])
+        .optional(),
+    cookie: z
+        .array(z
+        .object({
+        name: z.string().describe("The cookie's name.").optional(),
+        value: z.string().describe("The cookie's value.").optional(),
+    })
+        .catchall(z.unknown()))
+        .describe('A list of cookies included in the response.')
+        .optional(),
+    body: z.string().nullable().describe('The raw text of the response body.').optional(),
+    status: z.string().describe("The response's HTTP status.").optional(),
+    code: z.number().int().describe("The response's HTTP status code.").optional(),
 });
 export const annotations = {
-    title: 'Creates a request response in a collection. For a complete list of request body properties, refer to the **Response** 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\nIt is recommended that you pass the \\`name\\` property in the request body. If you do not, the system uses a null value. As a result, this creates a response with a blank name.\n',
+    title: 'Creates a request response in a collection. For a complete list of request body properties, refer to the **Response** 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: false,
@@ -21,12 +416,28 @@ export async function handler(args, extra) {
     try {
         const endpoint = `/collections/${args.collectionId}/responses`;
         const query = new URLSearchParams();
-        if (args.requestId !== undefined)
-            query.set('requestId', String(args.requestId));
+        if (args.request !== undefined)
+            query.set('request', String(args.request));
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
         if (args.name !== undefined)
             bodyPayload.name = args.name;
+        if (args.originalRequest !== undefined)
+            bodyPayload.originalRequest = args.originalRequest;
+        if (args.responseTime !== undefined)
+            bodyPayload.responseTime = args.responseTime;
+        if (args.timings !== undefined)
+            bodyPayload.timings = args.timings;
+        if (args.header !== undefined)
+            bodyPayload.header = args.header;
+        if (args.cookie !== undefined)
+            bodyPayload.cookie = args.cookie;
+        if (args.body !== undefined)
+            bodyPayload.body = args.body;
+        if (args.status !== undefined)
+            bodyPayload.status = args.status;
+        if (args.code !== undefined)
+            bodyPayload.code = args.code;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/createEnvironment.js

@@ -28,7 +28,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Creates an environment.\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- If you do not include the \\`workspace\\` query parameter, the system creates the environment in the oldest personal Internal workspace you own.\n',
+    title: 'Creates an environment.',
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,

package/dist/src/tools/createFolderComment.js

@@ -26,7 +26,7 @@ export const parameters = z.object({
         .optional(),
 });
 export const annotations = {
-    title: 'Creates a comment on a folder. 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 folder. 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/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

@@ -2,31 +2,43 @@ import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
 import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'createSpec';
-export const description = "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";
+export const description = "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, AsyncAPI 2.0, protobuf 2 and 3, and GraphQL 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";
 export const parameters = z.object({
     workspaceId: z.string().describe("The workspace's ID."),
     name: z.string().describe("The specification's name."),
     type: z
-        .enum(['OPENAPI:2.0', 'OPENAPI:3.0', 'OPENAPI:3.1', 'ASYNCAPI:2.0'])
+        .enum([
+        'OPENAPI:2.0',
+        'OPENAPI:3.0',
+        'OPENAPI:3.1',
+        'ASYNCAPI:2.0',
+        'PROTOBUF:2',
+        'PROTOBUF:3',
+        'GRAPHQL',
+    ])
         .describe("The specification's type."),
     files: z
         .array(z.union([
         z.object({
-            path: z.string().describe("The file's path. Accepts JSON or YAML files."),
+            path: z
+                .string()
+                .describe("The file's path. Accepts .json, .yaml, .proto and .graphql file types."),
             content: z.string().describe("The file's stringified contents."),
             type: z
                 .enum(['DEFAULT', 'ROOT'])
                 .describe('The type of file. This property is required when creating multi-file specifications:\n- `ROOT` — The file containing the full OpenAPI structure. This serves as the entry point for the API spec and references other (`DEFAULT`) spec files. Multi-file specs can only have one root file.\n- `DEFAULT` — A file referenced by the `ROOT` file.\n'),
         }),
         z.object({
-            path: z.string().describe("The file's path. Accepts JSON or YAML files."),
+            path: z
+                .string()
+                .describe("The file's path. Accepts .json, .yaml, .proto and .graphql file types."),
             content: z.string().describe("The file's stringified contents."),
         }),
     ]))
         .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

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
 import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'createWorkspace';
-export const description = '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';
+export const description = '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- The \\`teamId\\` property must be passed in the request body if [Postman Organizations](https://learning.postman.com/docs/administration/onboarding-checklist) is enabled.\n';
 export const parameters = z.object({
     workspace: z
         .object({
@@ -12,12 +12,16 @@ export const parameters = z.object({
             .describe('The type of workspace:\n- `personal`\n- `private` — Private workspaces are available on Postman [**Professional** and **Enterprise** plans](https://www.postman.com/pricing).\n- `public`\n- `team`\n- `partner` — [Partner Workspaces](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/partner-workspaces/) are available on Postman [**Professional** and **Enterprise** plans](https://www.postman.com/pricing)).\n'),
         description: z.string().describe("The workspace's description.").optional(),
         about: z.string().describe('A brief summary about the workspace.').optional(),
+        teamId: z
+            .string()
+            .describe('The team ID to assign to the workspace. This property is required if Postman [Organizations](https://learning.postman.com/docs/administration/managing-your-team/overview) is enabled.')
+            .optional(),
     })
         .describe('Information about the workspace.')
         .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,