fastmcp 4.14.4 → 4.15.1

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 _chunkMD6EC4EYcjs = require('./chunk-MD6EC4EY.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 = _chunkMD6EC4EYcjs.DiscoveryDocumentCache; exports.FastMCP = _chunkMD6EC4EYcjs.FastMCP; exports.FastMCPError = _chunkMD6EC4EYcjs.FastMCPError; exports.FastMCPSession = _chunkMD6EC4EYcjs.FastMCPSession; exports.GitHubProvider = _chunk5FVNY65Mcjs.GitHubProvider; exports.GoogleProvider = _chunk5FVNY65Mcjs.GoogleProvider; exports.MEDIA_FETCH_TIMEOUT_MS = _chunkMD6EC4EYcjs.MEDIA_FETCH_TIMEOUT_MS; exports.OAuthProvider = _chunk5FVNY65Mcjs.OAuthProvider; exports.ServerState = _chunkMD6EC4EYcjs.ServerState; exports.SessionError = _chunkMD6EC4EYcjs.SessionError; exports.UnexpectedStateError = _chunkMD6EC4EYcjs.UnexpectedStateError; exports.UserError = _chunkMD6EC4EYcjs.UserError; exports.audioContent = _chunkMD6EC4EYcjs.audioContent; exports.getAuthSession = _chunk5FVNY65Mcjs.getAuthSession; exports.imageContent = _chunkMD6EC4EYcjs.imageContent; exports.jsonSchemaAdapter = _chunkMD6EC4EYcjs.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-JI5H5LIK.js";
 import {
   AuthProvider,
   AzureProvider,

package/dist/{chunk-YAU737SP.js → chunk-JI5H5LIK.js}

@@ -23,7 +23,6 @@ import Fuse from "fuse.js";
 import { Hono } from "hono";
 import { startHTTPServer } from "mcp-proxy";
 import { setTimeout as delay } from "timers/promises";
-import { fetch as fetch2 } from "undici";
 import parseURITemplate from "uri-templates";
 import { strictJsonSchema, toJsonSchema } from "xsschema";
 import { z } from "zod";
@@ -204,7 +203,7 @@ var imageContent = async (input) => {
     if ("url" in input) {
       const timeoutMs = input.timeoutMs ?? MEDIA_FETCH_TIMEOUT_MS;
       try {
-        const response = await fetch2(input.url, {
+        const response = await fetch(input.url, {
           signal: AbortSignal.timeout(timeoutMs)
         });
         if (!response.ok) {
@@ -265,7 +264,7 @@ var audioContent = async (input) => {
     if ("url" in input) {
       const timeoutMs = input.timeoutMs ?? MEDIA_FETCH_TIMEOUT_MS;
       try {
-        const response = await fetch2(input.url, {
+        const response = await fetch(input.url, {
           signal: AbortSignal.timeout(timeoutMs)
         });
         if (!response.ok) {
@@ -508,6 +507,7 @@ var FastMCPSession = class extends FastMCPSessionEventEmitter {
   #utils;
   constructor({
     auth,
+    icons,
     instructions,
     logger,
     name,
@@ -520,10 +520,12 @@ var FastMCPSession = class extends FastMCPSessionEventEmitter {
     sessionId,
     stateless = false,
     streamKeepalive,
+    title,
     tools,
     transportType,
     utils,
-    version
+    version,
+    websiteUrl
   }) {
     super();
     this.#auth = auth;
@@ -550,7 +552,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 +1931,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 +1942,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 +2132,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 +2145,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 +2761,4 @@ export {
   FastMCPSession,
   FastMCP
 };
-//# sourceMappingURL=chunk-YAU737SP.js.map
+//# sourceMappingURL=chunk-JI5H5LIK.js.map