@postman/postman-mcp-server 2.1.4 → 2.2.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@postman/postman-mcp-server",
-    "version": "2.1.4",
+    "version": "2.2.0",
     "description": "A simple MCP server to operate on the Postman API",
     "main": "dist/src/index.js",
     "type": "module",

package/dist/src/clients/postman.js

@@ -1,31 +1,77 @@
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 import packageJson from '../../package.json' with { type: 'json' };
-const BASE_URL = 'https://api.postman.com';
 export var ContentType;
 (function (ContentType) {
     ContentType["Json"] = "application/json";
     ContentType["JsonPatch"] = "application/json-patch+json";
 })(ContentType || (ContentType = {}));
-export async function fetchPostmanAPI(endpoint, options) {
-    const apiKey = options.apiKey || process.env.POSTMAN_API_KEY;
-    if (!apiKey) {
-        throw new Error('API key is required.');
-    }
-    const contentType = options.contentType || ContentType.Json;
-    const userAgentHeader = options.headers && 'user-agent' in options.headers
-        ? `${options.headers['user-agent']}/${packageJson.name}/${packageJson.version}`
-        : `${packageJson.name}/${packageJson.version}`;
-    const headers = {
-        'content-type': contentType,
-        'x-api-key': apiKey,
-        'user-agent': userAgentHeader,
-    };
-    const { headers: _, ...optionsWithoutHeaders } = options;
-    const response = await fetch(`${BASE_URL}${endpoint}`, {
-        ...optionsWithoutHeaders,
-        headers,
-    });
-    if (!response.ok) {
+export class PostmanAPIClient {
+    baseUrl;
+    apiKey;
+    static instance = null;
+    constructor(apiKey, baseUrl = process.env.POSTMAN_API_BASE_URL || 'https://api.postman.com') {
+        if (!apiKey && !process.env.POSTMAN_API_KEY) {
+            throw new Error('API key is required. Provide it as parameter or set POSTMAN_API_KEY environment variable.');
+        }
+        this.apiKey = apiKey || process.env.POSTMAN_API_KEY;
+        this.baseUrl = baseUrl;
+    }
+    static getInstance(apiKey, baseUrl) {
+        if (!PostmanAPIClient.instance) {
+            const key = apiKey || process.env.POSTMAN_API_KEY;
+            if (!key) {
+                throw new Error('API key is required. Provide it as parameter or set POSTMAN_API_KEY environment variable.');
+            }
+            PostmanAPIClient.instance = new PostmanAPIClient(key, baseUrl);
+        }
+        return PostmanAPIClient.instance;
+    }
+    static resetInstance() {
+        PostmanAPIClient.instance = null;
+    }
+    async get(endpoint, options = {}) {
+        return this.request(endpoint, { ...options, method: 'GET' });
+    }
+    async post(endpoint, options = {}) {
+        return this.request(endpoint, { ...options, method: 'POST' });
+    }
+    async put(endpoint, options = {}) {
+        return this.request(endpoint, { ...options, method: 'PUT' });
+    }
+    async patch(endpoint, options = {}) {
+        return this.request(endpoint, { ...options, method: 'PATCH' });
+    }
+    async delete(endpoint, options = {}) {
+        return this.request(endpoint, { ...options, method: 'DELETE' });
+    }
+    async request(endpoint, options) {
+        const contentType = options.contentType || ContentType.Json;
+        const userAgentHeader = options.headers && 'user-agent' in options.headers
+            ? `${options.headers['user-agent']}/${packageJson.name}/${packageJson.version}`
+            : `${packageJson.name}/${packageJson.version}`;
+        const headers = {
+            'content-type': contentType,
+            'x-api-key': this.apiKey,
+            'user-agent': userAgentHeader,
+            ...options.headers,
+        };
+        const { headers: _, ...optionsWithoutHeaders } = options;
+        const response = await fetch(`${this.baseUrl}${endpoint}`, {
+            ...optionsWithoutHeaders,
+            headers,
+        });
+        if (!response.ok) {
+            await this.handleErrorResponse(response);
+        }
+        if (response.status === 204)
+            return null;
+        const responseContentType = response.headers.get('content-type') || '';
+        if (responseContentType.includes('application/json')) {
+            return response.json();
+        }
+        return response.text();
+    }
+    async handleErrorResponse(response) {
         const errorText = await response.text();
         switch (response.status) {
             case 400:
@@ -41,11 +87,4 @@ export async function fetchPostmanAPI(endpoint, options) {
                 });
         }
     }
-    if (response.status === 204)
-        return null;
-    const responseContentType = response.headers.get('content-type') || '';
-    if (responseContentType.includes('application/json')) {
-        return response.json();
-    }
-    return response.text();
 }

package/dist/src/enabledResources.js

@@ -19,7 +19,7 @@ const full = [
     'getCollectionsForkedByUser',
     'pullCollectionChanges',
     'createCollectionFork',
-    'collection-merges',
+    'mergeCollectionFork',
     'createCollectionFolder',
     'deleteCollectionFolder',
     'getCollectionFolder',
@@ -99,7 +99,7 @@ const full = [
     'publishDocumentation',
     'unpublishDocumentation',
     'getAsyncSpecTaskStatus',
-    'getStatusOfAnAsyncTask',
+    'getStatusOfAnAsyncApiTask',
     'getAuthenticatedUser',
     'getTaggedEntities',
     'transferCollectionFolders',
@@ -148,6 +148,7 @@ const minimal = [
     'createCollectionRequest',
     'createCollectionResponse',
     'duplicateCollection',
+    'getStatusOfAnAsyncApiTask',
 ];
 const excludedFromGeneration = ['createCollection', 'putCollection'];
 export const enabledResources = {

package/dist/src/index.js

@@ -9,6 +9,20 @@ import { readdir } from 'node:fs/promises';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { enabledResources } from './enabledResources.js';
+import { PostmanAPIClient } from './clients/postman.js';
+const SUPPORTED_REGIONS = {
+    us: 'https://api.postman.com',
+    eu: 'https://api.eu.postman.com',
+};
+function isValidRegion(region) {
+    return region in SUPPORTED_REGIONS;
+}
+function setRegionEnvironment(region) {
+    if (!isValidRegion(region)) {
+        throw new Error(`Invalid region: ${region}. Supported regions: us, eu`);
+    }
+    process.env.POSTMAN_API_BASE_URL = SUPPORTED_REGIONS[region];
+}
 function log(level, message, context) {
     const timestamp = new Date().toISOString();
     const suffix = context ? ` ${JSON.stringify(context)}` : '';
@@ -74,17 +88,33 @@ dotenv.config();
 const SERVER_NAME = packageJson.name;
 const APP_VERSION = packageJson.version;
 export const USER_AGENT = `${SERVER_NAME}/${APP_VERSION}`;
-let currentApiKey = undefined;
 let clientInfo = undefined;
-const allGeneratedTools = await loadAllTools();
-log('info', 'Server initialization starting', {
-    serverName: SERVER_NAME,
-    version: APP_VERSION,
-    toolCount: allGeneratedTools.length,
-});
 async function run() {
     const args = process.argv.slice(2);
     const useFull = args.includes('--full');
+    const regionIndex = args.findIndex((arg) => arg === '--region');
+    if (regionIndex !== -1 && regionIndex + 1 < args.length) {
+        const region = args[regionIndex + 1];
+        if (isValidRegion(region)) {
+            setRegionEnvironment(region);
+            log('info', `Using region: ${region}`, {
+                region,
+                baseUrl: process.env.POSTMAN_API_BASE_URL,
+            });
+        }
+        else {
+            log('error', `Invalid region: ${region}`);
+            console.error(`Supported regions: ${Object.keys(SUPPORTED_REGIONS).join(', ')}`);
+            process.exit(1);
+        }
+    }
+    const client = PostmanAPIClient.getInstance();
+    const allGeneratedTools = await loadAllTools();
+    log('info', 'Server initialization starting', {
+        serverName: SERVER_NAME,
+        version: APP_VERSION,
+        toolCount: allGeneratedTools.length,
+    });
     const fullTools = allGeneratedTools.filter((t) => enabledResources.full.includes(t.method));
     const minimalTools = allGeneratedTools.filter((t) => enabledResources.minimal.includes(t.method));
     const tools = useFull ? fullTools : minimalTools;
@@ -110,12 +140,8 @@ async function run() {
         const args = request.params.arguments || {};
         try {
             const start = Date.now();
-            if (!currentApiKey) {
-                log('error', 'Missing API key for tool invocation', { toolName });
-                throw new McpError(ErrorCode.InvalidParams, 'API key is required.');
-            }
             const result = await tool.handler(args, {
-                apiKey: currentApiKey,
+                client,
                 headers: {
                     ...extra.requestInfo?.headers,
                     'user-agent': clientInfo?.name,
@@ -148,11 +174,6 @@ async function run() {
         }));
         return { tools: transformedTools };
     });
-    currentApiKey = process.env.POSTMAN_API_KEY;
-    if (!currentApiKey) {
-        log('error', 'POSTMAN_API_KEY is required');
-        process.exit(1);
-    }
     log('info', 'Starting stdio transport');
     const transport = new StdioServerTransport();
     transport.onmessage = (message) => {

package/dist/src/tools/createCollection.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { fetchPostmanAPI, ContentType } from '../clients/postman.js';
+import { ContentType } from '../clients/postman.js';
 import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
@@ -797,13 +797,12 @@ export async function handler(params, extra) {
         const bodyPayload = {};
         if (params.collection !== undefined)
             bodyPayload.collection = params.collection;
-        const result = await fetchPostmanAPI(url, {
-            method: 'POST',
+        const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,
-            apiKey: extra.apiKey,
             headers: extra.headers,
-        });
+        };
+        const result = await extra.client.post(url, options);
         return {
             content: [
                 {

package/dist/src/tools/createCollectionComment.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { fetchPostmanAPI, ContentType } from '../clients/postman.js';
+import { ContentType } from '../clients/postman.js';
 import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
@@ -17,7 +17,7 @@ export const parameters = z.object({
         .optional(),
     tags: z
         .object({
-        userName: z
+        '{{userName}}': z
             .object({
             type: z.literal('user').describe('The `user` value.'),
             id: z.string().describe("The user's ID."),
@@ -46,13 +46,12 @@ export async function handler(params, extra) {
             bodyPayload.threadId = params.threadId;
         if (params.tags !== undefined)
             bodyPayload.tags = params.tags;
-        const result = await fetchPostmanAPI(url, {
-            method: 'POST',
+        const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,
-            apiKey: extra.apiKey,
             headers: extra.headers,
-        });
+        };
+        const result = await extra.client.post(url, options);
         return {
             content: [
                 {

package/dist/src/tools/createCollectionFolder.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { fetchPostmanAPI, ContentType } from '../clients/postman.js';
+import { ContentType } from '../clients/postman.js';
 import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
@@ -31,13 +31,12 @@ export async function handler(params, extra) {
             bodyPayload.name = params.name;
         if (params.folder !== undefined)
             bodyPayload.folder = params.folder;
-        const result = await fetchPostmanAPI(url, {
-            method: 'POST',
+        const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,
-            apiKey: extra.apiKey,
             headers: extra.headers,
-        });
+        };
+        const result = await extra.client.post(url, options);
         return {
             content: [
                 {

package/dist/src/tools/createCollectionFork.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { fetchPostmanAPI, ContentType } from '../clients/postman.js';
+import { ContentType } from '../clients/postman.js';
 import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
@@ -28,13 +28,12 @@ export async function handler(params, extra) {
         const bodyPayload = {};
         if (params.label !== undefined)
             bodyPayload.label = params.label;
-        const result = await fetchPostmanAPI(url, {
-            method: 'POST',
+        const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,
-            apiKey: extra.apiKey,
             headers: extra.headers,
-        });
+        };
+        const result = await extra.client.post(url, options);
         return {
             content: [
                 {

package/dist/src/tools/createCollectionRequest.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { fetchPostmanAPI, ContentType } from '../clients/postman.js';
+import { ContentType } from '../clients/postman.js';
 import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
@@ -34,13 +34,12 @@ export async function handler(params, extra) {
         const bodyPayload = {};
         if (params.name !== undefined)
             bodyPayload.name = params.name;
-        const result = await fetchPostmanAPI(url, {
-            method: 'POST',
+        const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,
-            apiKey: extra.apiKey,
             headers: extra.headers,
-        });
+        };
+        const result = await extra.client.post(url, options);
         return {
             content: [
                 {

package/dist/src/tools/createCollectionResponse.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { fetchPostmanAPI, ContentType } from '../clients/postman.js';
+import { ContentType } from '../clients/postman.js';
 import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
@@ -31,13 +31,12 @@ export async function handler(params, extra) {
         const bodyPayload = {};
         if (params.name !== undefined)
             bodyPayload.name = params.name;
-        const result = await fetchPostmanAPI(url, {
-            method: 'POST',
+        const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,
-            apiKey: extra.apiKey,
             headers: extra.headers,
-        });
+        };
+        const result = await extra.client.post(url, options);
         return {
             content: [
                 {

package/dist/src/tools/createEnvironment.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { fetchPostmanAPI, ContentType } from '../clients/postman.js';
+import { ContentType } from '../clients/postman.js';
 import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
@@ -13,12 +13,18 @@ export const parameters = z.object({
         .object({
         name: z.string().describe("The environment's name."),
         values: z
-            .array(z.object({
+            .array(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 type.').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."))
             .describe("Information about the environment's variables.")
             .optional(),
     })
@@ -41,13 +47,12 @@ export async function handler(params, extra) {
         const bodyPayload = {};
         if (params.environment !== undefined)
             bodyPayload.environment = params.environment;
-        const result = await fetchPostmanAPI(url, {
-            method: 'POST',
+        const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,
-            apiKey: extra.apiKey,
             headers: extra.headers,
-        });
+        };
+        const result = await extra.client.post(url, options);
         return {
             content: [
                 {

package/dist/src/tools/createFolderComment.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { fetchPostmanAPI, ContentType } from '../clients/postman.js';
+import { ContentType } from '../clients/postman.js';
 import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
@@ -18,7 +18,7 @@ export const parameters = z.object({
         .optional(),
     tags: z
         .object({
-        userName: z
+        '{{userName}}': z
             .object({
             type: z.literal('user').describe('The `user` value.'),
             id: z.string().describe("The user's ID."),
@@ -47,13 +47,12 @@ export async function handler(params, extra) {
             bodyPayload.threadId = params.threadId;
         if (params.tags !== undefined)
             bodyPayload.tags = params.tags;
-        const result = await fetchPostmanAPI(url, {
-            method: 'POST',
+        const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,
-            apiKey: extra.apiKey,
             headers: extra.headers,
-        });
+        };
+        const result = await extra.client.post(url, options);
         return {
             content: [
                 {

package/dist/src/tools/createMock.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { fetchPostmanAPI, ContentType } from '../clients/postman.js';
+import { ContentType } from '../clients/postman.js';
 import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
@@ -40,13 +40,12 @@ export async function handler(params, extra) {
         const bodyPayload = {};
         if (params.mock !== undefined)
             bodyPayload.mock = params.mock;
-        const result = await fetchPostmanAPI(url, {
-            method: 'POST',
+        const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,
-            apiKey: extra.apiKey,
             headers: extra.headers,
-        });
+        };
+        const result = await extra.client.post(url, options);
         return {
             content: [
                 {

package/dist/src/tools/createMonitor.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { fetchPostmanAPI, ContentType } from '../clients/postman.js';
+import { ContentType } from '../clients/postman.js';
 import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
@@ -36,6 +36,7 @@ export const parameters = z.object({
                 .describe('The number of times to reattempt a monitor run if it fails or errors. This may impact your [monitor usage](https://learning.postman.com/docs/monitoring-your-api/monitor-usage/#view-monitor-usage).')
                 .optional(),
         })
+            .describe("Information about the monitor's retry settings.")
             .optional(),
         options: z
             .object({
@@ -130,13 +131,12 @@ export async function handler(params, extra) {
         const bodyPayload = {};
         if (params.monitor !== undefined)
             bodyPayload.monitor = params.monitor;
-        const result = await fetchPostmanAPI(url, {
-            method: 'POST',
+        const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,
-            apiKey: extra.apiKey,
             headers: extra.headers,
-        });
+        };
+        const result = await extra.client.post(url, options);
         return {
             content: [
                 {

package/dist/src/tools/createRequestComment.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { fetchPostmanAPI, ContentType } from '../clients/postman.js';
+import { ContentType } from '../clients/postman.js';
 import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
@@ -20,7 +20,7 @@ export const parameters = z.object({
         .optional(),
     tags: z
         .object({
-        userName: z
+        '{{userName}}': z
             .object({
             type: z.literal('user').describe('The `user` value.'),
             id: z.string().describe("The user's ID."),
@@ -49,13 +49,12 @@ export async function handler(params, extra) {
             bodyPayload.threadId = params.threadId;
         if (params.tags !== undefined)
             bodyPayload.tags = params.tags;
-        const result = await fetchPostmanAPI(url, {
-            method: 'POST',
+        const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,
-            apiKey: extra.apiKey,
             headers: extra.headers,
-        });
+        };
+        const result = await extra.client.post(url, options);
         return {
             content: [
                 {

package/dist/src/tools/createResponseComment.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { fetchPostmanAPI, ContentType } from '../clients/postman.js';
+import { ContentType } from '../clients/postman.js';
 import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
@@ -18,7 +18,7 @@ export const parameters = z.object({
         .optional(),
     tags: z
         .object({
-        userName: z
+        '{{userName}}': z
             .object({
             type: z.literal('user').describe('The `user` value.'),
             id: z.string().describe("The user's ID."),
@@ -47,13 +47,12 @@ export async function handler(params, extra) {
             bodyPayload.threadId = params.threadId;
         if (params.tags !== undefined)
             bodyPayload.tags = params.tags;
-        const result = await fetchPostmanAPI(url, {
-            method: 'POST',
+        const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,
-            apiKey: extra.apiKey,
             headers: extra.headers,
-        });
+        };
+        const result = await extra.client.post(url, options);
         return {
             content: [
                 {

package/dist/src/tools/createSpec.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { fetchPostmanAPI, ContentType } from '../clients/postman.js';
+import { ContentType } from '../clients/postman.js';
 import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 function asMcpError(error) {
     const cause = error?.cause ?? String(error);
@@ -12,30 +12,19 @@ export const parameters = z.object({
     name: z.string().describe("The specification's name."),
     type: z.enum(['OPENAPI:3.0', 'ASYNCAPI:2.0']).describe("The specification's type."),
     files: z
-        .array(z.any().superRefine((x, ctx) => {
-        const schemas = [
-            z.object({
-                path: z.string().describe("The file's path. Accepts JSON or YAML files."),
-                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."),
-                content: z.string().describe("The file's stringified contents."),
-            }),
-        ];
-        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',
-            });
-        }
-    }))
+        .array(z.union([
+        z.object({
+            path: z.string().describe("The file's path. Accepts JSON or YAML files."),
+            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."),
+            content: z.string().describe("The file's stringified contents."),
+        }),
+    ]))
         .describe("A list of the specification's files and their contents."),
 });
 export const annotations = {
@@ -58,13 +47,12 @@ export async function handler(params, extra) {
             bodyPayload.type = params.type;
         if (params.files !== undefined)
             bodyPayload.files = params.files;
-        const result = await fetchPostmanAPI(url, {
-            method: 'POST',
+        const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,
-            apiKey: extra.apiKey,
             headers: extra.headers,
-        });
+        };
+        const result = await extra.client.post(url, options);
         return {
             content: [
                 {