fastmcp 4.14.3 → 4.15.0

package/README.md

@@ -2410,6 +2410,27 @@ const server = new FastMCP({
 });
 ```
 
+### Server icons and metadata
+
+You can advertise icons and related metadata for your server. Clients that support icons can show them in their UI:
+
+```ts
+const server = new FastMCP({
+  name: "My Server",
+  version: "1.0.0",
+  websiteUrl: "https://example.com",
+  icons: [
+    {
+      src: "https://example.com/icon.png",
+      mimeType: "image/png",
+      sizes: ["48x48"],
+    },
+  ],
+});
+```
+
+An optional `title` is also passed through to MCP `initialize` (`serverInfo`), for clients that prefer a display name over the server `name`.
+
 ### Sessions
 
 The `session` object is an instance of `FastMCPSession` and it describes active client sessions.

package/dist/FastMCP.cjs

@@ -11,7 +11,7 @@
 
 
 
-var _chunkD7MJO6C6cjs = require('./chunk-D7MJO6C6.cjs');
+var _chunk6I3JC3FNcjs = require('./chunk-6I3JC3FN.cjs');
 
 
 
@@ -49,5 +49,5 @@ var _chunk5FVNY65Mcjs = require('./chunk-5FVNY65M.cjs');
 
 
 
-exports.AuthProvider = _chunk5FVNY65Mcjs.AuthProvider; exports.AzureProvider = _chunk5FVNY65Mcjs.AzureProvider; exports.DiscoveryDocumentCache = _chunkD7MJO6C6cjs.DiscoveryDocumentCache; exports.FastMCP = _chunkD7MJO6C6cjs.FastMCP; exports.FastMCPError = _chunkD7MJO6C6cjs.FastMCPError; exports.FastMCPSession = _chunkD7MJO6C6cjs.FastMCPSession; exports.GitHubProvider = _chunk5FVNY65Mcjs.GitHubProvider; exports.GoogleProvider = _chunk5FVNY65Mcjs.GoogleProvider; exports.MEDIA_FETCH_TIMEOUT_MS = _chunkD7MJO6C6cjs.MEDIA_FETCH_TIMEOUT_MS; exports.OAuthProvider = _chunk5FVNY65Mcjs.OAuthProvider; exports.ServerState = _chunkD7MJO6C6cjs.ServerState; exports.SessionError = _chunkD7MJO6C6cjs.SessionError; exports.UnexpectedStateError = _chunkD7MJO6C6cjs.UnexpectedStateError; exports.UserError = _chunkD7MJO6C6cjs.UserError; exports.audioContent = _chunkD7MJO6C6cjs.audioContent; exports.getAuthSession = _chunk5FVNY65Mcjs.getAuthSession; exports.imageContent = _chunkD7MJO6C6cjs.imageContent; exports.jsonSchemaAdapter = _chunkD7MJO6C6cjs.jsonSchemaAdapter; exports.requireAll = _chunk5FVNY65Mcjs.requireAll; exports.requireAny = _chunk5FVNY65Mcjs.requireAny; exports.requireAuth = _chunk5FVNY65Mcjs.requireAuth; exports.requireRole = _chunk5FVNY65Mcjs.requireRole; exports.requireScopes = _chunk5FVNY65Mcjs.requireScopes;
+exports.AuthProvider = _chunk5FVNY65Mcjs.AuthProvider; exports.AzureProvider = _chunk5FVNY65Mcjs.AzureProvider; exports.DiscoveryDocumentCache = _chunk6I3JC3FNcjs.DiscoveryDocumentCache; exports.FastMCP = _chunk6I3JC3FNcjs.FastMCP; exports.FastMCPError = _chunk6I3JC3FNcjs.FastMCPError; exports.FastMCPSession = _chunk6I3JC3FNcjs.FastMCPSession; exports.GitHubProvider = _chunk5FVNY65Mcjs.GitHubProvider; exports.GoogleProvider = _chunk5FVNY65Mcjs.GoogleProvider; exports.MEDIA_FETCH_TIMEOUT_MS = _chunk6I3JC3FNcjs.MEDIA_FETCH_TIMEOUT_MS; exports.OAuthProvider = _chunk5FVNY65Mcjs.OAuthProvider; exports.ServerState = _chunk6I3JC3FNcjs.ServerState; exports.SessionError = _chunk6I3JC3FNcjs.SessionError; exports.UnexpectedStateError = _chunk6I3JC3FNcjs.UnexpectedStateError; exports.UserError = _chunk6I3JC3FNcjs.UserError; exports.audioContent = _chunk6I3JC3FNcjs.audioContent; exports.getAuthSession = _chunk5FVNY65Mcjs.getAuthSession; exports.imageContent = _chunk6I3JC3FNcjs.imageContent; exports.jsonSchemaAdapter = _chunk6I3JC3FNcjs.jsonSchemaAdapter; exports.requireAll = _chunk5FVNY65Mcjs.requireAll; exports.requireAny = _chunk5FVNY65Mcjs.requireAny; exports.requireAuth = _chunk5FVNY65Mcjs.requireAuth; exports.requireRole = _chunk5FVNY65Mcjs.requireRole; exports.requireScopes = _chunk5FVNY65Mcjs.requireScopes;
 //# sourceMappingURL=FastMCP.cjs.map

package/dist/FastMCP.d.cts

@@ -2,8 +2,8 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { EventStore } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { RequestOptions } from '@modelcontextprotocol/sdk/shared/protocol.js';
 import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
-import { ResourceLink, ElicitRequestFormParams, ElicitRequestURLParams, ElicitResult, Root, ClientCapabilities, GetPromptResult, CreateMessageRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-export { ResourceLink } from '@modelcontextprotocol/sdk/types.js';
+import { ResourceLink, ElicitRequestFormParams, ElicitRequestURLParams, ElicitResult, Root, ClientCapabilities, Icon, GetPromptResult, CreateMessageRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+export { Icon, ResourceLink } from '@modelcontextprotocol/sdk/types.js';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { EventEmitter } from 'events';
 import { Hono } from 'hono';
@@ -455,6 +455,12 @@ type ServerOptions<T extends FastMCPSessionAuth> = {
          */
         status?: number;
     };
+    /**
+     * Optional icons for this server.
+     * Advertised to clients via MCP `initialize` (`serverInfo.icons`) so UIs can
+     * show a logo next to the server name.
+     */
+    icons?: Icon[];
     instructions?: string;
     /**
      * Custom logger instance. If not provided, defaults to console.
@@ -727,6 +733,11 @@ type ServerOptions<T extends FastMCPSessionAuth> = {
          */
         logLevel?: LoggingLevel;
     };
+    /**
+     * Optional human-readable title for display in client UIs.
+     * Advertised via MCP `initialize` (`serverInfo.title`).
+     */
+    title?: string;
     /**
      * General utilities
      */
@@ -734,6 +745,11 @@ type ServerOptions<T extends FastMCPSessionAuth> = {
         formatInvalidParamsErrorMessage?: (issues: readonly StandardSchemaV1.Issue[]) => string;
     };
     version: `${number}.${number}.${number}`;
+    /**
+     * Optional URL of the website for this server.
+     * Advertised via MCP `initialize` (`serverInfo.websiteUrl`).
+     */
+    websiteUrl?: string;
 };
 type Tool<T extends FastMCPSessionAuth, Params extends ToolParameters = ToolParameters, OutputParams extends ToolParameters = ToolParameters> = {
     /**
@@ -870,8 +886,9 @@ declare class FastMCPSession<T extends FastMCPSessionAuth = FastMCPSessionAuth>
     get server(): Server;
     get sessionId(): string | undefined;
     set sessionId(value: string | undefined);
-    constructor({ auth, instructions, logger, name, onToolCall, ping, prompts, resources, resourcesTemplates, roots, sessionId, stateless, streamKeepalive, tools, transportType, utils, version, }: {
+    constructor({ auth, icons, instructions, logger, name, onToolCall, ping, prompts, resources, resourcesTemplates, roots, sessionId, stateless, streamKeepalive, title, tools, transportType, utils, version, websiteUrl, }: {
         auth?: T;
+        icons?: Icon[];
         instructions?: string;
         logger: Logger;
         name: string;
@@ -884,10 +901,12 @@ declare class FastMCPSession<T extends FastMCPSessionAuth = FastMCPSessionAuth>
         sessionId?: string;
         stateless?: boolean;
         streamKeepalive?: ServerOptions<T>["streamKeepalive"];
+        title?: string;
         tools: Tool<T>[];
         transportType?: "httpStream" | "stdio";
         utils?: ServerOptions<T>["utils"];
         version: string;
+        websiteUrl?: string;
     });
     close(): Promise<void>;
     connect(transport: Transport): Promise<void>;

package/dist/FastMCP.d.ts

@@ -2,8 +2,8 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { EventStore } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { RequestOptions } from '@modelcontextprotocol/sdk/shared/protocol.js';
 import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
-import { ResourceLink, ElicitRequestFormParams, ElicitRequestURLParams, ElicitResult, Root, ClientCapabilities, GetPromptResult, CreateMessageRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-export { ResourceLink } from '@modelcontextprotocol/sdk/types.js';
+import { ResourceLink, ElicitRequestFormParams, ElicitRequestURLParams, ElicitResult, Root, ClientCapabilities, Icon, GetPromptResult, CreateMessageRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+export { Icon, ResourceLink } from '@modelcontextprotocol/sdk/types.js';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { EventEmitter } from 'events';
 import { Hono } from 'hono';
@@ -455,6 +455,12 @@ type ServerOptions<T extends FastMCPSessionAuth> = {
          */
         status?: number;
     };
+    /**
+     * Optional icons for this server.
+     * Advertised to clients via MCP `initialize` (`serverInfo.icons`) so UIs can
+     * show a logo next to the server name.
+     */
+    icons?: Icon[];
     instructions?: string;
     /**
      * Custom logger instance. If not provided, defaults to console.
@@ -727,6 +733,11 @@ type ServerOptions<T extends FastMCPSessionAuth> = {
          */
         logLevel?: LoggingLevel;
     };
+    /**
+     * Optional human-readable title for display in client UIs.
+     * Advertised via MCP `initialize` (`serverInfo.title`).
+     */
+    title?: string;
     /**
      * General utilities
      */
@@ -734,6 +745,11 @@ type ServerOptions<T extends FastMCPSessionAuth> = {
         formatInvalidParamsErrorMessage?: (issues: readonly StandardSchemaV1.Issue[]) => string;
     };
     version: `${number}.${number}.${number}`;
+    /**
+     * Optional URL of the website for this server.
+     * Advertised via MCP `initialize` (`serverInfo.websiteUrl`).
+     */
+    websiteUrl?: string;
 };
 type Tool<T extends FastMCPSessionAuth, Params extends ToolParameters = ToolParameters, OutputParams extends ToolParameters = ToolParameters> = {
     /**
@@ -870,8 +886,9 @@ declare class FastMCPSession<T extends FastMCPSessionAuth = FastMCPSessionAuth>
     get server(): Server;
     get sessionId(): string | undefined;
     set sessionId(value: string | undefined);
-    constructor({ auth, instructions, logger, name, onToolCall, ping, prompts, resources, resourcesTemplates, roots, sessionId, stateless, streamKeepalive, tools, transportType, utils, version, }: {
+    constructor({ auth, icons, instructions, logger, name, onToolCall, ping, prompts, resources, resourcesTemplates, roots, sessionId, stateless, streamKeepalive, title, tools, transportType, utils, version, websiteUrl, }: {
         auth?: T;
+        icons?: Icon[];
         instructions?: string;
         logger: Logger;
         name: string;
@@ -884,10 +901,12 @@ declare class FastMCPSession<T extends FastMCPSessionAuth = FastMCPSessionAuth>
         sessionId?: string;
         stateless?: boolean;
         streamKeepalive?: ServerOptions<T>["streamKeepalive"];
+        title?: string;
         tools: Tool<T>[];
         transportType?: "httpStream" | "stdio";
         utils?: ServerOptions<T>["utils"];
         version: string;
+        websiteUrl?: string;
     });
     close(): Promise<void>;
     connect(transport: Transport): Promise<void>;

package/dist/FastMCP.js

@@ -11,7 +11,7 @@ import {
   audioContent,
   imageContent,
   jsonSchemaAdapter
-} from "./chunk-YAU737SP.js";
+} from "./chunk-3YTVMLYE.js";
 import {
   AuthProvider,
   AzureProvider,

package/dist/{chunk-YAU737SP.js → chunk-3YTVMLYE.js}

@@ -508,6 +508,7 @@ var FastMCPSession = class extends FastMCPSessionEventEmitter {
   #utils;
   constructor({
     auth,
+    icons,
     instructions,
     logger,
     name,
@@ -520,10 +521,12 @@ var FastMCPSession = class extends FastMCPSessionEventEmitter {
     sessionId,
     stateless = false,
     streamKeepalive,
+    title,
     tools,
     transportType,
     utils,
-    version
+    version,
+    websiteUrl
   }) {
     super();
     this.#auth = auth;
@@ -550,7 +553,13 @@ var FastMCPSession = class extends FastMCPSessionEventEmitter {
     this.#capabilities.logging = {};
     this.#capabilities.completions = {};
     this.#server = new Server(
-      { name, version },
+      {
+        ...icons !== void 0 ? { icons } : {},
+        name,
+        ...title !== void 0 ? { title } : {},
+        version,
+        ...websiteUrl !== void 0 ? { websiteUrl } : {}
+      },
       { capabilities: this.#capabilities, instructions }
     );
     this.#utils = utils;
@@ -1923,6 +1932,7 @@ var FastMCP = class extends FastMCPEventEmitter {
       }
       const session = new FastMCPSession({
         auth,
+        icons: this.#options.icons,
         instructions: this.#options.instructions,
         logger: this.#logger,
         name: this.#options.name,
@@ -1933,10 +1943,12 @@ var FastMCP = class extends FastMCPEventEmitter {
         resourcesTemplates: this.#resourcesTemplates,
         roots: this.#options.roots,
         streamKeepalive: this.#options.streamKeepalive,
+        title: this.#options.title,
         tools: this.#tools,
         transportType: "stdio",
         utils: this.#options.utils,
-        version: this.#options.version
+        version: this.#options.version,
+        websiteUrl: this.#options.websiteUrl
       });
       await session.connect(transport);
       let stdinClosed = false;
@@ -2121,6 +2133,7 @@ var FastMCP = class extends FastMCPEventEmitter {
     ) : this.#tools;
     return new FastMCPSession({
       auth,
+      icons: this.#options.icons,
       instructions: this.#options.instructions,
       logger: this.#logger,
       name: this.#options.name,
@@ -2133,10 +2146,12 @@ var FastMCP = class extends FastMCPEventEmitter {
       sessionId,
       stateless,
       streamKeepalive: this.#options.streamKeepalive,
+      title: this.#options.title,
       tools: allowedTools,
       transportType: "httpStream",
       utils: this.#options.utils,
-      version: this.#options.version
+      version: this.#options.version,
+      websiteUrl: this.#options.websiteUrl
     });
   }
   /**
@@ -2747,4 +2762,4 @@ export {
   FastMCPSession,
   FastMCP
 };
-//# sourceMappingURL=chunk-YAU737SP.js.map
+//# sourceMappingURL=chunk-3YTVMLYE.js.map