@mcp-ts/sdk 2.0.0 → 2.2.0

package/dist/server/index.d.mts

@@ -4,8 +4,8 @@ import { OAuthClientInformationMixed, OAuthTokens } from '@modelcontextprotocol/
 export { OAuthClientInformation, OAuthClientInformationFull, OAuthClientMetadata, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
 import { M as McpConnectionEvent, d as McpObservabilityEvent } from '../events-CK3N--3g.mjs';
 export { D as Disposable, E as Emitter, b as Event, c as McpConnectionState } from '../events-CK3N--3g.mjs';
-import { r as McpRpcResponse, q as McpRpcRequest } from '../types-BCAG20P6.mjs';
-export { a as CallToolRequest, b as CallToolResponse, f as ConnectRequest, g as ConnectResponse, n as ListToolsResponse, T as ToolClient, u as ToolClientProvider, v as ToolInfo } from '../types-BCAG20P6.mjs';
+import { r as McpRpcResponse, q as McpRpcRequest } from '../types-CxFaaZrM.mjs';
+export { a as CallToolRequest, b as CallToolResponse, f as ConnectRequest, g as ConnectResponse, n as ListToolsResponse, T as ToolClient, u as ToolClientProvider, v as ToolInfo } from '../types-CxFaaZrM.mjs';
 export { CallToolResult, ListToolsResult, Tool } from '@modelcontextprotocol/sdk/types.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
 

package/dist/server/index.d.ts

@@ -4,8 +4,8 @@ import { OAuthClientInformationMixed, OAuthTokens } from '@modelcontextprotocol/
 export { OAuthClientInformation, OAuthClientInformationFull, OAuthClientMetadata, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
 import { M as McpConnectionEvent, d as McpObservabilityEvent } from '../events-CK3N--3g.js';
 export { D as Disposable, E as Emitter, b as Event, c as McpConnectionState } from '../events-CK3N--3g.js';
-import { r as McpRpcResponse, q as McpRpcRequest } from '../types-BCAG20P6.js';
-export { a as CallToolRequest, b as CallToolResponse, f as ConnectRequest, g as ConnectResponse, n as ListToolsResponse, T as ToolClient, u as ToolClientProvider, v as ToolInfo } from '../types-BCAG20P6.js';
+import { r as McpRpcResponse, q as McpRpcRequest } from '../types-CxFaaZrM.js';
+export { a as CallToolRequest, b as CallToolResponse, f as ConnectRequest, g as ConnectResponse, n as ListToolsResponse, T as ToolClient, u as ToolClientProvider, v as ToolInfo } from '../types-CxFaaZrM.js';
 export { CallToolResult, ListToolsResult, Tool } from '@modelcontextprotocol/sdk/types.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
 

package/dist/shared/index.d.mts

@@ -1,9 +1,9 @@
 export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from '../events-CK3N--3g.mjs';
 export { A as AuthenticationError, C as ConfigurationError, a as ConnectionError, I as InvalidStateError, M as McpError, N as NotConnectedError, R as RpcErrorCode, b as RpcErrorCodes, S as SessionNotFoundError, c as SessionValidationError, T as ToolExecutionError, U as UnauthorizedError, s as sanitizeServerLabel } from '../utils-DELRKQPU.mjs';
-import { v as ToolInfo } from '../types-BCAG20P6.mjs';
-export { C as CallToolParams, a as CallToolRequest, b as CallToolResponse, c as ConnectAuthRequiredResponse, d as ConnectErrorResponse, e as ConnectParams, f as ConnectRequest, g as ConnectResponse, h as ConnectResult, i as ConnectSuccessResponse, D as DisconnectParams, j as DisconnectResult, F as FinishAuthParams, k as FinishAuthResult, G as GetPromptParams, l as GetSessionResult, L as ListPromptsResult, m as ListResourcesResult, n as ListToolsResponse, o as ListToolsRpcResult, M as McpRpcMethod, p as McpRpcParams, q as McpRpcRequest, r as McpRpcResponse, R as ReadResourceParams, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolClient, u as ToolClientProvider, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from '../types-BCAG20P6.mjs';
-import { d as ToolRouter } from '../tool-router-Dnd6IOKC.mjs';
-export { C as CompactTool, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, a as ToolIndex, b as ToolIndexOptions, c as ToolListResult, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSearchOptions, i as ToolServerSummary, j as ToolSummary } from '../tool-router-Dnd6IOKC.mjs';
+import { v as ToolInfo } from '../types-CxFaaZrM.mjs';
+export { C as CallToolParams, a as CallToolRequest, b as CallToolResponse, c as ConnectAuthRequiredResponse, d as ConnectErrorResponse, e as ConnectParams, f as ConnectRequest, g as ConnectResponse, h as ConnectResult, i as ConnectSuccessResponse, D as DisconnectParams, j as DisconnectResult, F as FinishAuthParams, k as FinishAuthResult, G as GetPromptParams, l as GetSessionResult, L as ListPromptsResult, m as ListResourcesResult, n as ListToolsResponse, o as ListToolsRpcResult, M as McpRpcMethod, p as McpRpcParams, q as McpRpcRequest, r as McpRpcResponse, R as ReadResourceParams, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolClient, u as ToolClientProvider, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from '../types-CxFaaZrM.mjs';
+import { d as ToolRouter } from '../tool-router-C8hIA-tg.mjs';
+export { C as CompactTool, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, a as ToolIndex, b as ToolIndexOptions, c as ToolListResult, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSearchOptions, i as ToolServerSummary, j as ToolSummary } from '../tool-router-C8hIA-tg.mjs';
 import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 
 /**
@@ -102,8 +102,8 @@ declare function createRegexSearchToolDefinition(): Tool;
  *
  * After discovering tools via `mcp_search_tools` or
  * `mcp_search_tool_regex`, the LLM calls this to load the full
- * inputSchema for a specific tool so it can construct the correct
- * arguments.
+ * input and output schemas for a specific tool so it can construct the
+ * correct arguments and plan around the result shape.
  */
 declare function createGetSchemaToolDefinition(): Tool;
 /**

package/dist/shared/index.d.ts

@@ -1,9 +1,9 @@
 export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from '../events-CK3N--3g.js';
 export { A as AuthenticationError, C as ConfigurationError, a as ConnectionError, I as InvalidStateError, M as McpError, N as NotConnectedError, R as RpcErrorCode, b as RpcErrorCodes, S as SessionNotFoundError, c as SessionValidationError, T as ToolExecutionError, U as UnauthorizedError, s as sanitizeServerLabel } from '../utils-DELRKQPU.js';
-import { v as ToolInfo } from '../types-BCAG20P6.js';
-export { C as CallToolParams, a as CallToolRequest, b as CallToolResponse, c as ConnectAuthRequiredResponse, d as ConnectErrorResponse, e as ConnectParams, f as ConnectRequest, g as ConnectResponse, h as ConnectResult, i as ConnectSuccessResponse, D as DisconnectParams, j as DisconnectResult, F as FinishAuthParams, k as FinishAuthResult, G as GetPromptParams, l as GetSessionResult, L as ListPromptsResult, m as ListResourcesResult, n as ListToolsResponse, o as ListToolsRpcResult, M as McpRpcMethod, p as McpRpcParams, q as McpRpcRequest, r as McpRpcResponse, R as ReadResourceParams, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolClient, u as ToolClientProvider, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from '../types-BCAG20P6.js';
-import { d as ToolRouter } from '../tool-router-Ddtybmr0.js';
-export { C as CompactTool, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, a as ToolIndex, b as ToolIndexOptions, c as ToolListResult, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSearchOptions, i as ToolServerSummary, j as ToolSummary } from '../tool-router-Ddtybmr0.js';
+import { v as ToolInfo } from '../types-CxFaaZrM.js';
+export { C as CallToolParams, a as CallToolRequest, b as CallToolResponse, c as ConnectAuthRequiredResponse, d as ConnectErrorResponse, e as ConnectParams, f as ConnectRequest, g as ConnectResponse, h as ConnectResult, i as ConnectSuccessResponse, D as DisconnectParams, j as DisconnectResult, F as FinishAuthParams, k as FinishAuthResult, G as GetPromptParams, l as GetSessionResult, L as ListPromptsResult, m as ListResourcesResult, n as ListToolsResponse, o as ListToolsRpcResult, M as McpRpcMethod, p as McpRpcParams, q as McpRpcRequest, r as McpRpcResponse, R as ReadResourceParams, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolClient, u as ToolClientProvider, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from '../types-CxFaaZrM.js';
+import { d as ToolRouter } from '../tool-router-CdX8e9bk.js';
+export { C as CompactTool, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, a as ToolIndex, b as ToolIndexOptions, c as ToolListResult, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSearchOptions, i as ToolServerSummary, j as ToolSummary } from '../tool-router-CdX8e9bk.js';
 import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 
 /**
@@ -102,8 +102,8 @@ declare function createRegexSearchToolDefinition(): Tool;
  *
  * After discovering tools via `mcp_search_tools` or
  * `mcp_search_tool_regex`, the LLM calls this to load the full
- * inputSchema for a specific tool so it can construct the correct
- * arguments.
+ * input and output schemas for a specific tool so it can construct the
+ * correct arguments and plan around the result shape.
  */
 declare function createGetSchemaToolDefinition(): Tool;
 /**

package/dist/shared/index.js

@@ -764,7 +764,7 @@ function createRegexSearchToolDefinition() {
 function createGetSchemaToolDefinition() {
   return {
     name: "mcp_get_tool_schema",
-    description: "Get the full input schema (parameters) for a specific tool. Call this after mcp_search_tools to get the parameter details needed to call a tool correctly. Do NOT call the discovered tool directly; after reading the schema, call mcp_execute_tool.",
+    description: "Get the full input schema (parameters) and output schema (result shape) for a specific tool. Call this after mcp_search_tools to get the parameter details needed to call a tool correctly and understand what it returns. Do NOT call the discovered tool directly; after reading the schema, call mcp_execute_tool.",
     inputSchema: {
       type: "object",
       properties: {
@@ -949,6 +949,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
         name: tool.name,
         description: tool.description,
         inputSchema: tool.inputSchema,
+        outputSchema: tool.outputSchema,
         executionInstructions: {
           nextTool: "mcp_execute_tool",
           toolName: tool.name,
@@ -1044,18 +1045,29 @@ var ToolRouter = class {
     this.options = options;
     __publicField(this, "index");
     __publicField(this, "allTools", []);
+    __publicField(this, "pinnedTools", []);
+    __publicField(this, "deferredTools", []);
+    __publicField(this, "discoverableTools", []);
     __publicField(this, "groupsMap", /* @__PURE__ */ new Map());
     __publicField(this, "strategy");
     __publicField(this, "maxTools");
     __publicField(this, "compactSchemas");
     __publicField(this, "activeGroups");
     __publicField(this, "customGroups");
+    __publicField(this, "pinnedToolNames");
+    __publicField(this, "deferredToolNames");
+    __publicField(this, "excludeToolMatchers");
     __publicField(this, "initialized", false);
     this.strategy = options.strategy ?? "all";
     this.maxTools = options.maxTools ?? 40;
     this.compactSchemas = options.compactSchemas ?? false;
     this.activeGroups = new Set(options.activeGroups ?? []);
     this.customGroups = options.groups;
+    this.pinnedToolNames = new Set(options.pinnedTools ?? []);
+    this.deferredToolNames = new Set(options.deferredTools ?? []);
+    this.excludeToolMatchers = (options.excludeTools ?? []).map(
+      (pattern) => globToRegExp(pattern)
+    );
     this.index = new ToolIndex({
       embedFn: options.embedFn,
       keywordWeight: options.keywordWeight
@@ -1076,13 +1088,14 @@ var ToolRouter = class {
     await this.ensureInitialized();
     switch (this.strategy) {
       case "search":
-        return this.getMetaToolDefinitions();
+        return [...this.getMetaToolDefinitions(), ...this.pinnedTools];
       case "groups":
         return this.getGroupFilteredTools();
       case "all":
       default:
+        const directlyVisibleTools = this.getDirectlyVisibleTools();
         if (this.compactSchemas) {
-          return this.allTools.map((t) => {
+          return directlyVisibleTools.map((t) => {
             const compact = SchemaCompressor.toCompact(t);
             return {
               name: compact.name,
@@ -1091,7 +1104,7 @@ var ToolRouter = class {
             };
           });
         }
-        return [...this.allTools];
+        return [...directlyVisibleTools];
     }
   }
   /**
@@ -1203,8 +1216,14 @@ var ToolRouter = class {
   /** Lazy initialization — fetches tools from all connected clients. */
   async ensureInitialized() {
     if (this.initialized) return;
-    this.allTools = await this.fetchAllTools();
-    await this.index.buildIndex(this.allTools);
+    const fetchedTools = await this.fetchAllTools();
+    this.allTools = fetchedTools.filter((tool) => !this.matchesExcludedTool(tool.name));
+    this.pinnedTools = this.allTools.filter((tool) => this.matchesPinnedTool(tool.name));
+    this.deferredTools = this.allTools.filter(
+      (tool) => !this.matchesPinnedTool(tool.name) && this.matchesDeferredTool(tool)
+    );
+    this.discoverableTools = this.allTools.filter((tool) => !this.matchesPinnedTool(tool.name));
+    await this.index.buildIndex(this.discoverableTools);
     this.buildGroups();
     this.initialized = true;
   }
@@ -1280,7 +1299,7 @@ var ToolRouter = class {
         }
       }
     }
-    const filtered = this.allTools.filter((t) => activeToolNames.has(t.name));
+    const filtered = this.getDirectlyVisibleTools().filter((t) => activeToolNames.has(t.name));
     if (this.compactSchemas) {
       return filtered.slice(0, this.maxTools).map((t) => {
         const compact = SchemaCompressor.toCompact(t);
@@ -1303,7 +1322,28 @@ var ToolRouter = class {
       createExecuteToolDefinition()
     ];
   }
+  matchesPinnedTool(toolName) {
+    return this.pinnedToolNames.has(toolName);
+  }
+  matchesDeferredTool(tool) {
+    if (this.deferredToolNames.has(tool.name)) {
+      return true;
+    }
+    const meta = tool._meta;
+    return meta?.toolRouter?.deferred === true;
+  }
+  matchesExcludedTool(toolName) {
+    return this.excludeToolMatchers.some((matcher) => matcher.test(toolName));
+  }
+  getDirectlyVisibleTools() {
+    return this.allTools.filter((tool) => !this.matchesDeferredTool(tool) || this.matchesPinnedTool(tool.name));
+  }
 };
+function globToRegExp(pattern) {
+  const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+  const regexPattern = `^${escaped.replace(/\*/g, ".*")}$`;
+  return new RegExp(regexPattern);
+}
 
 exports.AuthenticationError = AuthenticationError;
 exports.ConfigurationError = ConfigurationError;