tmcp 1.16.1 → 1.16.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tmcp",
-  "version": "1.16.1",
+  "version": "1.16.3",
   "description": "The main tmcp library",
   "main": "src/index.js",
   "type": "module",

package/src/index.js

@@ -4,7 +4,7 @@
  * @import SqidsType from "sqids";
  * @import { JSONRPCRequest, JSONRPCParams } from "json-rpc-2.0";
  * @import { ExtractURITemplateVariables } from "./internal/uri-template.js";
- * @import { CallToolResult as CallToolResultType, ReadResourceResult as ReadResourceResultType, GetPromptResult as GetPromptResultType, ServerInfo as ServerInfoType, ClientCapabilities as ClientCapabilitiesType, JSONRPCRequest as JSONRPCRequestType, JSONRPCResponse, CreateMessageRequestParams as CreateMessageRequestParamsType, CreateMessageResult as CreateMessageResultType, Resource as ResourceType, LoggingLevel as LoggingLevelType, ToolAnnotations, ClientInfo as ClientInfoType, ElicitResult as ElicitResultType, Icons as IconsType, JSONRPCMessage } from "./validation/index.js";
+ * @import { CallToolResult as CallToolResultType, ReadResourceResult as ReadResourceResultType, GetPromptResult as GetPromptResultType, ServerInfo as ServerInfoType, ClientCapabilities as ClientCapabilitiesType, JSONRPCRequest as JSONRPCRequestType, JSONRPCResponse, CreateMessageRequestParams as CreateMessageRequestParamsType, CreateMessageResult as CreateMessageResultType, Resource as ResourceType, LoggingLevel as LoggingLevelType, ToolAnnotations, ClientInfo as ClientInfoType, ElicitResult as ElicitResultType, Icons as IconsType, JSONRPCMessage, InitializeResult as InitializeResultType, ListToolsResult as ListToolsResultType, ListPromptsResult as ListPromptsResultType, ListResourceTemplatesResult as ListResourceTemplatesResultType, ListResourcesResult as ListResourcesResultType, CompleteResult as CompleteResultType } from "./validation/index.js";
  * @import { Tool, Completion, Prompt, StoredResource, ServerOptions, SubscriptionsKeys, ChangedArgs, McpEvents } from "./internal/internal.js";
  */
 import { JSONRPCClient, JSONRPCServer } from 'json-rpc-2.0';
@@ -31,6 +31,7 @@ import {
 	negotiate_protocol_version,
 } from './validation/version.js';
 import { should_version_negotiation_fail } from './validation/version.js';
+import { event } from './internal/utils.js';
 
 /**
  * Information about a validated access token, provided to request handlers.
@@ -107,6 +108,29 @@ import { should_version_negotiation_fail } from './validation/version.js';
  * @typedef  {ElicitResultType} ElicitResult
  */
 
+/**
+ * @typedef {InitializeResultType} InitializeResult
+ */
+
+/**
+ * @typedef {ListToolsResultType} ListToolsResult
+ */
+
+/**
+ * @typedef {ListPromptsResultType} ListPromptsResult
+ */
+
+/**
+ * @typedef {ListResourceTemplatesResultType} ListResourceTemplatesResult
+ */
+
+/**
+ * @typedef {ListResourcesResultType} ListResourcesResult
+ */
+/**
+ * @typedef {CompleteResultType} CompleteResult
+ */
+
 /**
  * @type {SqidsType | undefined}
  */
@@ -225,9 +249,7 @@ export class McpServer {
 
 				// Dispatch initialization event
 				this.#event_target.dispatchEvent(
-					new CustomEvent('initialize', {
-						detail: validated_initialize,
-					}),
+					event('initialize', validated_initialize),
 				);
 
 				// Return server response with negotiated version and capabilities
@@ -329,16 +351,12 @@ export class McpServer {
 			this.#client = new JSONRPCClient((payload, kind) => {
 				if (kind === 'broadcast') {
 					this.#event_target.dispatchEvent(
-						new CustomEvent('broadcast', {
-							detail: { request: payload },
-						}),
+						event('broadcast', { request: payload }),
 					);
 					return;
 				}
 				this.#event_target.dispatchEvent(
-					new CustomEvent('send', {
-						detail: { request: payload },
-					}),
+					event('send', { request: payload }),
 				);
 			});
 		}
@@ -613,9 +631,13 @@ export class McpServer {
 		if (this.#options.capabilities?.resources?.subscribe) {
 			this.#server.addMethod('resources/subscribe', async ({ uri }) => {
 				this.#event_target.dispatchEvent(
-					new CustomEvent('subscription', {
-						detail: { uri },
-					}),
+					event('subscription', { uri, action: 'add' }),
+				);
+				return {};
+			});
+			this.#server.addMethod('resources/unsubscribe', async ({ uri }) => {
+				this.#event_target.dispatchEvent(
+					event('subscription', { uri, action: 'remove' }),
 				);
 				return {};
 			});
@@ -792,9 +814,7 @@ export class McpServer {
 
 		this.#server.addMethod('logging/setLevel', ({ level }) => {
 			this.#event_target.dispatchEvent(
-				new CustomEvent('loglevelchange', {
-					detail: { level },
-				}),
+				event('loglevelchange', { level }),
 			);
 			return {};
 		});

package/src/internal/internal.d.ts

@@ -102,6 +102,6 @@ export type McpEvents = {
 		request: JSONRPCRequest;
 	}) => void;
 	initialize: (initialize_request: InitializeRequestParams) => void;
-	subscription: (subscriptions_request: { uri: string }) => void;
+	subscription: (subscriptions_request: { uri: string, action?: "add" | "remove" }) => void;
 	loglevelchange: (change: { level: LoggingLevel }) => void;
 };

package/src/internal/utils.js

@@ -0,0 +1,12 @@
+/**
+ * @import {McpEvents} from "./internal.js"
+ */
+/**
+ *	@template {keyof McpEvents} Key
+ * @param {Key} type
+ * @param {Parameters<McpEvents[Key]>[0]} detail
+ * @returns
+ */
+export function event(type, detail) {
+	return new CustomEvent(type, { detail });
+}

package/src/types/index.d.ts

@@ -206,10 +206,16 @@ declare module 'tmcp' {
 	export type LoggingLevel = LoggingLevel_1;
 	export type ClientInfo = ClientInfo_1;
 	export type ElicitResult = ElicitResult_1;
+	export type InitializeResult = InitializeResult_1;
+	export type ListToolsResult = ListToolsResult_1;
+	export type ListPromptsResult = ListPromptsResult_1;
+	export type ListResourceTemplatesResult = ListResourceTemplatesResult_1;
+	export type ListResourcesResult = ListResourcesResult_1;
+	export type CompleteResult = CompleteResult_1;
 	type Completion = (
 		query: string,
 		context: { arguments: Record<string, string> },
-	) => CompleteResult | Promise<CompleteResult>;
+	) => CompleteResult_1 | Promise<CompleteResult_1>;
 
 	type ServerOptions<TSchema extends StandardSchemaV1 | undefined> = {
 		capabilities?: ServerCapabilities;
@@ -245,7 +251,7 @@ declare module 'tmcp' {
 			request: JSONRPCRequest;
 		}) => void;
 		initialize: (initialize_request: InitializeRequestParams) => void;
-		subscription: (subscriptions_request: { uri: string }) => void;
+		subscription: (subscriptions_request: { uri: string, action?: "add" | "remove" }) => void;
 		loglevelchange: (change: { level: LoggingLevel_1 }) => void;
 	};
 	const JSONRPCMessageSchema: v.UnionSchema<[v.ObjectSchema<{
@@ -526,6 +532,114 @@ declare module 'tmcp' {
 			readonly listChanged: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
 		}, undefined>, undefined>;
 	}, undefined>;
+	/**
+	 * After receiving an initialize request from the client, the server sends this response.
+	 */
+	const InitializeResultSchema: v.ObjectSchema<{
+		/**
+		 * The version of the Model Context Protocol that the server wants to use. This may not match the version that the client requested. If the client cannot support this version, it MUST disconnect.
+		 */
+		readonly protocolVersion: v.StringSchema<undefined>;
+		readonly capabilities: v.ObjectSchema<{
+			/**
+			 * Experimental, non-standard capabilities that the server supports.
+			 */
+			readonly experimental: v.OptionalSchema<v.ObjectSchema<{}, undefined>, undefined>;
+			/**
+			 * Present if the server supports sending log messages to the client.
+			 */
+			readonly logging: v.OptionalSchema<v.ObjectSchema<{}, undefined>, undefined>;
+			/**
+			 * Present if the server supports sending completions to the client.
+			 */
+			readonly completions: v.OptionalSchema<v.ObjectSchema<{}, undefined>, undefined>;
+			/**
+			 * Present if the server offers any prompt templates.
+			 */
+			readonly prompts: v.OptionalSchema<v.ObjectSchema<{
+				/**
+				 * Whether this server supports issuing notifications for changes to the prompt list.
+				 */
+				readonly listChanged: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+			}, undefined>, undefined>;
+			/**
+			 * Present if the server offers any resources to read.
+			 */
+			readonly resources: v.OptionalSchema<v.ObjectSchema<{
+				/**
+				 * Whether this server supports clients subscribing to resource updates.
+				 */
+				readonly subscribe: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+				/**
+				 * Whether this server supports issuing notifications for changes to the resource list.
+				 */
+				readonly listChanged: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+			}, undefined>, undefined>;
+			/**
+			 * Present if the server offers any tools to call.
+			 */
+			readonly tools: v.OptionalSchema<v.ObjectSchema<{
+				/**
+				 * Whether this server supports issuing notifications for changes to the tool list.
+				 */
+				readonly listChanged: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+			}, undefined>, undefined>;
+		}, undefined>;
+		readonly serverInfo: v.ObjectSchema<{
+			/**
+			 * Optional set of sized icons that the client can display in a user interface.
+			 *
+			 * Clients that support rendering icons MUST support at least the following MIME types:
+			 * - `image/png` - PNG images (safe, universal compatibility)
+			 * - `image/jpeg` (and `image/jpg`) - JPEG images (safe, universal compatibility)
+			 *
+			 * Clients that support rendering icons SHOULD also support:
+			 * - `image/svg+xml` - SVG images (scalable but requires security precautions)
+			 * - `image/webp` - WebP images (modern, efficient format)
+			 */
+			readonly icons: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+				/**
+				 * URL or data URI for the icon.
+				 */
+				readonly src: v.StringSchema<undefined>;
+				/**
+				 * Optional MIME type for the icon.
+				 */
+				readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+				/**
+				 * Optional array of strings that specify sizes at which the icon can be used.
+				 * Each string should be in WxH format (e.g., `"48x48"`, `"96x96"`) or `"any"` for scalable formats like SVG.
+				 *
+				 * If not provided, the client should assume that the icon can be used at any size.
+				 */
+				readonly sizes: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+			}, undefined>, undefined>, undefined>;
+			readonly version: v.StringSchema<undefined>;
+			readonly websiteUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+			/** Intended for programmatic or logical use, but used as a display name in past specs or fallback */
+			readonly name: v.StringSchema<undefined>;
+			/**
+			 * Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
+			 * even by those unfamiliar with domain-specific terminology.
+			 *
+			 * If not provided, the name should be used for display (except for Tool,
+			 * where `annotations.title` should be given precedence over using `name`,
+			 * if present).
+			 */
+			readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+		}, undefined>;
+		/**
+		 * Instructions describing how to use the server and its features.
+		 *
+		 * This can be used by clients to improve the LLM's understanding of available tools, resources, etc. It can be thought of like a "hint" to the model. For example, this information MAY be added to the system prompt.
+		 */
+		readonly instructions: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+		/**
+		 * See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
+		 * for notes on _meta usage.
+		 */
+		readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+	}, undefined>;
 	/**
 	 * A known resource that the server is capable of reading.
 	 */
@@ -589,6 +703,156 @@ declare module 'tmcp' {
 		 */
 		readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
 	}, undefined>;
+	/**
+	 * The server's response to a resources/list request from the client.
+	 */
+	const ListResourcesResultSchema: v.ObjectSchema<{
+		readonly resources: v.ArraySchema<v.ObjectSchema<{
+			/**
+			 * Optional set of sized icons that the client can display in a user interface.
+			 *
+			 * Clients that support rendering icons MUST support at least the following MIME types:
+			 * - `image/png` - PNG images (safe, universal compatibility)
+			 * - `image/jpeg` (and `image/jpg`) - JPEG images (safe, universal compatibility)
+			 *
+			 * Clients that support rendering icons SHOULD also support:
+			 * - `image/svg+xml` - SVG images (scalable but requires security precautions)
+			 * - `image/webp` - WebP images (modern, efficient format)
+			 */
+			readonly icons: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+				/**
+				 * URL or data URI for the icon.
+				 */
+				readonly src: v.StringSchema<undefined>;
+				/**
+				 * Optional MIME type for the icon.
+				 */
+				readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+				/**
+				 * Optional array of strings that specify sizes at which the icon can be used.
+				 * Each string should be in WxH format (e.g., `"48x48"`, `"96x96"`) or `"any"` for scalable formats like SVG.
+				 *
+				 * If not provided, the client should assume that the icon can be used at any size.
+				 */
+				readonly sizes: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+			}, undefined>, undefined>, undefined>;
+			/**
+			 * The URI of this resource.
+			 */
+			readonly uri: v.StringSchema<undefined>;
+			/**
+			 * A description of what this resource represents.
+			 *
+			 * This can be used by clients to improve the LLM's understanding of available resources. It can be thought of like a "hint" to the model.
+			 */
+			readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+			/**
+			 * The MIME type of this resource, if known.
+			 */
+			readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+			/**
+			 * See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
+			 * for notes on _meta usage.
+			 */
+			readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+			/** Intended for programmatic or logical use, but used as a display name in past specs or fallback */
+			readonly name: v.StringSchema<undefined>;
+			/**
+			 * Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
+			 * even by those unfamiliar with domain-specific terminology.
+			 *
+			 * If not provided, the name should be used for display (except for Tool,
+			 * where `annotations.title` should be given precedence over using `name`,
+			 * if present).
+			 */
+			readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+		}, undefined>, undefined>;
+		/**
+		 * An opaque token representing the pagination position after the last returned result.
+		 * If present, there may be more results available.
+		 */
+		readonly nextCursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+		/**
+		 * See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
+		 * for notes on _meta usage.
+		 */
+		readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+	}, undefined>;
+	/**
+	 * The server's response to a resources/templates/list request from the client.
+	 */
+	const ListResourceTemplatesResultSchema: v.ObjectSchema<{
+		readonly resourceTemplates: v.ArraySchema<v.ObjectSchema<{
+			/**
+			 * Optional set of sized icons that the client can display in a user interface.
+			 *
+			 * Clients that support rendering icons MUST support at least the following MIME types:
+			 * - `image/png` - PNG images (safe, universal compatibility)
+			 * - `image/jpeg` (and `image/jpg`) - JPEG images (safe, universal compatibility)
+			 *
+			 * Clients that support rendering icons SHOULD also support:
+			 * - `image/svg+xml` - SVG images (scalable but requires security precautions)
+			 * - `image/webp` - WebP images (modern, efficient format)
+			 */
+			readonly icons: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+				/**
+				 * URL or data URI for the icon.
+				 */
+				readonly src: v.StringSchema<undefined>;
+				/**
+				 * Optional MIME type for the icon.
+				 */
+				readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+				/**
+				 * Optional array of strings that specify sizes at which the icon can be used.
+				 * Each string should be in WxH format (e.g., `"48x48"`, `"96x96"`) or `"any"` for scalable formats like SVG.
+				 *
+				 * If not provided, the client should assume that the icon can be used at any size.
+				 */
+				readonly sizes: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+			}, undefined>, undefined>, undefined>;
+			/**
+			 * A URI template (according to RFC 6570) that can be used to construct resource URIs.
+			 */
+			readonly uriTemplate: v.StringSchema<undefined>;
+			/**
+			 * A description of what this template is for.
+			 *
+			 * This can be used by clients to improve the LLM's understanding of available resources. It can be thought of like a "hint" to the model.
+			 */
+			readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+			/**
+			 * The MIME type for all resources that match this template. This should only be included if all resources matching this template have the same type.
+			 */
+			readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+			/**
+			 * See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
+			 * for notes on _meta usage.
+			 */
+			readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+			/** Intended for programmatic or logical use, but used as a display name in past specs or fallback */
+			readonly name: v.StringSchema<undefined>;
+			/**
+			 * Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
+			 * even by those unfamiliar with domain-specific terminology.
+			 *
+			 * If not provided, the name should be used for display (except for Tool,
+			 * where `annotations.title` should be given precedence over using `name`,
+			 * if present).
+			 */
+			readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+		}, undefined>, undefined>;
+		/**
+		 * An opaque token representing the pagination position after the last returned result.
+		 * If present, there may be more results available.
+		 */
+		readonly nextCursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+		/**
+		 * See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
+		 * for notes on _meta usage.
+		 */
+		readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+	}, undefined>;
 	/**
 	 * The server's response to a resources/read request from the client.
 	 */
@@ -636,6 +900,88 @@ declare module 'tmcp' {
 		 */
 		readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
 	}, undefined>;
+	/**
+	 * The server's response to a prompts/list request from the client.
+	 */
+	const ListPromptsResultSchema: v.ObjectSchema<{
+		readonly prompts: v.ArraySchema<v.ObjectSchema<{
+			/**
+			 * Optional set of sized icons that the client can display in a user interface.
+			 *
+			 * Clients that support rendering icons MUST support at least the following MIME types:
+			 * - `image/png` - PNG images (safe, universal compatibility)
+			 * - `image/jpeg` (and `image/jpg`) - JPEG images (safe, universal compatibility)
+			 *
+			 * Clients that support rendering icons SHOULD also support:
+			 * - `image/svg+xml` - SVG images (scalable but requires security precautions)
+			 * - `image/webp` - WebP images (modern, efficient format)
+			 */
+			readonly icons: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+				/**
+				 * URL or data URI for the icon.
+				 */
+				readonly src: v.StringSchema<undefined>;
+				/**
+				 * Optional MIME type for the icon.
+				 */
+				readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+				/**
+				 * Optional array of strings that specify sizes at which the icon can be used.
+				 * Each string should be in WxH format (e.g., `"48x48"`, `"96x96"`) or `"any"` for scalable formats like SVG.
+				 *
+				 * If not provided, the client should assume that the icon can be used at any size.
+				 */
+				readonly sizes: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+			}, undefined>, undefined>, undefined>;
+			/**
+			 * An optional description of what this prompt provides
+			 */
+			readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+			/**
+			 * A list of arguments to use for templating the prompt.
+			 */
+			readonly arguments: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+				/**
+				 * The name of the argument.
+				 */
+				readonly name: v.StringSchema<undefined>;
+				/**
+				 * A human-readable description of the argument.
+				 */
+				readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+				/**
+				 * Whether this argument must be provided.
+				 */
+				readonly required: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+			}, undefined>, undefined>, undefined>;
+			/**
+			 * See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
+			 * for notes on _meta usage.
+			 */
+			readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+			/** Intended for programmatic or logical use, but used as a display name in past specs or fallback */
+			readonly name: v.StringSchema<undefined>;
+			/**
+			 * Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
+			 * even by those unfamiliar with domain-specific terminology.
+			 *
+			 * If not provided, the name should be used for display (except for Tool,
+			 * where `annotations.title` should be given precedence over using `name`,
+			 * if present).
+			 */
+			readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+		}, undefined>, undefined>;
+		/**
+		 * An opaque token representing the pagination position after the last returned result.
+		 * If present, there may be more results available.
+		 */
+		readonly nextCursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+		/**
+		 * See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
+		 * for notes on _meta usage.
+		 */
+		readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+	}, undefined>;
 	/**
 	 * The server's response to a prompts/get request from the client.
 	 */
@@ -848,6 +1194,130 @@ declare module 'tmcp' {
 		 */
 		readonly openWorldHint: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
 	}, undefined>;
+	/**
+	 * The server's response to a tools/list request from the client.
+	 */
+	const ListToolsResultSchema: v.ObjectSchema<{
+		readonly tools: v.ArraySchema<v.ObjectSchema<{
+			/**
+			 * Optional set of sized icons that the client can display in a user interface.
+			 *
+			 * Clients that support rendering icons MUST support at least the following MIME types:
+			 * - `image/png` - PNG images (safe, universal compatibility)
+			 * - `image/jpeg` (and `image/jpg`) - JPEG images (safe, universal compatibility)
+			 *
+			 * Clients that support rendering icons SHOULD also support:
+			 * - `image/svg+xml` - SVG images (scalable but requires security precautions)
+			 * - `image/webp` - WebP images (modern, efficient format)
+			 */
+			readonly icons: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+				/**
+				 * URL or data URI for the icon.
+				 */
+				readonly src: v.StringSchema<undefined>;
+				/**
+				 * Optional MIME type for the icon.
+				 */
+				readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+				/**
+				 * Optional array of strings that specify sizes at which the icon can be used.
+				 * Each string should be in WxH format (e.g., `"48x48"`, `"96x96"`) or `"any"` for scalable formats like SVG.
+				 *
+				 * If not provided, the client should assume that the icon can be used at any size.
+				 */
+				readonly sizes: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+			}, undefined>, undefined>, undefined>;
+			/**
+			 * A human-readable description of the tool.
+			 */
+			readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+			/**
+			 * A JSON Schema object defining the expected parameters for the tool.
+			 */
+			readonly inputSchema: v.ObjectSchema<{
+				readonly type: v.LiteralSchema<"object", undefined>;
+				readonly properties: v.OptionalSchema<v.ObjectSchema<{}, undefined>, undefined>;
+				readonly required: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+			}, undefined>;
+			/**
+			 * An optional JSON Schema object defining the structure of the tool's output returned in
+			 * the structuredContent field of a CallToolResult.
+			 */
+			readonly outputSchema: v.OptionalSchema<v.ObjectSchema<{
+				readonly type: v.LiteralSchema<"object", undefined>;
+				readonly properties: v.OptionalSchema<v.ObjectSchema<{}, undefined>, undefined>;
+				readonly required: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+			}, undefined>, undefined>;
+			/**
+			 * Optional additional tool information.
+			 */
+			readonly annotations: v.OptionalSchema<v.ObjectSchema<{
+				/**
+				 * A human-readable title for the tool.
+				 */
+				readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+				/**
+				 * If true, the tool does not modify its environment.
+				 *
+				 * Default: false
+				 */
+				readonly readOnlyHint: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+				/**
+				 * If true, the tool may perform destructive updates to its environment.
+				 * If false, the tool performs only additive updates.
+				 *
+				 * (This property is meaningful only when `readOnlyHint == false`)
+				 *
+				 * Default: true
+				 */
+				readonly destructiveHint: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+				/**
+				 * If true, calling the tool repeatedly with the same arguments
+				 * will have no additional effect on the its environment.
+				 *
+				 * (This property is meaningful only when `readOnlyHint == false`)
+				 *
+				 * Default: false
+				 */
+				readonly idempotentHint: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+				/**
+				 * If true, this tool may interact with an "open world" of external
+				 * entities. If false, the tool's domain of interaction is closed.
+				 * For example, the world of a web search tool is open, whereas that
+				 * of a memory tool is not.
+				 *
+				 * Default: true
+				 */
+				readonly openWorldHint: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+			}, undefined>, undefined>;
+			/**
+			 * See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
+			 * for notes on _meta usage.
+			 */
+			readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+			/** Intended for programmatic or logical use, but used as a display name in past specs or fallback */
+			readonly name: v.StringSchema<undefined>;
+			/**
+			 * Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
+			 * even by those unfamiliar with domain-specific terminology.
+			 *
+			 * If not provided, the name should be used for display (except for Tool,
+			 * where `annotations.title` should be given precedence over using `name`,
+			 * if present).
+			 */
+			readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+		}, undefined>, undefined>;
+		/**
+		 * An opaque token representing the pagination position after the last returned result.
+		 * If present, there may be more results available.
+		 */
+		readonly nextCursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+		/**
+		 * See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
+		 * for notes on _meta usage.
+		 */
+		readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+	}, undefined>;
 	/**
 	 * The server's response to a tool call.
 	 */
@@ -1255,7 +1725,7 @@ declare module 'tmcp' {
 	}));
 	type ReadResourceResult_1 = v.InferInput<typeof ReadResourceResultSchema>;
 	type GetPromptResult_1 = v.InferInput<typeof GetPromptResultSchema>;
-	type CompleteResult = v.InferInput<typeof CompleteResultSchema>;
+	type CompleteResult_1 = v.InferInput<typeof CompleteResultSchema>;
 	type CreateMessageRequestParams_1 = v.InferInput<typeof CreateMessageRequestParamsSchema>;
 	type CreateMessageResult_1 = v.InferInput<typeof CreateMessageResultSchema>;
 	type Resource_1 = v.InferInput<typeof ResourceSchema>;
@@ -1263,6 +1733,11 @@ declare module 'tmcp' {
 	type LoggingLevel_1 = v.InferInput<typeof LoggingLevelSchema>;
 	type ToolAnnotations = v.InferInput<typeof ToolAnnotationsSchema>;
 	type ElicitResult_1 = v.InferInput<typeof ElicitResultSchema>;
+	type InitializeResult_1 = v.InferInput<typeof InitializeResultSchema>;
+	type ListToolsResult_1 = v.InferInput<typeof ListToolsResultSchema>;
+	type ListPromptsResult_1 = v.InferInput<typeof ListPromptsResultSchema>;
+	type ListResourcesResult_1 = v.InferInput<typeof ListResourcesResultSchema>;
+	type ListResourceTemplatesResult_1 = v.InferInput<typeof ListResourceTemplatesResultSchema>;
 	// Helper type to remove whitespace
 	type Trim<S extends string> = S extends ` ${infer R}`
 		? Trim<R>

package/src/types/index.d.ts.map

@@ -15,6 +15,12 @@
 		"LoggingLevel",
 		"ClientInfo",
 		"ElicitResult",
+		"InitializeResult",
+		"ListToolsResult",
+		"ListPromptsResult",
+		"ListResourceTemplatesResult",
+		"ListResourcesResult",
+		"CompleteResult",
 		"Completion",
 		"ServerOptions",
 		"ChangedArgs",
@@ -27,10 +33,15 @@
 		"ClientCapabilitiesSchema",
 		"InitializeRequestParamsSchema",
 		"ServerCapabilitiesSchema",
+		"InitializeResultSchema",
 		"ResourceSchema",
+		"ListResourcesResultSchema",
+		"ListResourceTemplatesResultSchema",
 		"ReadResourceResultSchema",
+		"ListPromptsResultSchema",
 		"GetPromptResultSchema",
 		"ToolAnnotationsSchema",
+		"ListToolsResultSchema",
 		"CallToolResultSchema",
 		"LoggingLevelSchema",
 		"CreateMessageRequestParamsSchema",
@@ -39,7 +50,6 @@
 		"CompleteResultSchema",
 		"ServerCapabilities",
 		"InitializeRequestParams",
-		"CompleteResult",
 		"JSONRPCMessage",
 		"ToolAnnotations",
 		"Trim",
@@ -64,6 +74,6 @@
 		null,
 		null
 	],
-	"mappings": ";;;;;cAyJaA,SAASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aCw1CyBC,KAAKA;aDp7CFC,aAAaA;;aC28CHC,kBAAkBA;aAGrBC,eAAeA;aAvBZC,kBAAkBA;aAUKC,UAAUA;aAmBzBC,0BAA0BA;aAGjCC,mBAAmBA;aAY9BC,QAAQA;aAYJC,YAAYA;aAlDVC,UAAUA;aAwDZC,YAAYA;MCrhDtDC,UAAUA;;;;;MAyCVC,aAAaA;;;;;;;;;;;;;MAabC,WAAWA;;;;;;;MAOlBC,oBAAoBA;;;;MAIbC,iBAAiBA;;MAEjBC,SAASA;;;;;;;;;;;ODgCRC,oBAAoBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmFpBC,WAAWA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoBXC,oBAAoBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAUpBC,wBAAwBA;;;;;;;;;;;;;;;;;;;;;;;OA6BxBC,6BAA6BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuB7BC,wBAAwBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmMxBC,cAAcA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8GdC,wBAAwBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+PxBC,qBAAqBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BrBC,qBAAqBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4GrBC,oBAAoBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoEpBC,kBAAkBA;OAuGlBC,gCAAgCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8ChCC,yBAAyBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6GzBC,kBAAkBA;;;;;;;;;;;;;;;;;;OAkFlBC,oBAAoBA;;;;;;;;;;;;;;;;;;;;;;;MAiI2BC,kBAAkBA;;;;;MAUbC,uBAAuBA;;;;;;;;;;;;;MAahCC,cAAcA;;;;MAwBdC,cAAcA;;MASbC,eAAeA;;;ME9iDnEC,IAAIA;;;;;;;MAOJC,cAAcA;;;;;;;MAOdC,cAAcA;;;;;MAKdC,qBAAqBA;;;;;;;;;;;;;;;;;MAiBrBC,4BAA4BA;;;;;;MAMrBC,2BAA2BA;;;;;;;OCjC1BC,iBAAiBA;;;;;;;;;;;;;;;;cAAjBA,iBAAiBA",
+	"mappings": "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",
 	"ignoreList": []
 }

package/src/validation/index.js

@@ -1586,3 +1586,18 @@ export const ServerResultSchema = v.union([
 /**
  * @typedef {v.InferInput<typeof ElicitResultSchema>} ElicitResult
  */
+/**
+ * @typedef {v.InferInput<typeof InitializeResultSchema>} InitializeResult
+ */
+/**
+ * @typedef {v.InferInput<typeof ListToolsResultSchema>} ListToolsResult
+ */
+/**
+ * @typedef {v.InferInput<typeof ListPromptsResultSchema>} ListPromptsResult
+ */
+/**
+ * @typedef {v.InferInput<typeof ListResourcesResultSchema>} ListResourcesResult
+ */
+/**
+ * @typedef {v.InferInput<typeof ListResourceTemplatesResultSchema>} ListResourceTemplatesResult
+ */