feat: pass headers to tool handlers and bump sdk

Author: garciasdos

package-lock.json

@@ -15,7 +15,7 @@
   },
   "dependencies": {
     "@apidevtools/swagger-parser": "^11.0.0",
-    "@modelcontextprotocol/sdk": "^1.10.2",
+    "@modelcontextprotocol/sdk": "^1.17.0",
     "dotenv": "^16.5.0",
     "es-toolkit": "^1.37.2",
     "express": "^5.1.0"
@@ -42,4 +42,4 @@
   },
   "author": "Postman, Inc.",
   "license": "Apache-2.0"
-}
+}

package.json

@@ -1,3 +1,4 @@
+import { IsomorphicHeaders } from '@modelcontextprotocol/sdk/types';
 import packageJson from '../../package.json' with { type: 'json' };
 const BASE_URL = 'https://api.postman.com';
 
@@ -6,9 +7,10 @@ export enum ContentType {
   JsonPatch = 'application/json-patch+json',
 }
 
-export interface FetchPostmanAPIOptions extends RequestInit {
+export interface FetchPostmanAPIOptions extends Omit<RequestInit, 'headers'> {
   contentType?: ContentType;
   apiKey: string;
+  headers?: IsomorphicHeaders;
 }
 
 export async function fetchPostmanAPI(
@@ -21,15 +23,22 @@ export async function fetchPostmanAPI(
   }
   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': `${packageJson.name}/${packageJson.version}`,
     ...options.headers,
+    'content-type': contentType,
+    'x-api-key': apiKey,
+    'user-agent': userAgentHeader,
   };
 
+  const { headers: _, ...optionsWithoutHeaders } = options;
+
   const response = await fetch(`${BASE_URL}${endpoint}`, {
-    ...options,
+    ...optionsWithoutHeaders,
     headers,
   });
 

src/clients/postman.ts

@@ -7,6 +7,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import {
   CallToolRequestSchema,
   ErrorCode,
+  IsomorphicHeaders,
   ListToolsRequestSchema,
   McpError,
 } from '@modelcontextprotocol/sdk/types.js';
@@ -30,7 +31,7 @@ interface ToolModule {
   };
   handler: (
     params: any,
-    extra: { apiKey: string }
+    extra: { apiKey: string; headers?: IsomorphicHeaders }
   ) => Promise<{
     content: Array<{ type: string; text: string } & Record<string, unknown>>;
   }>;
@@ -125,7 +126,7 @@ async function run() {
 
   logger.info(`Registering ${allGeneratedTools.length} tools...`);
 
-  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
     const toolName = request.params.name;
     const tool = allGeneratedTools.find((t) => t.method === toolName);
 
@@ -140,7 +141,10 @@ async function run() {
         throw new McpError(ErrorCode.InvalidParams, 'API key is required.');
       }
 
-      const result = await tool.handler(args as any, { apiKey: currentApiKey });
+      const result = await tool.handler(args as any, {
+        apiKey: currentApiKey,
+        headers: extra.requestInfo?.headers,
+      });
       return result;
     } catch (error: any) {
       throw new McpError(ErrorCode.InternalError, `API error: ${error.message}`, {