mcp-use 1.10.0-canary.6 → 1.10.0-canary.8

package/dist/src/server/index.cjs

@@ -55,48 +55,48 @@ var init_runtime = __esm({
     __name(getEnv, "getEnv");
     __name(getCwd, "getCwd");
     fsHelpers = {
-      async readFileSync(path, encoding = "utf8") {
+      async readFileSync(path2, encoding = "utf8") {
         if (isDeno) {
-          return await globalThis.Deno.readTextFile(path);
+          return await globalThis.Deno.readTextFile(path2);
         }
-        const { readFileSync } = await import("fs");
-        const result = readFileSync(path, encoding);
+        const { readFileSync: readFileSync2 } = await import("fs");
+        const result = readFileSync2(path2, encoding);
         return typeof result === "string" ? result : result.toString(encoding);
       },
-      async readFile(path) {
+      async readFile(path2) {
         if (isDeno) {
-          const data = await globalThis.Deno.readFile(path);
+          const data = await globalThis.Deno.readFile(path2);
           return data.buffer;
         }
-        const { readFileSync } = await import("fs");
-        const buffer = readFileSync(path);
+        const { readFileSync: readFileSync2 } = await import("fs");
+        const buffer = readFileSync2(path2);
         return buffer.buffer.slice(
           buffer.byteOffset,
           buffer.byteOffset + buffer.byteLength
         );
       },
-      async existsSync(path) {
+      async existsSync(path2) {
         if (isDeno) {
           try {
-            await globalThis.Deno.stat(path);
+            await globalThis.Deno.stat(path2);
             return true;
           } catch {
             return false;
           }
         }
-        const { existsSync } = await import("fs");
-        return existsSync(path);
+        const { existsSync: existsSync2 } = await import("fs");
+        return existsSync2(path2);
       },
-      async readdirSync(path) {
+      async readdirSync(path2) {
         if (isDeno) {
           const entries = [];
-          for await (const entry of globalThis.Deno.readDir(path)) {
+          for await (const entry of globalThis.Deno.readDir(path2)) {
             entries.push(entry.name);
           }
           return entries;
         }
         const { readdirSync } = await import("fs");
-        return readdirSync(path);
+        return readdirSync(path2);
       }
     };
     pathHelpers = {
@@ -122,6 +122,1121 @@ var init_runtime = __esm({
   }
 });
 
+// src/logging.ts
+async function getNodeModules() {
+  if (typeof process !== "undefined" && process.platform) {
+    try {
+      const fs2 = await import("fs");
+      const path2 = await import("path");
+      return { fs: fs2.default, path: path2.default };
+    } catch {
+      return { fs: null, path: null };
+    }
+  }
+  return { fs: null, path: null };
+}
+function loadWinstonSync() {
+  if (typeof require !== "undefined") {
+    try {
+      winston = require("winston");
+    } catch {
+    }
+  }
+}
+async function getWinston() {
+  if (!winston) {
+    winston = await import("winston");
+  }
+  return winston;
+}
+function isNodeJSEnvironment() {
+  try {
+    if (typeof navigator !== "undefined" && navigator.userAgent?.includes("Cloudflare-Workers")) {
+      return false;
+    }
+    if (typeof globalThis.EdgeRuntime !== "undefined" || typeof globalThis.Deno !== "undefined") {
+      return false;
+    }
+    const hasNodeGlobals = typeof process !== "undefined" && typeof process.platform !== "undefined" && typeof __dirname !== "undefined";
+    return hasNodeGlobals;
+  } catch {
+    return false;
+  }
+}
+function resolveLevel(env) {
+  const envValue = typeof process !== "undefined" && process.env ? env : void 0;
+  switch (envValue?.trim()) {
+    case "2":
+      return "debug";
+    case "1":
+      return "info";
+    default:
+      return "info";
+  }
+}
+var winston, DEFAULT_LOGGER_NAME, SimpleConsoleLogger, Logger, logger;
+var init_logging = __esm({
+  "src/logging.ts"() {
+    "use strict";
+    __name(getNodeModules, "getNodeModules");
+    winston = null;
+    __name(loadWinstonSync, "loadWinstonSync");
+    __name(getWinston, "getWinston");
+    DEFAULT_LOGGER_NAME = "mcp-use";
+    __name(isNodeJSEnvironment, "isNodeJSEnvironment");
+    SimpleConsoleLogger = class {
+      static {
+        __name(this, "SimpleConsoleLogger");
+      }
+      _level;
+      name;
+      constructor(name = DEFAULT_LOGGER_NAME, level = "info") {
+        this.name = name;
+        this._level = level;
+      }
+      shouldLog(level) {
+        const levels = [
+          "error",
+          "warn",
+          "info",
+          "http",
+          "verbose",
+          "debug",
+          "silly"
+        ];
+        const currentIndex = levels.indexOf(this._level);
+        const messageIndex = levels.indexOf(level);
+        return messageIndex <= currentIndex;
+      }
+      formatMessage(level, message) {
+        const timestamp = (/* @__PURE__ */ new Date()).toLocaleTimeString("en-US", { hour12: false });
+        return `${timestamp} [${this.name}] ${level}: ${message}`;
+      }
+      error(message) {
+        if (this.shouldLog("error")) {
+          console.error(this.formatMessage("error", message));
+        }
+      }
+      warn(message) {
+        if (this.shouldLog("warn")) {
+          console.warn(this.formatMessage("warn", message));
+        }
+      }
+      info(message) {
+        if (this.shouldLog("info")) {
+          console.info(this.formatMessage("info", message));
+        }
+      }
+      debug(message) {
+        if (this.shouldLog("debug")) {
+          console.debug(this.formatMessage("debug", message));
+        }
+      }
+      http(message) {
+        if (this.shouldLog("http")) {
+          console.log(this.formatMessage("http", message));
+        }
+      }
+      verbose(message) {
+        if (this.shouldLog("verbose")) {
+          console.log(this.formatMessage("verbose", message));
+        }
+      }
+      silly(message) {
+        if (this.shouldLog("silly")) {
+          console.log(this.formatMessage("silly", message));
+        }
+      }
+      // Make it compatible with Winston interface
+      get level() {
+        return this._level;
+      }
+      set level(newLevel) {
+        this._level = newLevel;
+      }
+    };
+    __name(resolveLevel, "resolveLevel");
+    Logger = class {
+      static {
+        __name(this, "Logger");
+      }
+      static instances = {};
+      static simpleInstances = {};
+      static currentFormat = "minimal";
+      static get(name = DEFAULT_LOGGER_NAME) {
+        if (!isNodeJSEnvironment()) {
+          if (!this.simpleInstances[name]) {
+            const debugEnv = typeof process !== "undefined" && process.env?.DEBUG || void 0;
+            this.simpleInstances[name] = new SimpleConsoleLogger(
+              name,
+              resolveLevel(debugEnv)
+            );
+          }
+          return this.simpleInstances[name];
+        }
+        if (!this.instances[name]) {
+          if (!winston) {
+            throw new Error("Winston not loaded - call Logger.configure() first");
+          }
+          const { createLogger, format } = winston;
+          const { combine, timestamp, label, colorize, splat } = format;
+          this.instances[name] = createLogger({
+            level: resolveLevel(process.env.DEBUG),
+            format: combine(
+              colorize(),
+              splat(),
+              label({ label: name }),
+              timestamp({ format: "HH:mm:ss" }),
+              this.getFormatter()
+            ),
+            transports: []
+          });
+        }
+        return this.instances[name];
+      }
+      static getFormatter() {
+        if (!winston) {
+          throw new Error("Winston not loaded");
+        }
+        const { format } = winston;
+        const { printf } = format;
+        const minimalFormatter = printf(({ level, message, label, timestamp }) => {
+          return `${timestamp} [${label}] ${level}: ${message}`;
+        });
+        const detailedFormatter = printf(({ level, message, label, timestamp }) => {
+          return `${timestamp} [${label}] ${level.toUpperCase()}: ${message}`;
+        });
+        const emojiFormatter = printf(({ level, message, label, timestamp }) => {
+          return `${timestamp} [${label}] ${level.toUpperCase()}: ${message}`;
+        });
+        switch (this.currentFormat) {
+          case "minimal":
+            return minimalFormatter;
+          case "detailed":
+            return detailedFormatter;
+          case "emoji":
+            return emojiFormatter;
+          default:
+            return minimalFormatter;
+        }
+      }
+      static async configure(options = {}) {
+        const { level, console: console2 = true, file, format = "minimal" } = options;
+        const debugEnv = typeof process !== "undefined" && process.env?.DEBUG || void 0;
+        const resolvedLevel = level ?? resolveLevel(debugEnv);
+        this.currentFormat = format;
+        if (!isNodeJSEnvironment()) {
+          Object.values(this.simpleInstances).forEach((logger2) => {
+            logger2.level = resolvedLevel;
+          });
+          return;
+        }
+        await getWinston();
+        if (!winston) {
+          throw new Error("Failed to load winston");
+        }
+        const root = this.get();
+        root.level = resolvedLevel;
+        const winstonRoot = root;
+        winstonRoot.clear();
+        if (console2) {
+          winstonRoot.add(new winston.transports.Console());
+        }
+        if (file) {
+          const { fs: nodeFs, path: nodePath } = await getNodeModules();
+          if (nodeFs && nodePath) {
+            const dir = nodePath.dirname(nodePath.resolve(file));
+            if (!nodeFs.existsSync(dir)) {
+              nodeFs.mkdirSync(dir, { recursive: true });
+            }
+            winstonRoot.add(new winston.transports.File({ filename: file }));
+          }
+        }
+        const { format: winstonFormat } = winston;
+        const { combine, timestamp, label, colorize, splat } = winstonFormat;
+        Object.values(this.instances).forEach((logger2) => {
+          if (logger2 && "format" in logger2) {
+            logger2.level = resolvedLevel;
+            logger2.format = combine(
+              colorize(),
+              splat(),
+              label({ label: DEFAULT_LOGGER_NAME }),
+              timestamp({ format: "HH:mm:ss" }),
+              this.getFormatter()
+            );
+          }
+        });
+      }
+      static setDebug(enabled) {
+        let level;
+        if (enabled === 2 || enabled === true) level = "debug";
+        else if (enabled === 1) level = "info";
+        else level = "info";
+        Object.values(this.simpleInstances).forEach((logger2) => {
+          logger2.level = level;
+        });
+        Object.values(this.instances).forEach((logger2) => {
+          if (logger2) {
+            logger2.level = level;
+          }
+        });
+        if (typeof process !== "undefined" && process.env) {
+          process.env.DEBUG = enabled ? enabled === true ? "2" : String(enabled) : "0";
+        }
+      }
+      static setFormat(format) {
+        this.currentFormat = format;
+        this.configure({ format });
+      }
+    };
+    if (isNodeJSEnvironment()) {
+      loadWinstonSync();
+      if (winston) {
+        Logger.configure();
+      }
+    }
+    logger = Logger.get();
+  }
+});
+
+// src/telemetry/events.ts
+function createServerRunEventData(server, transport) {
+  const toolRegistrations = Array.from(server.registrations.tools.values());
+  const promptRegistrations = Array.from(server.registrations.prompts.values());
+  const resourceRegistrations = Array.from(
+    server.registrations.resources.values()
+  );
+  const templateRegistrations = Array.from(
+    server.registrations.resourceTemplates.values()
+  );
+  const allResources = resourceRegistrations.map((r) => ({
+    name: r.config.name,
+    title: r.config.title ?? null,
+    description: r.config.description ?? null,
+    uri: r.config.uri ?? null,
+    mime_type: r.config.mimeType ?? null
+  }));
+  const appsSdkResources = allResources.filter(
+    (r) => r.mime_type === "text/html+skybridge"
+  );
+  const mcpUiResources = allResources.filter(
+    (r) => r.mime_type === "text/uri-list" || r.mime_type === "text/html"
+  );
+  const mcpAppsResources = allResources.filter(
+    (r) => r.mime_type === "text/html+mcp"
+  );
+  return {
+    transport,
+    toolsNumber: server.registeredTools.length,
+    resourcesNumber: server.registeredResources.length,
+    promptsNumber: server.registeredPrompts.length,
+    auth: !!server.oauthProvider,
+    name: server.config.name,
+    description: server.config.description ?? null,
+    baseUrl: server.serverBaseUrl ?? null,
+    toolNames: server.registeredTools.length > 0 ? server.registeredTools : null,
+    resourceNames: server.registeredResources.length > 0 ? server.registeredResources : null,
+    promptNames: server.registeredPrompts.length > 0 ? server.registeredPrompts : null,
+    tools: toolRegistrations.length > 0 ? toolRegistrations.map((r) => ({
+      name: r.config.name,
+      title: r.config.title ?? null,
+      description: r.config.description ?? null,
+      input_schema: r.config.schema ? JSON.stringify(r.config.schema) : null,
+      output_schema: r.config.outputSchema ? JSON.stringify(r.config.outputSchema) : null
+    })) : null,
+    resources: allResources.length > 0 ? allResources : null,
+    prompts: promptRegistrations.length > 0 ? promptRegistrations.map((r) => ({
+      name: r.config.name,
+      title: r.config.title ?? null,
+      description: r.config.description ?? null,
+      args: r.config.args ? JSON.stringify(r.config.args) : null
+    })) : null,
+    templates: templateRegistrations.length > 0 ? templateRegistrations.map((r) => ({
+      name: r.config.name,
+      title: r.config.title ?? null,
+      description: r.config.description ?? null
+    })) : null,
+    capabilities: {
+      logging: true,
+      resources: { subscribe: true, listChanged: true }
+    },
+    appsSdkResources: appsSdkResources.length > 0 ? appsSdkResources : null,
+    appsSdkResourcesNumber: appsSdkResources.length,
+    mcpUiResources: mcpUiResources.length > 0 ? mcpUiResources : null,
+    mcpUiResourcesNumber: mcpUiResources.length,
+    mcpAppsResources: mcpAppsResources.length > 0 ? mcpAppsResources : null,
+    mcpAppsResourcesNumber: mcpAppsResources.length
+  };
+}
+var BaseTelemetryEvent, MCPAgentExecutionEvent, ServerRunEvent, ServerInitializeEvent, ServerToolCallEvent, ServerResourceCallEvent, ServerPromptCallEvent, ServerContextEvent, MCPClientInitEvent, ConnectorInitEvent;
+var init_events = __esm({
+  "src/telemetry/events.ts"() {
+    "use strict";
+    BaseTelemetryEvent = class {
+      static {
+        __name(this, "BaseTelemetryEvent");
+      }
+    };
+    MCPAgentExecutionEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "MCPAgentExecutionEvent");
+      }
+      get name() {
+        return "mcp_agent_execution";
+      }
+      get properties() {
+        return {
+          // Core execution info
+          execution_method: this.data.executionMethod,
+          query: this.data.query,
+          query_length: this.data.query.length,
+          success: this.data.success,
+          // Agent configuration
+          model_provider: this.data.modelProvider,
+          model_name: this.data.modelName,
+          server_count: this.data.serverCount,
+          server_identifiers: this.data.serverIdentifiers,
+          total_tools_available: this.data.totalToolsAvailable,
+          tools_available_names: this.data.toolsAvailableNames,
+          max_steps_configured: this.data.maxStepsConfigured,
+          memory_enabled: this.data.memoryEnabled,
+          use_server_manager: this.data.useServerManager,
+          // Execution parameters (always include, even if null)
+          max_steps_used: this.data.maxStepsUsed,
+          manage_connector: this.data.manageConnector,
+          external_history_used: this.data.externalHistoryUsed,
+          // Execution results (always include, even if null)
+          steps_taken: this.data.stepsTaken ?? null,
+          tools_used_count: this.data.toolsUsedCount ?? null,
+          tools_used_names: this.data.toolsUsedNames ?? null,
+          response: this.data.response ?? null,
+          response_length: this.data.response ? this.data.response.length : null,
+          execution_time_ms: this.data.executionTimeMs ?? null,
+          error_type: this.data.errorType ?? null,
+          conversation_history_length: this.data.conversationHistoryLength ?? null
+        };
+      }
+    };
+    __name(createServerRunEventData, "createServerRunEventData");
+    ServerRunEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ServerRunEvent");
+      }
+      get name() {
+        return "server_run";
+      }
+      get properties() {
+        return {
+          transport: this.data.transport,
+          tools_number: this.data.toolsNumber,
+          resources_number: this.data.resourcesNumber,
+          prompts_number: this.data.promptsNumber,
+          auth: this.data.auth,
+          name: this.data.name,
+          description: this.data.description ?? null,
+          base_url: this.data.baseUrl ?? null,
+          tool_names: this.data.toolNames ?? null,
+          resource_names: this.data.resourceNames ?? null,
+          prompt_names: this.data.promptNames ?? null,
+          tools: this.data.tools ?? null,
+          resources: this.data.resources ?? null,
+          prompts: this.data.prompts ?? null,
+          templates: this.data.templates ?? null,
+          capabilities: this.data.capabilities ? JSON.stringify(this.data.capabilities) : null,
+          apps_sdk_resources: this.data.appsSdkResources ? JSON.stringify(this.data.appsSdkResources) : null,
+          apps_sdk_resources_number: this.data.appsSdkResourcesNumber ?? 0,
+          mcp_ui_resources: this.data.mcpUiResources ? JSON.stringify(this.data.mcpUiResources) : null,
+          mcp_ui_resources_number: this.data.mcpUiResourcesNumber ?? 0,
+          mcp_apps_resources: this.data.mcpAppsResources ? JSON.stringify(this.data.mcpAppsResources) : null,
+          mcp_apps_resources_number: this.data.mcpAppsResourcesNumber ?? 0
+        };
+      }
+    };
+    ServerInitializeEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ServerInitializeEvent");
+      }
+      get name() {
+        return "server_initialize_call";
+      }
+      get properties() {
+        return {
+          protocol_version: this.data.protocolVersion,
+          client_info: JSON.stringify(this.data.clientInfo),
+          client_capabilities: JSON.stringify(this.data.clientCapabilities),
+          session_id: this.data.sessionId ?? null
+        };
+      }
+    };
+    ServerToolCallEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ServerToolCallEvent");
+      }
+      get name() {
+        return "server_tool_call";
+      }
+      get properties() {
+        return {
+          tool_name: this.data.toolName,
+          length_input_argument: this.data.lengthInputArgument,
+          success: this.data.success,
+          error_type: this.data.errorType ?? null,
+          execution_time_ms: this.data.executionTimeMs ?? null
+        };
+      }
+    };
+    ServerResourceCallEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ServerResourceCallEvent");
+      }
+      get name() {
+        return "server_resource_call";
+      }
+      get properties() {
+        return {
+          name: this.data.name,
+          description: this.data.description,
+          contents: this.data.contents,
+          success: this.data.success,
+          error_type: this.data.errorType ?? null
+        };
+      }
+    };
+    ServerPromptCallEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ServerPromptCallEvent");
+      }
+      get name() {
+        return "server_prompt_call";
+      }
+      get properties() {
+        return {
+          name: this.data.name,
+          description: this.data.description,
+          success: this.data.success,
+          error_type: this.data.errorType ?? null
+        };
+      }
+    };
+    ServerContextEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ServerContextEvent");
+      }
+      get name() {
+        return `server_context_${this.data.contextType}`;
+      }
+      get properties() {
+        return {
+          context_type: this.data.contextType,
+          notification_type: this.data.notificationType ?? null
+        };
+      }
+    };
+    MCPClientInitEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "MCPClientInitEvent");
+      }
+      get name() {
+        return "mcpclient_init";
+      }
+      get properties() {
+        return {
+          code_mode: this.data.codeMode,
+          sandbox: this.data.sandbox,
+          all_callbacks: this.data.allCallbacks,
+          verify: this.data.verify,
+          servers: this.data.servers,
+          num_servers: this.data.numServers
+        };
+      }
+    };
+    ConnectorInitEvent = class extends BaseTelemetryEvent {
+      constructor(data) {
+        super();
+        this.data = data;
+      }
+      static {
+        __name(this, "ConnectorInitEvent");
+      }
+      get name() {
+        return "connector_init";
+      }
+      get properties() {
+        return {
+          connector_type: this.data.connectorType,
+          server_command: this.data.serverCommand ?? null,
+          server_args: this.data.serverArgs ?? null,
+          server_url: this.data.serverUrl ?? null,
+          public_identifier: this.data.publicIdentifier ?? null
+        };
+      }
+    };
+  }
+});
+
+// src/version.ts
+function getPackageVersion() {
+  return VERSION;
+}
+var VERSION;
+var init_version = __esm({
+  "src/version.ts"() {
+    "use strict";
+    VERSION = "1.10.0-canary.8";
+    __name(getPackageVersion, "getPackageVersion");
+  }
+});
+
+// src/telemetry/utils.ts
+var init_utils = __esm({
+  "src/telemetry/utils.ts"() {
+    "use strict";
+    init_version();
+  }
+});
+
+// src/telemetry/telemetry.ts
+function detectRuntimeEnvironment() {
+  try {
+    if (typeof globalThis.Bun !== "undefined") {
+      return "bun";
+    }
+    if (typeof globalThis.Deno !== "undefined") {
+      return "deno";
+    }
+    if (typeof navigator !== "undefined" && navigator.userAgent?.includes("Cloudflare-Workers")) {
+      return "cloudflare-workers";
+    }
+    if (typeof globalThis.EdgeRuntime !== "undefined") {
+      return "edge";
+    }
+    if (typeof process !== "undefined" && typeof process.versions?.node !== "undefined" && typeof fs !== "undefined" && typeof fs.existsSync === "function") {
+      return "node";
+    }
+    if (typeof window !== "undefined" && typeof document !== "undefined") {
+      return "browser";
+    }
+    return "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+function getStorageCapability(env) {
+  switch (env) {
+    case "node":
+    case "bun":
+      return "filesystem";
+    case "browser":
+      try {
+        if (typeof localStorage !== "undefined") {
+          localStorage.setItem("__mcp_use_test__", "1");
+          localStorage.removeItem("__mcp_use_test__");
+          return "localStorage";
+        }
+      } catch {
+      }
+      return "session-only";
+    case "deno":
+      return "session-only";
+    default:
+      return "session-only";
+  }
+}
+function getRuntimeEnvironment() {
+  if (cachedEnvironment === null) {
+    cachedEnvironment = detectRuntimeEnvironment();
+  }
+  return cachedEnvironment;
+}
+function isNodeJSEnvironment2() {
+  const env = getRuntimeEnvironment();
+  return env === "node" || env === "bun";
+}
+function getCacheHome() {
+  if (!isNodeJSEnvironment2()) {
+    return "/tmp/mcp_use_cache";
+  }
+  const envVar = process.env.XDG_CACHE_HOME;
+  if (envVar && path.isAbsolute(envVar)) {
+    return envVar;
+  }
+  const platform = process.platform;
+  const homeDir = os.homedir();
+  if (platform === "win32") {
+    const appdata = process.env.LOCALAPPDATA || process.env.APPDATA;
+    if (appdata) {
+      return appdata;
+    }
+    return path.join(homeDir, "AppData", "Local");
+  } else if (platform === "darwin") {
+    return path.join(homeDir, "Library", "Caches");
+  } else {
+    return path.join(homeDir, ".cache");
+  }
+}
+var fs, os, path, import_posthog_node, USER_ID_STORAGE_KEY, cachedEnvironment, ScarfEventLogger, Telemetry;
+var init_telemetry = __esm({
+  "src/telemetry/telemetry.ts"() {
+    "use strict";
+    fs = __toESM(require("fs"), 1);
+    os = __toESM(require("os"), 1);
+    path = __toESM(require("path"), 1);
+    import_posthog_node = require("posthog-node");
+    init_runtime();
+    init_logging();
+    init_events();
+    init_utils();
+    USER_ID_STORAGE_KEY = "mcp_use_user_id";
+    __name(detectRuntimeEnvironment, "detectRuntimeEnvironment");
+    __name(getStorageCapability, "getStorageCapability");
+    cachedEnvironment = null;
+    __name(getRuntimeEnvironment, "getRuntimeEnvironment");
+    __name(isNodeJSEnvironment2, "isNodeJSEnvironment");
+    ScarfEventLogger = class {
+      static {
+        __name(this, "ScarfEventLogger");
+      }
+      endpoint;
+      timeout;
+      constructor(endpoint, timeout = 3e3) {
+        this.endpoint = endpoint;
+        this.timeout = timeout;
+      }
+      async logEvent(properties) {
+        try {
+          const controller = new AbortController();
+          const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+          const response = await fetch(this.endpoint, {
+            method: "POST",
+            headers: {
+              "Content-Type": "application/json"
+            },
+            body: JSON.stringify(properties),
+            signal: controller.signal
+          });
+          clearTimeout(timeoutId);
+          if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+          }
+        } catch (error2) {
+          logger.debug(`Failed to send Scarf event: ${error2}`);
+        }
+      }
+    };
+    __name(getCacheHome, "getCacheHome");
+    Telemetry = class _Telemetry {
+      static {
+        __name(this, "Telemetry");
+      }
+      static instance = null;
+      USER_ID_PATH = path.join(
+        getCacheHome(),
+        "mcp_use_3",
+        "telemetry_user_id"
+      );
+      VERSION_DOWNLOAD_PATH = path.join(
+        getCacheHome(),
+        "mcp_use",
+        "download_version"
+      );
+      PROJECT_API_KEY = "phc_lyTtbYwvkdSbrcMQNPiKiiRWrrM1seyKIMjycSvItEI";
+      HOST = "https://eu.i.posthog.com";
+      SCARF_GATEWAY_URL = "https://mcpuse.gateway.scarf.sh/events-ts";
+      UNKNOWN_USER_ID = "UNKNOWN_USER_ID";
+      _currUserId = null;
+      _posthogClient = null;
+      _scarfClient = null;
+      _runtimeEnvironment;
+      _storageCapability;
+      _source;
+      constructor() {
+        this._runtimeEnvironment = getRuntimeEnvironment();
+        this._storageCapability = getStorageCapability(this._runtimeEnvironment);
+        this._source = typeof process !== "undefined" && process.env?.MCP_USE_TELEMETRY_SOURCE || this._runtimeEnvironment;
+        const telemetryDisabled = typeof process !== "undefined" && process.env?.MCP_USE_ANONYMIZED_TELEMETRY?.toLowerCase() === "false" || false;
+        const canSupportTelemetry = this._runtimeEnvironment !== "unknown";
+        const isServerlessEnvironment = [
+          "cloudflare-workers",
+          "edge",
+          "deno"
+        ].includes(this._runtimeEnvironment);
+        if (telemetryDisabled) {
+          this._posthogClient = null;
+          this._scarfClient = null;
+          logger.debug("Telemetry disabled via environment variable");
+        } else if (!canSupportTelemetry) {
+          this._posthogClient = null;
+          this._scarfClient = null;
+          logger.debug(
+            `Telemetry disabled - unknown environment: ${this._runtimeEnvironment}`
+          );
+        } else {
+          logger.info(
+            "Anonymized telemetry enabled. Set MCP_USE_ANONYMIZED_TELEMETRY=false to disable."
+          );
+          if (this._runtimeEnvironment !== "browser") {
+            try {
+              const posthogOptions = {
+                host: this.HOST,
+                disableGeoip: false
+              };
+              if (isServerlessEnvironment) {
+                posthogOptions.flushAt = 1;
+                posthogOptions.flushInterval = 0;
+              }
+              this._posthogClient = new import_posthog_node.PostHog(
+                this.PROJECT_API_KEY,
+                posthogOptions
+              );
+            } catch (e) {
+              logger.warn(`Failed to initialize PostHog telemetry: ${e}`);
+              this._posthogClient = null;
+            }
+          } else {
+            this._posthogClient = null;
+          }
+          try {
+            this._scarfClient = new ScarfEventLogger(this.SCARF_GATEWAY_URL, 3e3);
+          } catch (e) {
+            logger.warn(`Failed to initialize Scarf telemetry: ${e}`);
+            this._scarfClient = null;
+          }
+        }
+      }
+      /**
+       * Get the detected runtime environment
+       */
+      get runtimeEnvironment() {
+        return this._runtimeEnvironment;
+      }
+      /**
+       * Get the storage capability for this environment
+       */
+      get storageCapability() {
+        return this._storageCapability;
+      }
+      static getInstance() {
+        if (!_Telemetry.instance) {
+          _Telemetry.instance = new _Telemetry();
+        }
+        return _Telemetry.instance;
+      }
+      /**
+       * Set the source identifier for telemetry events.
+       * This allows tracking usage from different applications.
+       * @param source - The source identifier (e.g., "my-app", "cli", "vs-code-extension")
+       */
+      setSource(source) {
+        this._source = source;
+        logger.debug(`Telemetry source set to: ${source}`);
+      }
+      /**
+       * Get the current source identifier.
+       */
+      getSource() {
+        return this._source;
+      }
+      /**
+       * Check if telemetry is enabled.
+       * Returns false if telemetry was disabled via environment variable or if not in Node.js environment.
+       */
+      get isEnabled() {
+        return this._posthogClient !== null || this._scarfClient !== null;
+      }
+      get userId() {
+        if (this._currUserId) {
+          return this._currUserId;
+        }
+        try {
+          switch (this._storageCapability) {
+            case "filesystem":
+              this._currUserId = this.getUserIdFromFilesystem();
+              break;
+            case "localStorage":
+              this._currUserId = this.getUserIdFromLocalStorage();
+              break;
+            case "session-only":
+            default:
+              this._currUserId = `session-${generateUUID()}`;
+              logger.debug(
+                `Using session-based user ID (${this._runtimeEnvironment} environment)`
+              );
+              break;
+          }
+          if (this._storageCapability === "filesystem" && this._currUserId) {
+            this.trackPackageDownloadInternal(this._currUserId, {
+              triggered_by: "user_id_property"
+            }).catch((e) => logger.debug(`Failed to track package download: ${e}`));
+          }
+        } catch (e) {
+          logger.debug(`Failed to get/create user ID: ${e}`);
+          this._currUserId = this.UNKNOWN_USER_ID;
+        }
+        return this._currUserId;
+      }
+      /**
+       * Get or create user ID from filesystem (Node.js/Bun)
+       */
+      getUserIdFromFilesystem() {
+        const isFirstTime = !fs.existsSync(this.USER_ID_PATH);
+        if (isFirstTime) {
+          logger.debug(`Creating user ID path: ${this.USER_ID_PATH}`);
+          fs.mkdirSync(path.dirname(this.USER_ID_PATH), { recursive: true });
+          const newUserId = generateUUID();
+          fs.writeFileSync(this.USER_ID_PATH, newUserId);
+          logger.debug(`User ID path created: ${this.USER_ID_PATH}`);
+          return newUserId;
+        }
+        return fs.readFileSync(this.USER_ID_PATH, "utf-8").trim();
+      }
+      /**
+       * Get or create user ID from localStorage (Browser)
+       */
+      getUserIdFromLocalStorage() {
+        try {
+          let userId = localStorage.getItem(USER_ID_STORAGE_KEY);
+          if (!userId) {
+            userId = generateUUID();
+            localStorage.setItem(USER_ID_STORAGE_KEY, userId);
+            logger.debug(`Created new browser user ID`);
+          }
+          return userId;
+        } catch (e) {
+          logger.debug(`localStorage access failed: ${e}`);
+          return `session-${generateUUID()}`;
+        }
+      }
+      async capture(event) {
+        logger.debug(
+          `CAPTURE: posthog: ${this._posthogClient !== null}, scarf: ${this._scarfClient !== null}`
+        );
+        if (!this._posthogClient && !this._scarfClient) {
+          return;
+        }
+        if (this._posthogClient) {
+          try {
+            const properties = { ...event.properties };
+            properties.mcp_use_version = getPackageVersion();
+            properties.language = "typescript";
+            properties.source = this._source;
+            properties.runtime = this._runtimeEnvironment;
+            logger.debug(`CAPTURE: PostHog Event ${event.name}`);
+            logger.debug(
+              `CAPTURE: PostHog Properties ${JSON.stringify(properties)}`
+            );
+            this._posthogClient.capture({
+              distinctId: this.userId,
+              event: event.name,
+              properties
+            });
+          } catch (e) {
+            logger.debug(`Failed to track PostHog event ${event.name}: ${e}`);
+          }
+        }
+        if (this._scarfClient) {
+          try {
+            const properties = {};
+            properties.mcp_use_version = getPackageVersion();
+            properties.user_id = this.userId;
+            properties.event = event.name;
+            properties.language = "typescript";
+            properties.source = this._source;
+            properties.runtime = this._runtimeEnvironment;
+            await this._scarfClient.logEvent(properties);
+          } catch (e) {
+            logger.debug(`Failed to track Scarf event ${event.name}: ${e}`);
+          }
+        }
+      }
+      /**
+       * Track package download event.
+       * This is a public wrapper that safely accesses userId.
+       */
+      async trackPackageDownload(properties) {
+        return this.trackPackageDownloadInternal(this.userId, properties);
+      }
+      /**
+       * Internal method to track package download with explicit userId.
+       * This avoids circular dependency when called from the userId getter.
+       */
+      async trackPackageDownloadInternal(userId, properties) {
+        if (!this._scarfClient) {
+          return;
+        }
+        if (this._storageCapability !== "filesystem") {
+          return;
+        }
+        try {
+          const currentVersion = getPackageVersion();
+          let shouldTrack = false;
+          let firstDownload = false;
+          if (!fs.existsSync(this.VERSION_DOWNLOAD_PATH)) {
+            shouldTrack = true;
+            firstDownload = true;
+            fs.mkdirSync(path.dirname(this.VERSION_DOWNLOAD_PATH), {
+              recursive: true
+            });
+            fs.writeFileSync(this.VERSION_DOWNLOAD_PATH, currentVersion);
+          } else {
+            const savedVersion = fs.readFileSync(this.VERSION_DOWNLOAD_PATH, "utf-8").trim();
+            if (currentVersion > savedVersion) {
+              shouldTrack = true;
+              firstDownload = false;
+              fs.writeFileSync(this.VERSION_DOWNLOAD_PATH, currentVersion);
+            }
+          }
+          if (shouldTrack) {
+            logger.debug(
+              `Tracking package download event with properties: ${JSON.stringify(properties)}`
+            );
+            const eventProperties = { ...properties || {} };
+            eventProperties.mcp_use_version = currentVersion;
+            eventProperties.user_id = userId;
+            eventProperties.event = "package_download";
+            eventProperties.first_download = firstDownload;
+            eventProperties.language = "typescript";
+            eventProperties.source = this._source;
+            eventProperties.runtime = this._runtimeEnvironment;
+            await this._scarfClient.logEvent(eventProperties);
+          }
+        } catch (e) {
+          logger.debug(`Failed to track Scarf package_download event: ${e}`);
+        }
+      }
+      // ============================================================================
+      // Agent Events
+      // ============================================================================
+      async trackAgentExecution(data) {
+        if (!this.isEnabled) return;
+        const event = new MCPAgentExecutionEvent(data);
+        await this.capture(event);
+      }
+      // ============================================================================
+      // Server Events
+      // ============================================================================
+      /**
+       * Track server run event directly from an MCPServer instance.
+       * This extracts the necessary data from the server and creates the event.
+       * @param server - The MCPServer instance (or any object conforming to MCPServerTelemetryInfo)
+       * @param transport - The transport type (e.g., "http", "stdio", "supabase")
+       */
+      async trackServerRunFromServer(server, transport) {
+        if (!this.isEnabled) return;
+        const data = createServerRunEventData(server, transport);
+        const event = new ServerRunEvent(data);
+        await this.capture(event);
+      }
+      async trackServerInitialize(data) {
+        if (!this.isEnabled) return;
+        const event = new ServerInitializeEvent(data);
+        await this.capture(event);
+      }
+      async trackServerToolCall(data) {
+        if (!this.isEnabled) return;
+        const event = new ServerToolCallEvent(data);
+        await this.capture(event);
+      }
+      async trackServerResourceCall(data) {
+        if (!this.isEnabled) return;
+        const event = new ServerResourceCallEvent(data);
+        await this.capture(event);
+      }
+      async trackServerPromptCall(data) {
+        if (!this.isEnabled) return;
+        const event = new ServerPromptCallEvent(data);
+        await this.capture(event);
+      }
+      async trackServerContext(data) {
+        if (!this.isEnabled) return;
+        const event = new ServerContextEvent(data);
+        await this.capture(event);
+      }
+      // ============================================================================
+      // Client Events
+      // ============================================================================
+      async trackMCPClientInit(data) {
+        if (!this.isEnabled) return;
+        const event = new MCPClientInitEvent(data);
+        await this.capture(event);
+      }
+      async trackConnectorInit(data) {
+        if (!this.isEnabled) return;
+        const event = new ConnectorInitEvent(data);
+        await this.capture(event);
+      }
+      flush() {
+        if (this._posthogClient) {
+          try {
+            this._posthogClient.flush();
+            logger.debug("PostHog client telemetry queue flushed");
+          } catch (e) {
+            logger.debug(`Failed to flush PostHog client: ${e}`);
+          }
+        }
+        if (this._scarfClient) {
+          logger.debug("Scarf telemetry events sent immediately (no flush needed)");
+        }
+      }
+      shutdown() {
+        if (this._posthogClient) {
+          try {
+            this._posthogClient.shutdown();
+            logger.debug("PostHog client shutdown successfully");
+          } catch (e) {
+            logger.debug(`Error shutting down PostHog client: ${e}`);
+          }
+        }
+        if (this._scarfClient) {
+          logger.debug("Scarf telemetry client shutdown (no action needed)");
+        }
+      }
+    };
+  }
+});
+
+// src/telemetry/index.ts
+var init_telemetry2 = __esm({
+  "src/telemetry/index.ts"() {
+    "use strict";
+    init_telemetry();
+    init_events();
+    init_telemetry();
+    init_utils();
+  }
+});
+
 // src/server/context-storage.ts
 var context_storage_exports = {};
 __export(context_storage_exports, {
@@ -373,6 +1488,9 @@ function createSampleMethod(createMessage, progressToken, sendNotification2) {
         `Sampling timed out after ${timeout}ms`
       );
       console.log("[SAMPLING DEBUG] Got result:", result);
+      Telemetry.getInstance().trackServerContext({
+        contextType: "sample"
+      }).catch((e) => console.debug(`Failed to track sample context: ${e}`));
       return result;
     } catch (error2) {
       console.error("[SAMPLING DEBUG] Error during sampling:", error2);
@@ -395,6 +1513,9 @@ function createElicitMethod(elicitInput) {
     const { timeout } = options ?? {};
     const sdkTimeout = timeout && timeout !== Infinity ? timeout : 2147483647;
     const result = await elicitInput(sdkParams, { timeout: sdkTimeout });
+    Telemetry.getInstance().trackServerContext({
+      contextType: "elicit"
+    }).catch((e) => console.debug(`Failed to track elicit context: ${e}`));
     if (zodSchema && result.action === "accept" && result.data) {
       try {
         const validatedData = zodSchema.parse(result.data);
@@ -443,7 +1564,7 @@ function createLogMethod(sendNotification2, minLogLevel) {
   if (!sendNotification2) {
     return void 0;
   }
-  return async (level, message, logger) => {
+  return async (level, message, logger2) => {
     if (!shouldLogMessage(level, minLogLevel)) {
       return;
     }
@@ -452,9 +1573,15 @@ function createLogMethod(sendNotification2, minLogLevel) {
       params: {
         level,
         data: message,
-        logger: logger || "tool"
+        logger: logger2 || "tool"
       }
     });
+    Telemetry.getInstance().trackServerContext({
+      contextType: "notification",
+      notificationType: "message"
+    }).catch(
+      (e) => console.debug(`Failed to track notification context: ${e}`)
+    );
   };
 }
 function createClientCapabilityChecker(clientCapabilities) {
@@ -556,6 +1683,7 @@ var init_tool_execution_helpers = __esm({
     import_zod_json_schema_compat = require("@mcp-use/modelcontextprotocol-sdk/server/zod-json-schema-compat.js");
     init_errors();
     init_runtime();
+    init_telemetry2();
     __name(findSessionContext, "findSessionContext");
     __name(sendProgressNotification, "sendProgressNotification");
     __name(withTimeout, "withTimeout");
@@ -787,6 +1915,7 @@ var init_conversion2 = __esm({
 var server_exports = {};
 __export(server_exports, {
   MCPServer: () => MCPServer,
+  VERSION: () => VERSION,
   adaptConnectMiddleware: () => adaptConnectMiddleware,
   adaptMiddleware: () => adaptMiddleware,
   array: () => array,
@@ -801,6 +1930,7 @@ __export(server_exports, {
   css: () => css,
   error: () => error,
   getAuth: () => getAuth,
+  getPackageVersion: () => getPackageVersion,
   getRequestContext: () => getRequestContext,
   hasAnyScope: () => hasAnyScope,
   hasRequestContext: () => hasRequestContext,
@@ -831,6 +1961,8 @@ module.exports = __toCommonJS(server_exports);
 var import_mcp2 = require("@mcp-use/modelcontextprotocol-sdk/server/mcp.js");
 var import_types2 = require("@mcp-use/modelcontextprotocol-sdk/types.js");
 var import_zod2 = require("zod");
+init_telemetry2();
+init_version();
 
 // src/server/widgets/index.ts
 init_runtime();
@@ -1497,11 +2629,11 @@ function createHonoProxy(target, app) {
       if (prop === "use") {
         return async (...args) => {
           const hasPath = typeof args[0] === "string";
-          const path = hasPath ? args[0] : "*";
+          const path2 = hasPath ? args[0] : "*";
           const handlers = hasPath ? args.slice(1) : args;
           const adaptedHandlers = handlers.map((handler) => {
             if (isExpressMiddleware(handler)) {
-              return { __isExpressMiddleware: true, handler, path };
+              return { __isExpressMiddleware: true, handler, path: path2 };
             }
             return handler;
           });
@@ -1517,13 +2649,13 @@ function createHonoProxy(target, app) {
                     h.path
                   );
                   if (hasPath) {
-                    app.use(path, adapted);
+                    app.use(path2, adapted);
                   } else {
                     app.use(adapted);
                   }
                 } else {
                   if (hasPath) {
-                    app.use(path, h);
+                    app.use(path2, h);
                   } else {
                     app.use(h);
                   }
@@ -1934,12 +3066,12 @@ __name(setupPublicRoutes, "setupPublicRoutes");
 // src/server/widgets/mount-widgets-dev.ts
 var TMP_MCP_USE_DIR = ".mcp-use";
 async function mountWidgetsDev(app, serverConfig, registerWidget, options) {
-  const { promises: fs } = await import("fs");
+  const { promises: fs2 } = await import("fs");
   const baseRoute = options?.baseRoute || "/mcp-use/widgets";
   const resourcesDir = options?.resourcesDir || "resources";
   const srcDir = pathHelpers.join(getCwd(), resourcesDir);
   try {
-    await fs.access(srcDir);
+    await fs2.access(srcDir);
   } catch (error2) {
     console.log(
       `[WIDGETS] No ${resourcesDir}/ directory found - skipping widget serving`
@@ -1948,7 +3080,7 @@ async function mountWidgetsDev(app, serverConfig, registerWidget, options) {
   }
   const entries = [];
   try {
-    const files = await fs.readdir(srcDir, { withFileTypes: true });
+    const files = await fs2.readdir(srcDir, { withFileTypes: true });
     for (const dirent of files) {
       if (dirent.name.startsWith("._") || dirent.name.startsWith(".DS_Store")) {
         continue;
@@ -1961,7 +3093,7 @@ async function mountWidgetsDev(app, serverConfig, registerWidget, options) {
       } else if (dirent.isDirectory()) {
         const widgetPath = pathHelpers.join(srcDir, dirent.name, "widget.tsx");
         try {
-          await fs.access(widgetPath);
+          await fs2.access(widgetPath);
           entries.push({
             name: dirent.name,
             path: widgetPath
@@ -1979,7 +3111,7 @@ async function mountWidgetsDev(app, serverConfig, registerWidget, options) {
     return;
   }
   const tempDir = pathHelpers.join(getCwd(), TMP_MCP_USE_DIR);
-  await fs.mkdir(tempDir, { recursive: true }).catch(() => {
+  await fs2.mkdir(tempDir, { recursive: true }).catch(() => {
   });
   let createServer;
   let react;
@@ -2013,7 +3145,7 @@ async function mountWidgetsDev(app, serverConfig, registerWidget, options) {
   });
   for (const widget2 of widgets) {
     const widgetTempDir = pathHelpers.join(tempDir, widget2.name);
-    await fs.mkdir(widgetTempDir, { recursive: true });
+    await fs2.mkdir(widgetTempDir, { recursive: true });
     const resourcesPath = pathHelpers.join(getCwd(), resourcesDir);
     const relativeResourcesPath = pathHelpers.relative(widgetTempDir, resourcesPath).replace(/\\/g, "/");
     const cssContent = `@import "tailwindcss";
@@ -2021,7 +3153,7 @@ async function mountWidgetsDev(app, serverConfig, registerWidget, options) {
 /* Configure Tailwind to scan the resources directory */
 @source "${relativeResourcesPath}";
 `;
-    await fs.writeFile(
+    await fs2.writeFile(
       pathHelpers.join(widgetTempDir, "styles.css"),
       cssContent,
       "utf8"
@@ -2049,12 +3181,12 @@ if (container && Component) {
     <script type="module" src="${baseRoute}/${widget2.name}/entry.tsx"></script>
   </body>
 </html>`;
-    await fs.writeFile(
+    await fs2.writeFile(
       pathHelpers.join(widgetTempDir, "entry.tsx"),
       entryContent,
       "utf8"
     );
-    await fs.writeFile(
+    await fs2.writeFile(
       pathHelpers.join(widgetTempDir, "index.html"),
       htmlContent,
       "utf8"
@@ -2088,10 +3220,42 @@ if (container && Component) {
       console.log(`[WIDGETS] Watching resources directory: ${resourcesPath}`);
     }
   };
+  const nodeStubsPlugin = {
+    name: "node-stubs",
+    enforce: "pre",
+    resolveId(id) {
+      if (id === "posthog-node" || id.startsWith("posthog-node/")) {
+        return "\0virtual:posthog-node-stub";
+      }
+      return null;
+    },
+    load(id) {
+      if (id === "\0virtual:posthog-node-stub") {
+        return `
+export class PostHog {
+  constructor() {}
+  capture() {}
+  identify() {}
+  alias() {}
+  flush() { return Promise.resolve(); }
+  shutdown() { return Promise.resolve(); }
+}
+export default PostHog;
+`;
+      }
+      return null;
+    }
+  };
   const viteServer = await createServer({
     root: tempDir,
     base: baseRoute + "/",
-    plugins: [ssrCssPlugin, watchResourcesPlugin, tailwindcss(), react()],
+    plugins: [
+      nodeStubsPlugin,
+      ssrCssPlugin,
+      watchResourcesPlugin,
+      tailwindcss(),
+      react()
+    ],
     resolve: {
       alias: {
         "@": pathHelpers.join(getCwd(), resourcesDir)
@@ -2112,12 +3276,15 @@ if (container && Component) {
     // Explicitly tell Vite to watch files outside root
     // This is needed because widget entry files import from resources directory
     optimizeDeps: {
-      // Don't optimize dependencies that might change
-      exclude: []
+      // Exclude Node.js-only packages from browser bundling
+      // posthog-node is for server-side telemetry and doesn't work in browser
+      exclude: ["posthog-node"]
     },
     ssr: {
       // Force Vite to transform these packages in SSR instead of using external requires
-      noExternal: ["@openai/apps-sdk-ui", "react-router"]
+      noExternal: ["@openai/apps-sdk-ui", "react-router"],
+      // Mark Node.js-only packages as external in SSR mode
+      external: ["posthog-node"]
     },
     define: {
       // Define process.env for SSR context
@@ -3305,6 +4472,7 @@ __name(startIdleCleanup, "startIdleCleanup");
 
 // src/server/endpoints/mount-mcp.ts
 init_runtime();
+init_telemetry2();
 async function mountMcp(app, mcpServerInstance, sessions, config, isProductionMode2) {
   const { FetchStreamableHTTPServerTransport } = await import("@mcp-use/modelcontextprotocol-sdk/experimental/fetch-streamable-http/index.js");
   const idleTimeoutMs = config.sessionIdleTimeoutMs ?? 3e5;
@@ -3344,6 +4512,8 @@ async function mountMcp(app, mcpServerInstance, sessions, config, isProductionMo
         });
         server.server.oninitialized = () => {
           const clientCapabilities = server.server.getClientCapabilities();
+          const clientInfo = server.server.getClientInfo?.() || {};
+          const protocolVersion = server.server.getProtocolVersion?.() || "unknown";
           if (clientCapabilities && sessions.has(sid)) {
             const session = sessions.get(sid);
             session.clientCapabilities = clientCapabilities;
@@ -3352,6 +4522,14 @@ async function mountMcp(app, mcpServerInstance, sessions, config, isProductionMo
               Object.keys(clientCapabilities)
             );
           }
+          Telemetry.getInstance().trackServerInitialize({
+            protocolVersion: String(protocolVersion),
+            clientInfo: clientInfo || {},
+            clientCapabilities: clientCapabilities || {},
+            sessionId: sid
+          }).catch(
+            (e) => console.debug(`Failed to track server initialize: ${e}`)
+          );
         };
       }, "onsessioninitialized"),
       onsessionclosed: /* @__PURE__ */ __name((sid) => {
@@ -3655,7 +4833,14 @@ var MCPServerClass = class {
     __name(this, "MCPServerClass");
   }
   /**
-   * Native MCP server instance from @mcp-use/modelcontextprotocol-sdk
+   * Get the mcp-use package version.
+   * Works in all environments (Node.js, browser, Cloudflare Workers, Deno, etc.)
+   */
+  static getPackageVersion() {
+    return getPackageVersion();
+  }
+  /**
+   * Native MCP server instance from @modelcontextprotocol/sdk
    * Exposed publicly for advanced use cases
    */
   nativeServer;
@@ -3684,10 +4869,11 @@ var MCPServerClass = class {
   oauthProvider;
   oauthMiddleware;
   /**
-   * Storage for registration "recipes" that can be replayed on new server instances
+   * Storage for registrations that can be replayed on new server instances
    * Following the official SDK pattern where each session gets its own server instance
+   * @internal Exposed for telemetry purposes
    */
-  registrationRecipes = {
+  registrations = {
     tools: /* @__PURE__ */ new Map(),
     prompts: /* @__PURE__ */ new Map(),
     resources: /* @__PURE__ */ new Map(),
@@ -3749,7 +4935,7 @@ var MCPServerClass = class {
     return createHonoProxy(this, this.app);
   }
   /**
-   * Wrap registration methods to capture recipes following official SDK pattern.
+   * Wrap registration methods to capture registrations following official SDK pattern.
    * Each session will get a fresh server instance with all registrations replayed.
    */
   wrapRegistrationMethods() {
@@ -3801,7 +4987,7 @@ var MCPServerClass = class {
         }), "actualCallback");
       }
       if (actualCallback) {
-        self.registrationRecipes.tools.set(toolDefinition.name, {
+        self.registrations.tools.set(toolDefinition.name, {
           config: toolDefinition,
           handler: actualCallback
         });
@@ -3811,7 +4997,7 @@ var MCPServerClass = class {
     this.prompt = ((promptDefinition, callback) => {
       const actualCallback = callback || promptDefinition.cb;
       if (actualCallback) {
-        self.registrationRecipes.prompts.set(promptDefinition.name, {
+        self.registrations.prompts.set(promptDefinition.name, {
           config: promptDefinition,
           handler: actualCallback
         });
@@ -3826,7 +5012,7 @@ var MCPServerClass = class {
       const actualCallback = callback || resourceDefinition.readCallback;
       if (actualCallback) {
         const resourceKey = `${resourceDefinition.name}:${resourceDefinition.uri}`;
-        self.registrationRecipes.resources.set(resourceKey, {
+        self.registrations.resources.set(resourceKey, {
           config: resourceDefinition,
           handler: actualCallback
         });
@@ -3836,13 +5022,10 @@ var MCPServerClass = class {
     this.resourceTemplate = ((templateDefinition, callback) => {
       const actualCallback = callback || templateDefinition.readCallback;
       if (actualCallback) {
-        self.registrationRecipes.resourceTemplates.set(
-          templateDefinition.name,
-          {
-            config: templateDefinition,
-            handler: actualCallback
-          }
-        );
+        self.registrations.resourceTemplates.set(templateDefinition.name, {
+          config: templateDefinition,
+          handler: actualCallback
+        });
       }
       return originalResourceTemplate.call(
         self,
@@ -3867,8 +5050,8 @@ var MCPServerClass = class {
         }
       }
     );
-    for (const [name, recipe] of this.registrationRecipes.tools) {
-      const { config, handler: actualCallback } = recipe;
+    for (const [name, registration] of this.registrations.tools) {
+      const { config, handler: actualCallback } = registration;
       let inputSchema;
       if (config.schema) {
         inputSchema = this.convertZodSchemaToParams(config.schema);
@@ -3934,10 +5117,26 @@ var MCPServerClass = class {
           }
           return await actualCallback(params);
         }, "executeCallback");
-        if (requestContext) {
-          return await runWithContext(requestContext, executeCallback);
+        const startTime = Date.now();
+        let success = true;
+        let errorType = null;
+        try {
+          const result = requestContext ? await runWithContext(requestContext, executeCallback) : await executeCallback();
+          return result;
+        } catch (err) {
+          success = false;
+          errorType = err instanceof Error ? err.name : "unknown_error";
+          throw err;
+        } finally {
+          const executionTimeMs = Date.now() - startTime;
+          Telemetry.getInstance().trackServerToolCall({
+            toolName: name,
+            lengthInputArgument: JSON.stringify(params).length,
+            success,
+            errorType,
+            executionTimeMs
+          }).catch((e) => console.debug(`Failed to track tool call: ${e}`));
         }
-        return await executeCallback();
       }, "wrappedHandler");
       newServer.registerTool(
         name,
@@ -3951,8 +5150,8 @@ var MCPServerClass = class {
         wrappedHandler
       );
     }
-    for (const [name, recipe] of this.registrationRecipes.prompts) {
-      const { config, handler } = recipe;
+    for (const [name, registration] of this.registrations.prompts) {
+      const { config, handler } = registration;
       let argsSchema;
       if (config.schema) {
         argsSchema = this.convertZodSchemaToParams(config.schema);
@@ -3962,12 +5161,27 @@ var MCPServerClass = class {
         argsSchema = void 0;
       }
       const wrappedHandler = /* @__PURE__ */ __name(async (params, extra) => {
-        const result = await handler(params, extra);
-        if ("messages" in result && Array.isArray(result.messages)) {
-          return result;
+        let success = true;
+        let errorType = null;
+        try {
+          const result = await handler(params, extra);
+          if ("messages" in result && Array.isArray(result.messages)) {
+            return result;
+          }
+          const { convertToolResultToPromptResult: convertToolResultToPromptResult2 } = await Promise.resolve().then(() => (init_conversion2(), conversion_exports2));
+          return convertToolResultToPromptResult2(result);
+        } catch (err) {
+          success = false;
+          errorType = err instanceof Error ? err.name : "unknown_error";
+          throw err;
+        } finally {
+          Telemetry.getInstance().trackServerPromptCall({
+            name,
+            description: config.description ?? null,
+            success,
+            errorType
+          }).catch((e) => console.debug(`Failed to track prompt call: ${e}`));
         }
-        const { convertToolResultToPromptResult: convertToolResultToPromptResult2 } = await Promise.resolve().then(() => (init_conversion2(), conversion_exports2));
-        return convertToolResultToPromptResult2(result);
       }, "wrappedHandler");
       newServer.registerPrompt(
         name,
@@ -3979,15 +5193,42 @@ var MCPServerClass = class {
         wrappedHandler
       );
     }
-    for (const [_key, recipe] of this.registrationRecipes.resources) {
-      const { config, handler } = recipe;
+    for (const [_key, registration] of this.registrations.resources) {
+      const { config, handler } = registration;
       const wrappedHandler = /* @__PURE__ */ __name(async (extra) => {
-        const result = await handler(extra);
-        if ("contents" in result && Array.isArray(result.contents)) {
-          return result;
+        let success = true;
+        let errorType = null;
+        let contents = [];
+        try {
+          const result = await handler(extra);
+          if ("contents" in result && Array.isArray(result.contents)) {
+            contents = result.contents;
+            return result;
+          }
+          const { convertToolResultToResourceResult: convertToolResultToResourceResult2 } = await Promise.resolve().then(() => (init_conversion(), conversion_exports));
+          const converted = convertToolResultToResourceResult2(
+            config.uri,
+            result
+          );
+          contents = converted.contents || [];
+          return converted;
+        } catch (err) {
+          success = false;
+          errorType = err instanceof Error ? err.name : "unknown_error";
+          throw err;
+        } finally {
+          Telemetry.getInstance().trackServerResourceCall({
+            name: config.name,
+            description: config.description ?? null,
+            contents: contents.map((c) => ({
+              mime_type: c.mimeType ?? null,
+              text: c.text ? `[text: ${c.text.length} chars]` : null,
+              blob: c.blob ? `[blob: ${c.blob.length} bytes]` : null
+            })),
+            success,
+            errorType
+          }).catch((e) => console.debug(`Failed to track resource call: ${e}`));
         }
-        const { convertToolResultToResourceResult: convertToolResultToResourceResult2 } = await Promise.resolve().then(() => (init_conversion(), conversion_exports));
-        return convertToolResultToResourceResult2(config.uri, result);
       }, "wrappedHandler");
       newServer.registerResource(
         config.name,
@@ -4000,8 +5241,8 @@ var MCPServerClass = class {
         wrappedHandler
       );
     }
-    for (const [_name, recipe] of this.registrationRecipes.resourceTemplates) {
-      const { config, handler } = recipe;
+    for (const [_name, registration] of this.registrations.resourceTemplates) {
+      const { config, handler } = registration;
       const isFlatStructure = "uriTemplate" in config;
       const uriTemplate = isFlatStructure ? config.uriTemplate : config.resourceTemplate.uriTemplate;
       const mimeType = isFlatStructure ? config.mimeType : config.resourceTemplate.mimeType;
@@ -4028,16 +5269,42 @@ var MCPServerClass = class {
         template,
         metadata,
         async (uri, extra) => {
-          const params = this.parseTemplateUri(uriTemplate, uri.toString());
-          const result = await handler(uri, params, extra);
-          if ("contents" in result && Array.isArray(result.contents)) {
-            return result;
+          let success = true;
+          let errorType = null;
+          let contents = [];
+          try {
+            const params = this.parseTemplateUri(uriTemplate, uri.toString());
+            const result = await handler(uri, params, extra);
+            if ("contents" in result && Array.isArray(result.contents)) {
+              contents = result.contents;
+              return result;
+            }
+            const { convertToolResultToResourceResult: convertToolResultToResourceResult2 } = await Promise.resolve().then(() => (init_conversion(), conversion_exports));
+            const converted = convertToolResultToResourceResult2(
+              uri.toString(),
+              result
+            );
+            contents = converted.contents || [];
+            return converted;
+          } catch (err) {
+            success = false;
+            errorType = err instanceof Error ? err.name : "unknown_error";
+            throw err;
+          } finally {
+            Telemetry.getInstance().trackServerResourceCall({
+              name: config.name,
+              description: config.description ?? null,
+              contents: contents.map((c) => ({
+                mimeType: c.mimeType ?? null,
+                text: c.text ? `[text: ${c.text.length} chars]` : null,
+                blob: c.blob ? `[blob: ${c.blob.length} bytes]` : null
+              })),
+              success,
+              errorType
+            }).catch(
+              (e) => console.debug(`Failed to track resource template call: ${e}`)
+            );
           }
-          const { convertToolResultToResourceResult: convertToolResultToResourceResult2 } = await Promise.resolve().then(() => (init_conversion(), conversion_exports));
-          return convertToolResultToResourceResult2(
-            uri.toString(),
-            result
-          );
         }
       );
     }
@@ -4237,10 +5504,14 @@ var MCPServerClass = class {
     await this.mountMcp();
     await this.mountInspector();
     this.logRegisteredItems();
+    this._trackServerRun("http");
     await startServer(this.app, this.serverPort, this.serverHost, {
       onDenoRequest: rewriteSupabaseRequest
     });
   }
+  _trackServerRun(transport) {
+    Telemetry.getInstance().trackServerRunFromServer(this, transport).catch((e) => console.debug(`Failed to track server run: ${e}`));
+  }
   /**
    * Get the fetch handler for the server after mounting all endpoints
    *
@@ -4294,6 +5565,8 @@ var MCPServerClass = class {
     console.log("[MCP] Mounting inspector");
     await this.mountInspector();
     console.log("[MCP] Mounted inspector");
+    const provider = options?.provider || "fetch";
+    this._trackServerRun(provider);
     const fetchHandler = this.app.fetch.bind(this.app);
     if (options?.provider === "supabase") {
       return async (req) => {
@@ -4363,6 +5636,7 @@ function createMCPServer(name, config = {}) {
 __name(createMCPServer, "createMCPServer");
 
 // src/server/index.ts
+init_version();
 init_context_storage();
 
 // src/server/oauth/providers/supabase.ts