feat: add url property to RequestInfo interface

Expose the request URL in RequestInfo, allowing server handlers to access
query parameters, path info, and other URL components from incoming requests.

Author: valentinbeggi

.changeset/add-url-to-request-info.md

@@ -0,0 +1,5 @@
+---
+'@modelcontextprotocol/sdk': minor
+---
+
+Add `url` property to `RequestInfo` interface, exposing the request URL to server handlers

src/server/sse.ts

@@ -149,7 +149,10 @@ export class SSEServerTransport implements Transport {
         }
 
         const authInfo: AuthInfo | undefined = req.auth;
-        const requestInfo: RequestInfo = { headers: req.headers };
+        const requestInfo: RequestInfo = {
+            headers: req.headers,
+            url: req.url
+        };
 
         let body: string | unknown;
         try {

src/server/webStandardStreamableHttp.ts

@@ -597,9 +597,10 @@ export class WebStandardStreamableHTTPServerTransport implements Transport {
                 return this.createJsonErrorResponse(415, -32000, 'Unsupported Media Type: Content-Type must be application/json');
             }
 
-            // Build request info from headers
+            // Build request info from headers and URL
             const requestInfo: RequestInfo = {
-                headers: Object.fromEntries(req.headers.entries())
+                headers: Object.fromEntries(req.headers.entries()),
+                url: req.url
             };
 
             let rawMessage;

src/types.ts

@@ -2361,6 +2361,10 @@ export interface RequestInfo {
      * The headers of the request.
      */
     headers: IsomorphicHeaders;
+    /**
+     * The URL of the request.
+     */
+    url?: string;
 }
 
 /**

test/server/sse.test.ts

@@ -19,10 +19,15 @@ const createMockResponse = () => {
     return res as unknown as Mocked<http.ServerResponse>;
 };
 
-const createMockRequest = ({ headers = {}, body }: { headers?: Record<string, string>; body?: string } = {}) => {
+const createMockRequest = ({
+    headers = {},
+    body,
+    url = '/messages'
+}: { headers?: Record<string, string>; body?: string; url?: string } = {}) => {
     const mockReq = {
         headers,
         body: body ? body : undefined,
+        url,
         auth: {
             token: 'test-token'
         },
@@ -312,7 +317,8 @@ describe.each(zodTestMatrix)('$zodVersionLabel', (entry: ZodMatrixEntry) => {
                                         'user-agent': 'node',
                                         'accept-encoding': 'gzip, deflate',
                                         'content-length': '124'
-                                    }
+                                    },
+                                    url: `/?sessionId=${sessionId}`
                                 })
                             }
                         ]
@@ -417,7 +423,8 @@ describe.each(zodTestMatrix)('$zodVersionLabel', (entry: ZodMatrixEntry) => {
                         requestInfo: {
                             headers: {
                                 'content-type': 'application/json'
-                            }
+                            },
+                            url: '/messages'
                         }
                     }
                 );

test/server/streamableHttp.test.ts

@@ -443,7 +443,8 @@ describe.each(zodTestMatrix)('$zodVersionLabel', (entry: ZodMatrixEntry) => {
                     'user-agent': expect.any(String),
                     'accept-encoding': expect.any(String),
                     'content-length': expect.any(String)
-                }
+                },
+                url: baseUrl.toString()
             });
         });