fastmcp 4.7.2 → 4.8.1

package/README.md

@@ -1406,6 +1406,26 @@ server.addResource({
 });
 ```
 
+#### Subscribing to resource updates
+
+Clients can subscribe to a resource with the MCP [`resources/subscribe`](https://modelcontextprotocol.io/specification/2025-06-18/server/resources#subscriptions) method to be notified whenever its contents change. FastMCP advertises the `subscribe` capability automatically for any server that exposes resources, tracks each client's subscriptions, and lets you emit an update with `sendResourceUpdated`:
+
+```ts
+server.addResource({
+  uri: "file:///logs/app.log",
+  name: "Application Logs",
+  mimeType: "text/plain",
+  async load() {
+    return { text: await readLogFile() };
+  },
+});
+
+// Whenever the underlying data changes, notify subscribed clients:
+await server.sendResourceUpdated("file:///logs/app.log");
+```
+
+`sendResourceUpdated` only notifies clients that have subscribed to the given URI, so it is safe to call whenever your data changes. FastMCP also advertises the `listChanged` capability for resources and prompts and emits `notifications/resources/list_changed` / `notifications/prompts/list_changed` automatically when you add or remove resources, resource templates, or prompts at runtime.
+
 ### Resource templates
 
 You can also define resource templates:

package/dist/FastMCP.cjs

@@ -7,7 +7,7 @@
 
 
 
-var _chunk553XY3CAcjs = require('./chunk-553XY3CA.cjs');
+var _chunkMJCWKCHZcjs = require('./chunk-MJCWKCHZ.cjs');
 
 
 
@@ -41,5 +41,5 @@ var _chunkIX3HKAX4cjs = require('./chunk-IX3HKAX4.cjs');
 
 
 
-exports.AuthProvider = _chunkIX3HKAX4cjs.AuthProvider; exports.AzureProvider = _chunkIX3HKAX4cjs.AzureProvider; exports.DiscoveryDocumentCache = _chunk553XY3CAcjs.DiscoveryDocumentCache; exports.FastMCP = _chunk553XY3CAcjs.FastMCP; exports.FastMCPSession = _chunk553XY3CAcjs.FastMCPSession; exports.GitHubProvider = _chunkIX3HKAX4cjs.GitHubProvider; exports.GoogleProvider = _chunkIX3HKAX4cjs.GoogleProvider; exports.OAuthProvider = _chunkIX3HKAX4cjs.OAuthProvider; exports.ServerState = _chunk553XY3CAcjs.ServerState; exports.UnexpectedStateError = _chunk553XY3CAcjs.UnexpectedStateError; exports.UserError = _chunk553XY3CAcjs.UserError; exports.audioContent = _chunk553XY3CAcjs.audioContent; exports.getAuthSession = _chunkIX3HKAX4cjs.getAuthSession; exports.imageContent = _chunk553XY3CAcjs.imageContent; exports.requireAll = _chunkIX3HKAX4cjs.requireAll; exports.requireAny = _chunkIX3HKAX4cjs.requireAny; exports.requireAuth = _chunkIX3HKAX4cjs.requireAuth; exports.requireRole = _chunkIX3HKAX4cjs.requireRole; exports.requireScopes = _chunkIX3HKAX4cjs.requireScopes;
+exports.AuthProvider = _chunkIX3HKAX4cjs.AuthProvider; exports.AzureProvider = _chunkIX3HKAX4cjs.AzureProvider; exports.DiscoveryDocumentCache = _chunkMJCWKCHZcjs.DiscoveryDocumentCache; exports.FastMCP = _chunkMJCWKCHZcjs.FastMCP; exports.FastMCPSession = _chunkMJCWKCHZcjs.FastMCPSession; exports.GitHubProvider = _chunkIX3HKAX4cjs.GitHubProvider; exports.GoogleProvider = _chunkIX3HKAX4cjs.GoogleProvider; exports.OAuthProvider = _chunkIX3HKAX4cjs.OAuthProvider; exports.ServerState = _chunkMJCWKCHZcjs.ServerState; exports.UnexpectedStateError = _chunkMJCWKCHZcjs.UnexpectedStateError; exports.UserError = _chunkMJCWKCHZcjs.UserError; exports.audioContent = _chunkMJCWKCHZcjs.audioContent; exports.getAuthSession = _chunkIX3HKAX4cjs.getAuthSession; exports.imageContent = _chunkMJCWKCHZcjs.imageContent; exports.requireAll = _chunkIX3HKAX4cjs.requireAll; exports.requireAny = _chunkIX3HKAX4cjs.requireAny; exports.requireAuth = _chunkIX3HKAX4cjs.requireAuth; exports.requireRole = _chunkIX3HKAX4cjs.requireRole; exports.requireScopes = _chunkIX3HKAX4cjs.requireScopes;
 //# sourceMappingURL=FastMCP.cjs.map

package/dist/FastMCP.d.cts

@@ -750,6 +750,14 @@ declare class FastMCPSession<T extends FastMCPSessionAuth = FastMCPSessionAuth>
     requestSampling(message: z.infer<typeof CreateMessageRequestSchema>["params"], options?: RequestOptions): Promise<SamplingResponse>;
     resourcesListChanged(resources: Resource<T>[]): void;
     resourceTemplatesListChanged(resourceTemplates: ResourceTemplate<T>[]): void;
+    /**
+     * Notifies the connected client that the contents of a resource have changed.
+     *
+     * The `notifications/resources/updated` notification is only sent when the
+     * client has subscribed to the URI via `resources/subscribe`; otherwise this
+     * is a no-op.
+     */
+    sendResourceUpdated(uri: string): Promise<void>;
     toolsListChanged(tools: Tool<T>[]): void;
     triggerListChangedNotification(method: string): Promise<void>;
     /**
@@ -766,6 +774,7 @@ declare class FastMCPSession<T extends FastMCPSessionAuth = FastMCPSessionAuth>
     private setupLoggingHandlers;
     private setupPromptHandlers;
     private setupResourceHandlers;
+    private setupResourceSubscriptionHandlers;
     private setupResourceTemplateHandlers;
     private setupRootsHandlers;
     private setupToolHandlers;
@@ -874,6 +883,17 @@ declare class FastMCP<T extends FastMCPSessionAuth = FastMCPSessionAuth> extends
      * Removes tools from the server.
      */
     removeTools(names: string[]): void;
+    /**
+     * Notifies subscribed clients that a resource's contents have changed.
+     *
+     * Sends a `notifications/resources/updated` notification to every connected
+     * session that has subscribed to `uri` via `resources/subscribe`. Sessions
+     * that have not subscribed to the URI are skipped, so it is safe to call this
+     * whenever the underlying data changes.
+     *
+     * @param uri - The URI of the resource whose contents changed.
+     */
+    sendResourceUpdated(uri: string): Promise<void>;
     /**
      * Starts the server.
      */

package/dist/FastMCP.d.ts

@@ -750,6 +750,14 @@ declare class FastMCPSession<T extends FastMCPSessionAuth = FastMCPSessionAuth>
     requestSampling(message: z.infer<typeof CreateMessageRequestSchema>["params"], options?: RequestOptions): Promise<SamplingResponse>;
     resourcesListChanged(resources: Resource<T>[]): void;
     resourceTemplatesListChanged(resourceTemplates: ResourceTemplate<T>[]): void;
+    /**
+     * Notifies the connected client that the contents of a resource have changed.
+     *
+     * The `notifications/resources/updated` notification is only sent when the
+     * client has subscribed to the URI via `resources/subscribe`; otherwise this
+     * is a no-op.
+     */
+    sendResourceUpdated(uri: string): Promise<void>;
     toolsListChanged(tools: Tool<T>[]): void;
     triggerListChangedNotification(method: string): Promise<void>;
     /**
@@ -766,6 +774,7 @@ declare class FastMCPSession<T extends FastMCPSessionAuth = FastMCPSessionAuth>
     private setupLoggingHandlers;
     private setupPromptHandlers;
     private setupResourceHandlers;
+    private setupResourceSubscriptionHandlers;
     private setupResourceTemplateHandlers;
     private setupRootsHandlers;
     private setupToolHandlers;
@@ -874,6 +883,17 @@ declare class FastMCP<T extends FastMCPSessionAuth = FastMCPSessionAuth> extends
      * Removes tools from the server.
      */
     removeTools(names: string[]): void;
+    /**
+     * Notifies subscribed clients that a resource's contents have changed.
+     *
+     * Sends a `notifications/resources/updated` notification to every connected
+     * session that has subscribed to `uri` via `resources/subscribe`. Sessions
+     * that have not subscribed to the URI are skipped, so it is safe to call this
+     * whenever the underlying data changes.
+     *
+     * @param uri - The URI of the resource whose contents changed.
+     */
+    sendResourceUpdated(uri: string): Promise<void>;
     /**
      * Starts the server.
      */

package/dist/FastMCP.js

@@ -7,7 +7,7 @@ import {
   UserError,
   audioContent,
   imageContent
-} from "./chunk-KAGSBU3Z.js";
+} from "./chunk-2PFUZL7I.js";
 import {
   AuthProvider,
   AzureProvider,

package/dist/{chunk-KAGSBU3Z.js → chunk-2PFUZL7I.js}

@@ -13,7 +13,9 @@ import {
   McpError,
   ReadResourceRequestSchema,
   RootsListChangedNotificationSchema,
-  SetLevelRequestSchema
+  SetLevelRequestSchema,
+  SubscribeRequestSchema,
+  UnsubscribeRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
 import { EventEmitter } from "events";
 import { readFile } from "fs/promises";
@@ -357,6 +359,12 @@ var FastMCPSession = class extends FastMCPSessionEventEmitter {
    * Used to track per-session state across multiple requests.
    */
   #sessionId;
+  /**
+   * Resource URIs the connected client has subscribed to via
+   * `resources/subscribe`. Used to scope `notifications/resources/updated`
+   * to interested clients only.
+   */
+  #subscriptions = /* @__PURE__ */ new Set();
   #utils;
   constructor({
     auth,
@@ -387,13 +395,13 @@ var FastMCPSession = class extends FastMCPSessionEventEmitter {
       this.#capabilities.tools = {};
     }
     if (resources.length || resourcesTemplates.length) {
-      this.#capabilities.resources = {};
+      this.#capabilities.resources = { listChanged: true, subscribe: true };
     }
     if (prompts.length) {
       for (const prompt of prompts) {
         this.addPrompt(prompt);
       }
-      this.#capabilities.prompts = {};
+      this.#capabilities.prompts = { listChanged: true };
     }
     this.#capabilities.logging = {};
     this.#capabilities.completions = {};
@@ -414,6 +422,7 @@ var FastMCPSession = class extends FastMCPSessionEventEmitter {
         this.addResource(resource);
       }
       this.setupResourceHandlers();
+      this.setupResourceSubscriptionHandlers();
       if (resourcesTemplates.length) {
         for (const resourceTemplate of resourcesTemplates) {
           this.addResourceTemplate(resourceTemplate);
@@ -549,6 +558,27 @@ ${e instanceof Error ? e.stack : JSON.stringify(e)}`
     this.setupResourceTemplateHandlers();
     this.triggerListChangedNotification("notifications/resources/list_changed");
   }
+  /**
+   * Notifies the connected client that the contents of a resource have changed.
+   *
+   * The `notifications/resources/updated` notification is only sent when the
+   * client has subscribed to the URI via `resources/subscribe`; otherwise this
+   * is a no-op.
+   */
+  async sendResourceUpdated(uri) {
+    if (!this.#subscriptions.has(uri)) {
+      return;
+    }
+    try {
+      await this.#server.sendResourceUpdated({ uri });
+    } catch (error) {
+      this.#logger.error(
+        `[FastMCP error] failed to send resources/updated notification for '${uri}'.
+
+${error instanceof Error ? error.stack : JSON.stringify(error)}`
+      );
+    }
+  }
   toolsListChanged(tools) {
     const allowedTools = tools.filter(
       (tool) => tool.canAccess ? tool.canAccess(this.#auth) : true
@@ -997,6 +1027,16 @@ ${error instanceof Error ? error.stack : JSON.stringify(error)}`
       }
     );
   }
+  setupResourceSubscriptionHandlers() {
+    this.#server.setRequestHandler(SubscribeRequestSchema, (request) => {
+      this.#subscriptions.add(request.params.uri);
+      return {};
+    });
+    this.#server.setRequestHandler(UnsubscribeRequestSchema, (request) => {
+      this.#subscriptions.delete(request.params.uri);
+      return {};
+    });
+  }
   setupResourceTemplateHandlers() {
     let cachedResourceTemplatesList = null;
     this.#server.setRequestHandler(
@@ -1599,6 +1639,21 @@ var FastMCP = class extends FastMCPEventEmitter {
       this.#toolsListChanged(this.#tools);
     }
   }
+  /**
+   * Notifies subscribed clients that a resource's contents have changed.
+   *
+   * Sends a `notifications/resources/updated` notification to every connected
+   * session that has subscribed to `uri` via `resources/subscribe`. Sessions
+   * that have not subscribed to the URI are skipped, so it is safe to call this
+   * whenever the underlying data changes.
+   *
+   * @param uri - The URI of the resource whose contents changed.
+   */
+  async sendResourceUpdated(uri) {
+    await Promise.all(
+      this.#sessions.map((session) => session.sendResourceUpdated(uri))
+    );
+  }
   /**
    * Starts the server.
    */
@@ -1636,6 +1691,17 @@ var FastMCP = class extends FastMCPEventEmitter {
         version: this.#options.version
       });
       await session.connect(transport);
+      let stdinClosed = false;
+      const onStdinClose = () => {
+        if (stdinClosed) return;
+        stdinClosed = true;
+        process.stdin.off("close", onStdinClose);
+        process.stdin.off("end", onStdinClose);
+        transport.close().catch(() => {
+        });
+      };
+      process.stdin.on("close", onStdinClose);
+      process.stdin.on("end", onStdinClose);
       this.#sessions.push(session);
       session.once("error", () => {
         this.#removeSession(session);
@@ -1643,6 +1709,8 @@ var FastMCP = class extends FastMCPEventEmitter {
       if (transport.onclose) {
         const originalOnClose = transport.onclose;
         transport.onclose = () => {
+          process.stdin.off("close", onStdinClose);
+          process.stdin.off("end", onStdinClose);
           this.#removeSession(session);
           if (originalOnClose) {
             originalOnClose();
@@ -1650,6 +1718,8 @@ var FastMCP = class extends FastMCPEventEmitter {
         };
       } else {
         transport.onclose = () => {
+          process.stdin.off("close", onStdinClose);
+          process.stdin.off("end", onStdinClose);
           this.#removeSession(session);
         };
       }
@@ -2296,4 +2366,4 @@ export {
   FastMCPSession,
   FastMCP
 };
-//# sourceMappingURL=chunk-KAGSBU3Z.js.map
+//# sourceMappingURL=chunk-2PFUZL7I.js.map