@mcp-ts/sdk 1.5.3 → 1.6.1

package/dist/client/vue.d.mts

@@ -1,9 +1,9 @@
-import { c as SSEClient } from '../index-DcYfpY3H.mjs';
-export { A as APP_HOST_DEFAULTS, a as AppHost, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, d as SSEClientOptions } from '../index-DcYfpY3H.mjs';
+import { c as SSEClient } from '../index-bFL4ZF2N.mjs';
+export { A as APP_HOST_DEFAULTS, a as AppHost, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, d as SSEClientOptions } from '../index-bFL4ZF2N.mjs';
 import { c as McpConnectionState, M as McpConnectionEvent } from '../events-CK3N--3g.mjs';
 export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, d as McpObservabilityEvent } from '../events-CK3N--3g.mjs';
-import { v as ToolInfo, k as FinishAuthResult, n as ListToolsRpcResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-CfCoIsWI.mjs';
-export { p as McpRpcRequest, q as McpRpcResponse } from '../types-CfCoIsWI.mjs';
+import { v as ToolInfo, k as FinishAuthResult, n as ListToolsRpcResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-rIuN1CQi.mjs';
+export { p as McpRpcRequest, q as McpRpcResponse } from '../types-rIuN1CQi.mjs';
 import '@modelcontextprotocol/ext-apps/app-bridge';
 import '@modelcontextprotocol/sdk/types.js';
 

package/dist/client/vue.d.ts

@@ -1,9 +1,9 @@
-import { c as SSEClient } from '../index-GfC_eNEv.js';
-export { A as APP_HOST_DEFAULTS, a as AppHost, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, d as SSEClientOptions } from '../index-GfC_eNEv.js';
+import { c as SSEClient } from '../index-DhA-OEAe.js';
+export { A as APP_HOST_DEFAULTS, a as AppHost, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, d as SSEClientOptions } from '../index-DhA-OEAe.js';
 import { c as McpConnectionState, M as McpConnectionEvent } from '../events-CK3N--3g.js';
 export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, d as McpObservabilityEvent } from '../events-CK3N--3g.js';
-import { v as ToolInfo, k as FinishAuthResult, n as ListToolsRpcResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-CfCoIsWI.js';
-export { p as McpRpcRequest, q as McpRpcResponse } from '../types-CfCoIsWI.js';
+import { v as ToolInfo, k as FinishAuthResult, n as ListToolsRpcResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-rIuN1CQi.js';
+export { p as McpRpcRequest, q as McpRpcResponse } from '../types-rIuN1CQi.js';
 import '@modelcontextprotocol/ext-apps/app-bridge';
 import '@modelcontextprotocol/sdk/types.js';
 

package/dist/{index-GfC_eNEv.d.ts → index-DhA-OEAe.d.ts}

@@ -1,5 +1,5 @@
 import { M as McpConnectionEvent, d as McpObservabilityEvent, e as McpAppsUIEvent } from './events-CK3N--3g.js';
-import { s as SessionListResult, e as ConnectParams, h as ConnectResult, j as DisconnectResult, n as ListToolsRpcResult, r as RestoreSessionResult, k as FinishAuthResult, L as ListPromptsResult, l as ListResourcesResult } from './types-CfCoIsWI.js';
+import { s as SessionListResult, e as ConnectParams, h as ConnectResult, j as DisconnectResult, n as ListToolsRpcResult, r as RestoreSessionResult, k as FinishAuthResult, L as ListPromptsResult, l as ListResourcesResult } from './types-rIuN1CQi.js';
 import { AppBridge } from '@modelcontextprotocol/ext-apps/app-bridge';
 import { LoggingMessageNotification } from '@modelcontextprotocol/sdk/types.js';
 

package/dist/{index-DcYfpY3H.d.mts → index-bFL4ZF2N.d.mts}

@@ -1,5 +1,5 @@
 import { M as McpConnectionEvent, d as McpObservabilityEvent, e as McpAppsUIEvent } from './events-CK3N--3g.mjs';
-import { s as SessionListResult, e as ConnectParams, h as ConnectResult, j as DisconnectResult, n as ListToolsRpcResult, r as RestoreSessionResult, k as FinishAuthResult, L as ListPromptsResult, l as ListResourcesResult } from './types-CfCoIsWI.mjs';
+import { s as SessionListResult, e as ConnectParams, h as ConnectResult, j as DisconnectResult, n as ListToolsRpcResult, r as RestoreSessionResult, k as FinishAuthResult, L as ListPromptsResult, l as ListResourcesResult } from './types-rIuN1CQi.mjs';
 import { AppBridge } from '@modelcontextprotocol/ext-apps/app-bridge';
 import { LoggingMessageNotification } from '@modelcontextprotocol/sdk/types.js';
 

package/dist/index.d.mts

@@ -2,11 +2,11 @@ export { M as MCPClient, a as MultiSessionClient, S as StorageOAuthClientProvide
 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-0qmYrqoa.mjs';
 export { ClientMetadata, NextMcpHandlerOptions, SSEConnectionManager, SSEHandlerOptions, StorageBackend, createNextMcpHandler, createSSEHandler, storage } from './server/index.mjs';
 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 { 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 ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolClient, u as ToolClientProvider, v as ToolInfo, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from './types-CfCoIsWI.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 ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolClient, u as ToolClientProvider, v as ToolInfo, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from './types-rIuN1CQi.mjs';
 export { OAuthClientInformation, OAuthClientInformationFull, OAuthClientMetadata, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
 export { CallToolResult, ListToolsResult, Tool } from '@modelcontextprotocol/sdk/types.js';
-export { A as APP_HOST_DEFAULTS, a as AppHost, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, c as SSEClient, d as SSEClientOptions } from './index-DcYfpY3H.mjs';
-export { CallToolFn, DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, REDIS_KEY_PREFIX, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, TOKEN_EXPIRY_BUFFER_MS, ToolUiConfig, createExecuteToolDefinition, createGetSchemaToolDefinition, createRegexSearchToolDefinition, createSearchToolDefinition, executeMetaTool, findToolByName, getToolUiResourceUri, isMetaTool, resolveMetaToolProxy } from './shared/index.mjs';
-export { C as CompactTool, a as CompressionStats, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, b as ToolIndex, c as ToolIndexOptions, d as ToolRouter, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSummary } from './tool-router-DK0RJblO.mjs';
+export { A as APP_HOST_DEFAULTS, a as AppHost, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, c as SSEClient, d as SSEClientOptions } from './index-bFL4ZF2N.mjs';
+export { CallToolFn, DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, REDIS_KEY_PREFIX, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, TOKEN_EXPIRY_BUFFER_MS, ToolUiConfig, createExecuteToolDefinition, createGetSchemaToolDefinition, createListServersToolDefinition, createRegexSearchToolDefinition, createSearchToolDefinition, executeMetaTool, findToolByName, getToolUiResourceUri, isMetaTool, resolveMetaToolProxy } from './shared/index.mjs';
+export { C as CompactTool, a as CompressionStats, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, b as ToolIndex, c as ToolIndexOptions, d as ToolListResult, e as ToolRouter, f as ToolRouterClientInput, g as ToolRouterOptions, h as ToolRouterStrategy, i as ToolSearchOptions, j as ToolServerSummary, k as ToolSummary } from './tool-router-BVaV1udm.mjs';
 import '@modelcontextprotocol/sdk/client/auth.js';
 import '@modelcontextprotocol/ext-apps/app-bridge';

package/dist/index.d.ts

@@ -2,11 +2,11 @@ export { M as MCPClient, a as MultiSessionClient, S as StorageOAuthClientProvide
 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-0qmYrqoa.js';
 export { ClientMetadata, NextMcpHandlerOptions, SSEConnectionManager, SSEHandlerOptions, StorageBackend, createNextMcpHandler, createSSEHandler, storage } from './server/index.js';
 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 { 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 ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolClient, u as ToolClientProvider, v as ToolInfo, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from './types-CfCoIsWI.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 ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolClient, u as ToolClientProvider, v as ToolInfo, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from './types-rIuN1CQi.js';
 export { OAuthClientInformation, OAuthClientInformationFull, OAuthClientMetadata, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
 export { CallToolResult, ListToolsResult, Tool } from '@modelcontextprotocol/sdk/types.js';
-export { A as APP_HOST_DEFAULTS, a as AppHost, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, c as SSEClient, d as SSEClientOptions } from './index-GfC_eNEv.js';
-export { CallToolFn, DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, REDIS_KEY_PREFIX, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, TOKEN_EXPIRY_BUFFER_MS, ToolUiConfig, createExecuteToolDefinition, createGetSchemaToolDefinition, createRegexSearchToolDefinition, createSearchToolDefinition, executeMetaTool, findToolByName, getToolUiResourceUri, isMetaTool, resolveMetaToolProxy } from './shared/index.js';
-export { C as CompactTool, a as CompressionStats, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, b as ToolIndex, c as ToolIndexOptions, d as ToolRouter, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSummary } from './tool-router-DsKhRmJm.js';
+export { A as APP_HOST_DEFAULTS, a as AppHost, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, c as SSEClient, d as SSEClientOptions } from './index-DhA-OEAe.js';
+export { CallToolFn, DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, REDIS_KEY_PREFIX, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, TOKEN_EXPIRY_BUFFER_MS, ToolUiConfig, createExecuteToolDefinition, createGetSchemaToolDefinition, createListServersToolDefinition, createRegexSearchToolDefinition, createSearchToolDefinition, executeMetaTool, findToolByName, getToolUiResourceUri, isMetaTool, resolveMetaToolProxy } from './shared/index.js';
+export { C as CompactTool, a as CompressionStats, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, b as ToolIndex, c as ToolIndexOptions, d as ToolListResult, e as ToolRouter, f as ToolRouterClientInput, g as ToolRouterOptions, h as ToolRouterStrategy, i as ToolSearchOptions, j as ToolServerSummary, k as ToolSummary } from './tool-router-Dh2804tM.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
 import '@modelcontextprotocol/ext-apps/app-bridge';

package/dist/index.js

@@ -1584,9 +1584,10 @@ var MCPClient = class _MCPClient {
       throw new Error("Server URL is required to create transport");
     }
     const baseUrl = new URL(this.serverUrl);
+    const hasAuthorizationHeader = Object.keys(this.headers || {}).some((key) => key.toLowerCase() === "authorization");
     const transportOptions = {
-      authProvider: this.oauthProvider,
-      ...this.headers && { headers: this.headers },
+      ...!hasAuthorizationHeader && { authProvider: this.oauthProvider },
+      ...this.headers && { requestInit: { headers: this.headers } },
       /**
        * Custom fetch implementation to handle connection timeouts.
        * Observation: SDK 1.24.0+ connections may hang indefinitely in some environments.
@@ -1687,6 +1688,7 @@ var MCPClient = class _MCPClient {
         serverUrl: this.serverUrl,
         callbackUrl: this.callbackUrl,
         transportType: this.transportType || "streamable_http",
+        headers: this.headers,
         createdAt: this.createdAt,
         active: false
       }, Math.floor(STATE_EXPIRATION_MS / 1e3));
@@ -1711,6 +1713,7 @@ var MCPClient = class _MCPClient {
       serverUrl: this.serverUrl,
       callbackUrl: this.callbackUrl,
       transportType: this.transportType || "streamable_http",
+      headers: this.headers,
       createdAt: this.createdAt || Date.now(),
       active
     };
@@ -2270,9 +2273,7 @@ var MCPClient = class _MCPClient {
    * @returns Server name or undefined
    */
   getServerName() {
-    const info = this.client?.getServerVersion();
-    console.log("server info ->", info);
-    return info?.title ?? info?.name ?? this.serverName;
+    return this.serverName;
   }
   /**
    * Gets the server ID
@@ -2551,6 +2552,11 @@ function isConnectionEvent(event) {
 
 // src/server/handlers/sse-handler.ts
 var DEFAULT_HEARTBEAT_INTERVAL = 3e4;
+function normalizeHeaders(headers) {
+  if (!headers || typeof headers !== "object") return void 0;
+  const entries = Object.entries(headers).map(([key, value]) => [key.trim(), String(value).trim()]).filter(([key, value]) => key.length > 0 && value.length > 0);
+  return entries.length > 0 ? Object.fromEntries(entries) : void 0;
+}
 var SSEConnectionManager = class {
   constructor(options, sendEvent) {
     this.options = options;
@@ -2675,6 +2681,7 @@ var SSEConnectionManager = class {
    */
   async connect(params) {
     const { serverName, serverUrl, callbackUrl, transportType } = params;
+    const headers = normalizeHeaders(params.headers);
     const serverId = params.serverId && params.serverId.length <= 12 ? params.serverId : await storage.generateSessionId();
     const existingSessions = await storage.getIdentitySessionsData(this.identity);
     const duplicate = existingSessions.find(
@@ -2701,6 +2708,7 @@ var SSEConnectionManager = class {
         serverUrl,
         callbackUrl,
         transportType,
+        headers,
         ...clientMetadata
         // Spread client metadata (clientName, clientUri, logoUri, policyUri)
       });
@@ -4042,17 +4050,17 @@ var ToolIndex = class _ToolIndex {
    *
    *   `score = keywordWeight × keyword_score + (1 - keywordWeight) × cosine_score`
    */
-  async search(query, topK = 5) {
+  async search(query, topK = 5, options = {}) {
     if (this.tools.size === 0) return [];
     const queryLower = query.toLowerCase().trim();
     const exactMatches = [...this.toolSummaries.values()].filter(
-      (summary) => summary.name.toLowerCase() === queryLower
+      (summary) => summary.name.toLowerCase() === queryLower && this.matchesServer(summary, options)
     );
     if (exactMatches.length > 0) {
       return exactMatches.slice(0, topK);
     }
     if (queryLower.startsWith("mcp__") && queryLower.length > 5) {
-      const prefixMatches = [...this.toolSummaries.values()].filter((t) => t.name.toLowerCase().startsWith(queryLower)).slice(0, topK);
+      const prefixMatches = [...this.toolSummaries.values()].filter((t) => t.name.toLowerCase().startsWith(queryLower) && this.matchesServer(t, options)).slice(0, topK);
       if (prefixMatches.length > 0) return prefixMatches;
     }
     const queryTermsRaw = queryLower.split(/\s+/).filter((t) => t.length > 0);
@@ -4070,9 +4078,10 @@ var ToolIndex = class _ToolIndex {
     const queryTokens = this.tokenize(allScoringTerms.join(" "));
     const candidateKeys = /* @__PURE__ */ new Set();
     for (const docKey of this.toolSummaries.keys()) {
+      const summary = this.toolSummaries.get(docKey);
+      if (!this.matchesServer(summary, options)) continue;
       if (requiredTerms.length > 0) {
         const text = this.searchTexts.get(docKey) || "";
-        const summary = this.toolSummaries.get(docKey);
         const nameLower = summary.name.toLowerCase();
         const matchesAll = requiredTerms.every(
           (term) => text.includes(term) || nameLower.includes(term)
@@ -4183,17 +4192,66 @@ var ToolIndex = class _ToolIndex {
   // -----------------------------------------------------------------------
   /**
    * Get tool definition(s) by name.
-   * If namespace is provided, it tries to match sessionId or serverName.
+   * If namespace is provided, exact sessionId/serverId matches take precedence.
+   * Falls back to serverName fragment matching only when explicitly allowed.
    */
-  getTool(name, namespace) {
+  getTool(name, namespace, options = {}) {
     const list = this.tools.get(name) ?? [];
     if (!namespace) return list;
-    return list.filter((t) => t.sessionId === namespace || t.serverId === namespace);
+    const exactMatches = list.filter(
+      (t) => t.sessionId === namespace || t.serverId === namespace
+    );
+    if (exactMatches.length > 0) return exactMatches;
+    if (!options.allowServerNameFragment) return [];
+    const namespaceLower = namespace.toLowerCase();
+    return list.filter((t) => t.serverName.toLowerCase().includes(namespaceLower));
   }
   /** All indexed tool names. */
   getToolNames() {
     return [...this.tools.keys()];
   }
+  /** List indexed servers with tool counts. */
+  listServers(options = {}) {
+    const servers = /* @__PURE__ */ new Map();
+    for (const summary of this.toolSummaries.values()) {
+      if (!this.matchesServer(summary, options)) continue;
+      const key = `${summary.sessionId}::${summary.serverId}`;
+      const existing = servers.get(key);
+      if (existing) {
+        existing.toolCount += 1;
+      } else {
+        servers.set(key, {
+          serverName: summary.serverName,
+          serverId: summary.serverId,
+          sessionId: summary.sessionId,
+          toolCount: 1
+        });
+      }
+    }
+    return [...servers.values()].sort((a, b) => {
+      const byName = a.serverName.localeCompare(b.serverName);
+      return byName !== 0 ? byName : a.serverId.localeCompare(b.serverId);
+    });
+  }
+  /** List tools deterministically, optionally scoped to a server. */
+  listTools(options = {}) {
+    const offset = Math.max(Number(options.cursor) || 0, 0);
+    const limit = Math.max(Number(options.limit) || 20, 1);
+    const tools = [...this.toolSummaries.values()].filter((summary) => this.matchesServer(summary, options)).sort((a, b) => {
+      const byServer = a.serverName.localeCompare(b.serverName);
+      if (byServer !== 0) return byServer;
+      return a.name.localeCompare(b.name);
+    });
+    const page = tools.slice(offset, offset + limit);
+    const nextOffset = offset + page.length;
+    return {
+      tools: page,
+      totalCount: tools.length,
+      returnedCount: page.length,
+      nextCursor: nextOffset < tools.length ? String(nextOffset) : void 0,
+      servers: this.listServers(options)
+    };
+  }
   /** Number of indexed tools (including duplicates). */
   get size() {
     let count = 0;
@@ -4250,6 +4308,20 @@ var ToolIndex = class _ToolIndex {
   getDocumentKey(tool) {
     return `${tool.sessionId}::${tool.serverId}::${tool.name}`;
   }
+  matchesServer(summary, options) {
+    if (options.serverId && summary.serverId !== options.serverId) {
+      return false;
+    }
+    if (options.serverName) {
+      const serverNameQuery = options.serverName.toLowerCase();
+      const serverName = summary.serverName.toLowerCase();
+      const serverId = summary.serverId.toLowerCase();
+      if (!serverName.includes(serverNameQuery) && !serverId.includes(serverNameQuery)) {
+        return false;
+      }
+    }
+    return true;
+  }
   /** Simple whitespace + camelCase + snake_case tokenizer. */
   tokenize(text) {
     return text.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/[_-]/g, " ").replace(/[^a-z0-9\s]/g, "").split(/\s+/).filter((t) => t.length > 1);
@@ -4335,7 +4407,7 @@ var SchemaCompressor = class _SchemaCompressor {
 init_cjs_shims();
 function createSearchToolDefinition() {
   return {
-    name: "mcp_search_tool_bm25",
+    name: "mcp_search_tools",
     description: 'Search the catalog of available tools. Returns tool names, descriptions, and server info. Use this FIRST to find relevant tools before calling them.\n\nQuery forms:\n- "select:Read,Edit,Grep" \u2014 fetch these exact tools by name\n- "notebook jupyter" \u2014 keyword search, up to limit best matches\n- "+slack send" \u2014 require "slack" in the name, rank by remaining terms',
     inputSchema: {
       type: "object",
@@ -4344,15 +4416,47 @@ function createSearchToolDefinition() {
           type: "string",
           description: 'Query to find tools. Use "select:<tool_name>" for direct selection, or keywords to search. Prefix keywords with + to require them.'
         },
+        operation: {
+          type: "string",
+          enum: ["search", "list"],
+          description: 'Operation to perform. Use "search" to find relevant tools by capability. Use "list" with serverId or serverName when the user asks for every tool from a connected MCP server.'
+        },
+        serverId: {
+          type: "string",
+          description: "Optional server ID to restrict search/list results to one MCP server."
+        },
+        serverName: {
+          type: "string",
+          description: 'Optional server name fragment to restrict search/list results to matching MCP servers, e.g. "supabase".'
+        },
         limit: {
           type: "number",
-          description: "Maximum number of results to return (default: 5, max: 20)."
+          description: "Maximum number of results to return (default: 5 for search, 20 for list; max: 20 for search, 100 for list)."
+        },
+        cursor: {
+          type: "string",
+          description: 'Optional pagination cursor returned by operation "list".'
         }
       },
       required: ["query"]
     }
   };
 }
+function createListServersToolDefinition() {
+  return {
+    name: "mcp_list_servers",
+    description: "List connected MCP servers and their tool counts. Use this when mcp_search_tools returns no matches, then retry mcp_search_tools with serverId or serverName.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: {
+          type: "string",
+          description: 'Optional server filter text. Matches server name or serverId, e.g. "web" or "supabase".'
+        }
+      }
+    }
+  };
+}
 function createRegexSearchToolDefinition() {
   return {
     name: "mcp_search_tool_regex",
@@ -4376,17 +4480,17 @@ 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_tool_bm25 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) 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.",
     inputSchema: {
       type: "object",
       properties: {
         toolName: {
           type: "string",
-          description: "The exact tool name returned by mcp_search_tool_bm25."
+          description: "The exact tool name returned by mcp_search_tools."
         },
         serverId: {
           type: "string",
-          description: "Optional: The server ID provided in mcp_search_tool_bm25. Required if multiple tools have the same name."
+          description: "Optional: The server ID provided in mcp_search_tools. Required if multiple tools have the same name."
         }
       },
       required: ["toolName"]
@@ -4396,17 +4500,17 @@ function createGetSchemaToolDefinition() {
 function createExecuteToolDefinition() {
   return {
     name: "mcp_execute_tool",
-    description: "Execute a tool that was discovered via mcp_search_tool_bm25. You MUST call mcp_get_tool_schema first to know the correct parameters. Pass the exact tool name and its arguments.",
+    description: "Execute a tool that was discovered via mcp_search_tools. You MUST call mcp_get_tool_schema first to know the correct parameters. Pass the exact tool name and its arguments.",
     inputSchema: {
       type: "object",
       properties: {
         toolName: {
           type: "string",
-          description: "The exact tool name from mcp_search_tool_bm25 results."
+          description: "The exact tool name from mcp_search_tools results."
         },
         serverId: {
           type: "string",
-          description: "Optional: The server ID provided in mcp_search_tool_bm25. Required if multiple tools have the same name."
+          description: "Optional: The server ID provided in mcp_search_tools. Required if multiple tools have the same name."
         },
         args: {
           type: "object",
@@ -4419,9 +4523,9 @@ function createExecuteToolDefinition() {
   };
 }
 async function executeMetaTool(toolName, args, router, callToolFn) {
-  const resolveToolSchema = (name, namespace) => {
+  const resolveToolSchema = (name, namespace, options) => {
     try {
-      return { tool: router.getToolSchema(name, namespace) };
+      return { tool: router.getToolSchema(name, namespace, options) };
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : String(err);
       return {
@@ -4433,23 +4537,61 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
     }
   };
   switch (toolName) {
-    case "mcp_search_tool_bm25": {
+    case "mcp_search_tools": {
       const query = String(args.query ?? "");
+      const operation = String(args.operation ?? "search");
+      const serverId = String(args.serverId ?? "") || void 0;
+      const serverName = String(args.serverName ?? "") || void 0;
+      if (operation === "list") {
+        const limit2 = Math.min(Number(args.limit) || 20, 100);
+        const cursor = String(args.cursor ?? "") || void 0;
+        const result = await router.listTools({
+          serverId,
+          serverName: serverName ?? (!serverId && query ? query : void 0),
+          limit: limit2,
+          cursor
+        });
+        const serverText = result.servers.length > 0 ? result.servers.map((server) => `${server.serverName} (serverId: ${server.serverId}, tools: ${server.toolCount})`).join(", ") : "none";
+        const lines = [
+          "operation: list",
+          `servers: ${serverText}`,
+          `totalCount: ${result.totalCount}`,
+          `returnedCount: ${result.returnedCount}`,
+          `nextCursor: ${result.nextCursor ?? "null"}`,
+          ""
+        ];
+        if (result.tools.length > 0) {
+          lines.push(...formatToolSummaries(result.tools));
+        } else {
+          lines.push(
+            serverId || serverName ? "No tools found for the requested server scope." : 'No tools found. Try operation "search" or provide serverId/serverName.'
+          );
+        }
+        return {
+          content: [{ type: "text", text: lines.join("\n") }],
+          isError: false
+        };
+      }
       const limit = Math.min(Number(args.limit) || 5, 20);
+      const searchOptions = { serverId, serverName };
       const selectMatch = query.match(/^select:(.+)$/i);
       if (selectMatch) {
+        await router.listTools({ serverId, serverName, limit: 1 });
         const requested = selectMatch[1].split(",").map((s) => s.trim()).filter(Boolean);
         const found = [];
         const errors = [];
+        const namespace = serverId ?? serverName;
         for (const requestedToolName of requested) {
-          const { tool, error } = resolveToolSchema(requestedToolName);
+          const { tool, error } = resolveToolSchema(requestedToolName, namespace, {
+            allowServerNameFragment: Boolean(serverName && !serverId)
+          });
           if (error) {
             const errorMsg = error.content[0]?.type === "text" ? error.content[0].text : "Unknown error";
             errors.push(`- **${requestedToolName}**: ${errorMsg}`);
           } else if (tool) {
             found.push(tool);
           } else {
-            errors.push(`- **${requestedToolName}**: Tool not found. Try searching with mcp_search_tool_bm25.`);
+            errors.push(`- **${requestedToolName}**: Tool not found. Try searching with mcp_search_tools.`);
           }
         }
         const lines = [];
@@ -4470,11 +4612,21 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
           isError: found.length === 0
         };
       }
-      const results = await router.searchTools(query, limit);
-      const text = results.length === 0 ? "No tools found matching your query. Try different keywords." : results.map(
-        (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
-   ${t.description}
-   Estimated tokens: ${t.estimatedTokens}`
+      const results = await router.searchTools(query, limit, searchOptions);
+      const text = results.length === 0 ? "No tools found matching your query. Call mcp_list_servers to inspect connected servers, then retry mcp_search_tools with serverId or serverName." : formatToolSummaries(results).join("\n");
+      return {
+        content: [{ type: "text", text }],
+        isError: false
+      };
+    }
+    case "mcp_list_servers": {
+      const query = String(args.query ?? "").trim();
+      const servers = await router.listServers({
+        serverName: query || void 0
+      });
+      const text = servers.length === 0 ? "No connected servers found." : servers.map(
+        (server, i) => `${i + 1}. **${server.serverName}** (serverId: ${server.serverId}, sessionId: ${server.sessionId})
+   Tool count: ${server.toolCount}`
       ).join("\n");
       return {
         content: [{ type: "text", text }],
@@ -4485,11 +4637,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
       const pattern = String(args.query ?? "");
       const limit = Math.min(Number(args.limit) || 5, 20);
       const results = await router.searchToolsRegex(pattern, limit);
-      const text = results.length === 0 ? "No tools matched your regex pattern. Try a broader pattern." : results.map(
-        (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
-   ${t.description}
-   Estimated tokens: ${t.estimatedTokens}`
-      ).join("\n");
+      const text = results.length === 0 ? "No tools matched your regex pattern. Try a broader pattern." : formatToolSummaries(results).join("\n");
       return {
         content: [{ type: "text", text }],
         isError: false
@@ -4507,7 +4655,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
           content: [
             {
               type: "text",
-              text: `Tool "${name}" not found. Use mcp_search_tool_bm25 to find available tools first.`
+              text: `Tool "${name}" not found. Use mcp_search_tools to find available tools first.`
             }
           ],
           isError: true
@@ -4548,7 +4696,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
           content: [
             {
               type: "text",
-              text: `Tool "${targetToolName}" not found. Use mcp_search_tool_bm25 to discover available tools first.`
+              text: `Tool "${targetToolName}" not found. Use mcp_search_tools to discover available tools first.`
             }
           ],
           isError: true
@@ -4582,8 +4730,15 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
       return null;
   }
 }
+function formatToolSummaries(tools) {
+  return tools.map(
+    (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
+   ${t.description}
+   Estimated tokens: ${t.estimatedTokens}`
+  );
+}
 function isMetaTool(toolName) {
-  return toolName === "mcp_search_tool_bm25" || toolName === "mcp_search_tool_regex" || toolName === "mcp_get_tool_schema" || toolName === "mcp_execute_tool";
+  return toolName === "mcp_search_tools" || toolName === "mcp_list_servers" || toolName === "mcp_search_tool_regex" || toolName === "mcp_get_tool_schema" || toolName === "mcp_execute_tool";
 }
 function resolveMetaToolProxy(toolName, args) {
   if (toolName === "mcp_execute_tool") {
@@ -4631,7 +4786,7 @@ var ToolRouter = class {
    * This is the main method adapters should call.
    *
    * - `all`    → returns all tools (unchanged behavior)
-   * - `search` → returns only meta-tools (mcp_search_tool_bm25, mcp_get_tool_schema, mcp_execute_tool)
+   * - `search` → returns only meta-tools (mcp_search_tools, mcp_get_tool_schema, mcp_execute_tool)
    * - `groups` → returns tools from active groups only
    */
   async getFilteredTools() {
@@ -4660,9 +4815,10 @@ var ToolRouter = class {
    * Search tools by natural-language query.
    * Works regardless of strategy.
    */
-  async searchTools(query, topK) {
+  async searchTools(query, topK, options = {}) {
     await this.ensureInitialized();
-    return this.index.search(query, topK ?? this.maxTools);
+    const limit = topK ?? this.maxTools;
+    return this.index.search(query, limit, options);
   }
   /**
    * Search tools by regex pattern.
@@ -4672,12 +4828,22 @@ var ToolRouter = class {
     await this.ensureInitialized();
     return this.index.searchRegex(pattern, topK ?? this.maxTools);
   }
+  /** List connected MCP servers with indexed tool counts. */
+  async listServers(options = {}) {
+    await this.ensureInitialized();
+    return this.index.listServers(options);
+  }
+  /** List tools deterministically, optionally scoped to a server. */
+  async listTools(options = {}) {
+    await this.ensureInitialized();
+    return this.index.listTools(options);
+  }
   /**
    * Get the full tool definition by name.
    * If tool name is ambiguous, use namespace to specify the server.
    */
-  getToolSchema(toolName, namespace) {
-    const matches = this.index.getTool(toolName, namespace);
+  getToolSchema(toolName, namespace, options = {}) {
+    const matches = this.index.getTool(toolName, namespace, options);
     if (matches.length === 0) return void 0;
     if (matches.length > 1) {
       const servers = matches.map((m) => m.serverId).join(", ");
@@ -4756,7 +4922,7 @@ var ToolRouter = class {
     const indexedTool = this.getToolSchema(toolName, namespace);
     if (!indexedTool) {
       throw new Error(
-        `Tool "${toolName}" not found${namespace ? ` on server "${namespace}"` : ""}. Use mcp_search_tool_bm25 or mcp_search_tool_regex to discover available tools.`
+        `Tool "${toolName}" not found${namespace ? ` on server "${namespace}"` : ""}. Use mcp_search_tools or mcp_search_tool_regex to discover available tools.`
       );
     }
     const clients = this.getClients();
@@ -4868,6 +5034,7 @@ var ToolRouter = class {
   getMetaToolDefinitions() {
     return [
       createSearchToolDefinition(),
+      createListServersToolDefinition(),
       createRegexSearchToolDefinition(),
       createGetSchemaToolDefinition(),
       createExecuteToolDefinition()
@@ -4916,6 +5083,7 @@ exports.ToolRouter = ToolRouter;
 exports.UnauthorizedError = UnauthorizedError;
 exports.createExecuteToolDefinition = createExecuteToolDefinition;
 exports.createGetSchemaToolDefinition = createGetSchemaToolDefinition;
+exports.createListServersToolDefinition = createListServersToolDefinition;
 exports.createNextMcpHandler = createNextMcpHandler;
 exports.createRegexSearchToolDefinition = createRegexSearchToolDefinition;
 exports.createSSEHandler = createSSEHandler;