@dereekb/firebase-server 13.12.0 → 13.12.2

package/mcp/index.esm.js

@@ -4,18 +4,18 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { getOidcScopesFromRequest } from '@dereekb/firebase-server/oidc';
 import { authRolesSetHasRoles } from '@dereekb/util';
-import { ModelApiCallModelDispatchService, ModelApiGetService } from '@dereekb/firebase-server';
+import { ModelApiCallModelDispatchService, ModelApiGetService, FirebaseServerAnalyticsService } from '@dereekb/firebase-server';
 import { inspect } from 'node:util';
 import { arktypeToJsonSchemaForExport } from '@dereekb/model';
 import { callModelOidcScopeForCallType } from '@dereekb/firebase';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 
-function _class_call_check$3(instance, Constructor) {
+function _class_call_check$5(instance, Constructor) {
     if (!(instance instanceof Constructor)) {
         throw new TypeError("Cannot call a class as a function");
     }
 }
-function _define_property$6(obj, key, value) {
+function _define_property$7(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -41,6 +41,10 @@ function _define_property$6(obj, key, value) {
  * Apps may override this via {@link McpModuleConfig.serverName} to identify their
  * deployment (e.g., `demo-api-mcp`, `hellosubs-api-mcp`).
  */ var DEFAULT_MCP_SERVER_NAME = 'dbx-firebase-server-mcp';
+/**
+ * Default `instructions` string advertised by the MCP server on the JSON-RPC `initialize`
+ * handshake. Apps may override this via {@link McpModuleConfig.serverInstructions}.
+ */ var DEFAULT_MCP_SERVER_INSTRUCTIONS = 'A set of call-model tools generated automatically.';
 /**
  * Configuration for the firebase-server/mcp module.
  *
@@ -57,7 +61,7 @@ function _define_property$6(obj, key, value) {
  * The OAuth bearer middleware that authenticates `/mcp` is configured on
  * {@link OidcModuleConfig.protectedPaths} — that's outside this config's scope.
  */ var McpModuleConfig = function McpModuleConfig() {
-    _class_call_check$3(this, McpModuleConfig);
+    _class_call_check$5(this, McpModuleConfig);
     /**
      * The canonical issuer URL of the OIDC provider that gates this MCP endpoint.
      *
@@ -65,7 +69,7 @@ function _define_property$6(obj, key, value) {
      * discovery document. Claude custom-connector reads this to discover the OIDC issuer.
      *
      * @example 'https://api.example.com/oidc'
-     */ _define_property$6(this, "oidcIssuer", void 0);
+     */ _define_property$7(this, "oidcIssuer", void 0);
     /**
      * The canonical resource URL of the MCP endpoint.
      *
@@ -73,14 +77,19 @@ function _define_property$6(obj, key, value) {
      * and used as the audience the access token's `aud` claim should match.
      *
      * @example 'https://api.example.com/mcp'
-     */ _define_property$6(this, "mcpUrl", void 0);
+     */ _define_property$7(this, "mcpUrl", void 0);
     /**
      * Optional name advertised on the MCP `initialize` handshake. Defaults to
      * {@link DEFAULT_MCP_SERVER_NAME}.
-     */ _define_property$6(this, "serverName", void 0);
+     */ _define_property$7(this, "serverName", void 0);
     /**
      * Optional version advertised on the MCP `initialize` handshake.
-     */ _define_property$6(this, "serverVersion", void 0);
+     */ _define_property$7(this, "serverVersion", void 0);
+    /**
+     * Optional override for the `instructions` string passed to `new McpServer(...)` and
+     * advertised on the JSON-RPC `initialize` handshake. Defaults to
+     * {@link DEFAULT_MCP_SERVER_INSTRUCTIONS}.
+     */ _define_property$7(this, "serverInstructions", void 0);
     /**
      * Absolute path to a pre-rendered MCP manifest JSON file produced by
      * `dbx-cli-generate-mcp-manifest`. When set, the runtime reads it once at
@@ -90,7 +99,7 @@ function _define_property$6(obj, key, value) {
      * Optional. When unset or the file is missing, the runtime falls back to
      * today's behavior (auto-generated descriptions, ArkType-derived input
      * schemas, no output schemas) and emits a single boot warning.
-     */ _define_property$6(this, "mcpManifestPath", void 0);
+     */ _define_property$7(this, "mcpManifestPath", void 0);
     /**
      * When `true`, the MCP server only advertises tools whose effective read-only classification is `true`.
      *
@@ -100,19 +109,19 @@ function _define_property$6(obj, key, value) {
      *
      * The advertised `serverName` on the JSON-RPC `initialize` handshake is suffixed with
      * ` (read-only)` so the client surface reflects the mode.
-     */ _define_property$6(this, "readOnly", void 0);
+     */ _define_property$7(this, "readOnly", void 0);
 };
 /**
  * NestJS injection token for the optional {@link McpAuthRoleReader} provider.
  */ var MCP_AUTH_ROLE_READER = 'MCP_AUTH_ROLE_READER';
 
-function _type_of$1(obj) {
+function _type_of$2(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
 function __decorate(decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if ((typeof Reflect === "undefined" ? "undefined" : _type_of$1(Reflect)) === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    if ((typeof Reflect === "undefined" ? "undefined" : _type_of$2(Reflect)) === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
     else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
@@ -126,6 +135,39 @@ typeof SuppressedError === "function" ? SuppressedError : function(error, suppre
     return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
 };
 
+function _class_call_check$4(instance, Constructor) {
+    if (!(instance instanceof Constructor)) {
+        throw new TypeError("Cannot call a class as a function");
+    }
+}
+/**
+ * Abstract analytics service that apps implement to process MCP analytics events.
+ *
+ * Analogous to {@link OnCallModelAnalyticsService} but scoped to the MCP transport.
+ * Apps extend this class and provide it via {@link MCP_ANALYTICS_SERVICE}.
+ */ var McpAnalyticsService = function McpAnalyticsService() {
+    _class_call_check$4(this, McpAnalyticsService);
+};
+/**
+ * Injection token for the MCP analytics service.
+ * Apps provide this in their MCP module to enable analytics in the MCP dispatch chain.
+ */ var MCP_ANALYTICS_SERVICE = 'MCP_ANALYTICS_SERVICE';
+/**
+ * Creates a no-op {@link McpAnalyticsService} that silently discards all events.
+ *
+ * Used as the default fallback by {@link McpServerFactoryService} when no analytics
+ * service is registered.
+ *
+ * @returns An {@link McpAnalyticsService} that discards all analytics events.
+ * @__NO_SIDE_EFFECTS__
+ */ function noopMcpAnalyticsService() {
+    return {
+        handleMcpAnalyticsEvent: function handleMcpAnalyticsEvent() {
+            return undefined;
+        }
+    };
+}
+
 /**
  * Version stamp embedded in the build-time MCP manifest JSON. Runtime loaders
  * refuse manifests whose `version` does not match this constant.
@@ -313,7 +355,7 @@ function stringifyResult(result) {
     return callModelOidcScopeForCallType(callType);
 }
 
-function _array_like_to_array$4(arr, len) {
+function _array_like_to_array$5(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
@@ -349,19 +391,19 @@ function _non_iterable_rest$2() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _sliced_to_array$2(arr, i) {
-    return _array_with_holes$2(arr) || _iterable_to_array_limit$2(arr, i) || _unsupported_iterable_to_array$4(arr, i) || _non_iterable_rest$2();
+    return _array_with_holes$2(arr) || _iterable_to_array_limit$2(arr, i) || _unsupported_iterable_to_array$5(arr, i) || _non_iterable_rest$2();
 }
-function _type_of(obj) {
+function _type_of$1(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
-function _unsupported_iterable_to_array$4(o, minLen) {
+function _unsupported_iterable_to_array$5(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$4(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$5(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$4(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$5(o, minLen);
 }
 /**
  * Default `toJsonSchema()` options.
@@ -628,7 +670,7 @@ function resolveInputSchema(context) {
     var result;
     try {
         var exported = arktypeToJsonSchemaForExport(handlerDetails.inputType);
-        if (exported && (typeof exported === "undefined" ? "undefined" : _type_of(exported)) === 'object') {
+        if (exported && (typeof exported === "undefined" ? "undefined" : _type_of$1(exported)) === 'object') {
             result = exported;
         } else {
             // arktypeToJsonSchemaForExport returned a non-object (shouldn't happen for object schemas).
@@ -647,13 +689,13 @@ function resolveInputSchema(context) {
     return result;
 }
 
-function _array_like_to_array$3(arr, len) {
+function _array_like_to_array$4(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_without_holes$3(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$3(arr);
+function _array_without_holes$4(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$4(arr);
 }
 function asyncGeneratorStep$3(gen, resolve, reject, _next, _throw, key, arg) {
     try {
@@ -684,22 +726,22 @@ function _async_to_generator$3(fn) {
         });
     };
 }
-function _iterable_to_array$3(iter) {
+function _iterable_to_array$4(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _non_iterable_spread$3() {
+function _non_iterable_spread$4() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _to_consumable_array$3(arr) {
-    return _array_without_holes$3(arr) || _iterable_to_array$3(arr) || _unsupported_iterable_to_array$3(arr) || _non_iterable_spread$3();
+function _to_consumable_array$4(arr) {
+    return _array_without_holes$4(arr) || _iterable_to_array$4(arr) || _unsupported_iterable_to_array$4(arr) || _non_iterable_spread$4();
 }
-function _unsupported_iterable_to_array$3(o, minLen) {
+function _unsupported_iterable_to_array$4(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$3(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$4(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$3(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$4(o, minLen);
 }
 function _ts_generator$3(thisArg, body) {
     var f, y, t, _ = {
@@ -1004,8 +1046,8 @@ function readInChunks(input) {
                     ];
                 case 2:
                     partial = _state.sent();
-                    (_merged_results = merged.results).push.apply(_merged_results, _to_consumable_array$3(partial.results));
-                    (_merged_errors = merged.errors).push.apply(_merged_errors, _to_consumable_array$3(partial.errors));
+                    (_merged_results = merged.results).push.apply(_merged_results, _to_consumable_array$4(partial.results));
+                    (_merged_errors = merged.errors).push.apply(_merged_errors, _to_consumable_array$4(partial.errors));
                     _state.label = 3;
                 case 3:
                     offset += MCP_MODEL_GET_BATCH_SIZE;
@@ -1096,7 +1138,7 @@ var MODEL_GET_OUTPUT_SCHEMA = {
     }
 };
 
-function _define_property$5(obj, key, value) {
+function _define_property$6(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -1119,7 +1161,7 @@ function _object_spread$2(target) {
             }));
         }
         ownKeys.forEach(function(key) {
-            _define_property$5(target, key, source[key]);
+            _define_property$6(target, key, source[key]);
         });
     }
     return target;
@@ -1473,7 +1515,7 @@ var MODEL_INFO_OUTPUT_SCHEMA = {
     ]
 };
 
-function _define_property$4(obj, key, value) {
+function _define_property$5(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -1496,7 +1538,7 @@ function _object_spread$1(target) {
             }));
         }
         ownKeys.forEach(function(key) {
-            _define_property$4(target, key, source[key]);
+            _define_property$5(target, key, source[key]);
         });
     }
     return target;
@@ -1732,7 +1774,7 @@ var MODEL_DECODE_OUTPUT_SCHEMA = {
     }
 };
 
-function _array_like_to_array$2(arr, len) {
+function _array_like_to_array$3(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
@@ -1740,10 +1782,10 @@ function _array_like_to_array$2(arr, len) {
 function _array_with_holes$1(arr) {
     if (Array.isArray(arr)) return arr;
 }
-function _array_without_holes$2(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$2(arr);
+function _array_without_holes$3(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$3(arr);
 }
-function _define_property$3(obj, key, value) {
+function _define_property$4(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -1756,7 +1798,7 @@ function _define_property$3(obj, key, value) {
     }
     return obj;
 }
-function _iterable_to_array$2(iter) {
+function _iterable_to_array$3(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
 function _iterable_to_array_limit$1(arr, i) {
@@ -1786,7 +1828,7 @@ function _iterable_to_array_limit$1(arr, i) {
 function _non_iterable_rest$1() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _non_iterable_spread$2() {
+function _non_iterable_spread$3() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _object_spread(target) {
@@ -1799,24 +1841,24 @@ function _object_spread(target) {
             }));
         }
         ownKeys.forEach(function(key) {
-            _define_property$3(target, key, source[key]);
+            _define_property$4(target, key, source[key]);
         });
     }
     return target;
 }
 function _sliced_to_array$1(arr, i) {
-    return _array_with_holes$1(arr) || _iterable_to_array_limit$1(arr, i) || _unsupported_iterable_to_array$2(arr, i) || _non_iterable_rest$1();
+    return _array_with_holes$1(arr) || _iterable_to_array_limit$1(arr, i) || _unsupported_iterable_to_array$3(arr, i) || _non_iterable_rest$1();
 }
-function _to_consumable_array$2(arr) {
-    return _array_without_holes$2(arr) || _iterable_to_array$2(arr) || _unsupported_iterable_to_array$2(arr) || _non_iterable_spread$2();
+function _to_consumable_array$3(arr) {
+    return _array_without_holes$3(arr) || _iterable_to_array$3(arr) || _unsupported_iterable_to_array$3(arr) || _non_iterable_spread$3();
 }
-function _unsupported_iterable_to_array$2(o, minLen) {
+function _unsupported_iterable_to_array$3(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$2(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$3(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$2(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$3(o, minLen);
 }
 // MARK: Constants
 /**
@@ -1897,7 +1939,7 @@ function whoamiToolHandler(ctx, deps) {
         return key;
     });
     var roleSet = deps.roleReader == null ? new Set() : deps.roleReader(token);
-    var roles = _to_consumable_array$2(roleSet).sort(function(a, b) {
+    var roles = _to_consumable_array$3(roleSet).sort(function(a, b) {
         return a.localeCompare(b);
     });
     var claimsByKey = new Map();
@@ -2166,7 +2208,7 @@ var WHOAMI_OUTPUT_SCHEMA = {
     }
 };
 
-function _array_like_to_array$1(arr, len) {
+function _array_like_to_array$2(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
@@ -2174,8 +2216,8 @@ function _array_like_to_array$1(arr, len) {
 function _array_with_holes(arr) {
     if (Array.isArray(arr)) return arr;
 }
-function _array_without_holes$1(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$1(arr);
+function _array_without_holes$2(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$2(arr);
 }
 function asyncGeneratorStep$2(gen, resolve, reject, _next, _throw, key, arg) {
     try {
@@ -2206,12 +2248,12 @@ function _async_to_generator$2(fn) {
         });
     };
 }
-function _class_call_check$2(instance, Constructor) {
+function _class_call_check$3(instance, Constructor) {
     if (!(instance instanceof Constructor)) {
         throw new TypeError("Cannot call a class as a function");
     }
 }
-function _defineProperties$2(target, props) {
+function _defineProperties$3(target, props) {
     for(var i = 0; i < props.length; i++){
         var descriptor = props[i];
         descriptor.enumerable = descriptor.enumerable || false;
@@ -2220,11 +2262,11 @@ function _defineProperties$2(target, props) {
         Object.defineProperty(target, descriptor.key, descriptor);
     }
 }
-function _create_class$2(Constructor, protoProps, staticProps) {
-    if (protoProps) _defineProperties$2(Constructor.prototype, protoProps);
+function _create_class$3(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties$3(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property$2(obj, key, value) {
+function _define_property$3(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -2237,7 +2279,7 @@ function _define_property$2(obj, key, value) {
     }
     return obj;
 }
-function _iterable_to_array$1(iter) {
+function _iterable_to_array$2(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
 function _iterable_to_array_limit(arr, i) {
@@ -2267,22 +2309,22 @@ function _iterable_to_array_limit(arr, i) {
 function _non_iterable_rest() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _non_iterable_spread$1() {
+function _non_iterable_spread$2() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _sliced_to_array(arr, i) {
-    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array$1(arr, i) || _non_iterable_rest();
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array$2(arr, i) || _non_iterable_rest();
 }
-function _to_consumable_array$1(arr) {
-    return _array_without_holes$1(arr) || _iterable_to_array$1(arr) || _unsupported_iterable_to_array$1(arr) || _non_iterable_spread$1();
+function _to_consumable_array$2(arr) {
+    return _array_without_holes$2(arr) || _iterable_to_array$2(arr) || _unsupported_iterable_to_array$2(arr) || _non_iterable_spread$2();
 }
-function _unsupported_iterable_to_array$1(o, minLen) {
+function _unsupported_iterable_to_array$2(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$1(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$2(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$1(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$2(o, minLen);
 }
 function _ts_generator$2(thisArg, body) {
     var f, y, t, _ = {
@@ -2392,27 +2434,29 @@ var McpServerFactoryService_1;
  * recommends a fresh `McpServer` + transport pair per stateless JSON-RPC request,
  * which sidesteps session bookkeeping for the common Claude-connector case.
  */ var McpServerFactoryService = McpServerFactoryService_1 = /*#__PURE__*/ function() {
-    function McpServerFactoryService(mcpConfig, dispatchService, modelApiGetService, roleReader) {
-        _class_call_check$2(this, McpServerFactoryService);
-        _define_property$2(this, "mcpConfig", void 0);
-        _define_property$2(this, "dispatchService", void 0);
-        _define_property$2(this, "modelApiGetService", void 0);
-        _define_property$2(this, "roleReader", void 0);
-        _define_property$2(this, "_logger", new Logger(McpServerFactoryService_1.name));
-        _define_property$2(this, "_cachedTools", void 0);
-        _define_property$2(this, "_cachedStaticTools", void 0);
-        _define_property$2(this, "_cachedManifest", void 0);
-        _define_property$2(this, "_cachedManifestModels", void 0);
-        _define_property$2(this, "_cachedManifestAuth", void 0);
-        _define_property$2(this, "_manifestLoaded", false);
-        _define_property$2(this, "_loggedSkips", false);
-        _define_property$2(this, "_warnedMissingRoleReader", false);
+    function McpServerFactoryService(mcpConfig, dispatchService, modelApiGetService, roleReader, analyticsService) {
+        _class_call_check$3(this, McpServerFactoryService);
+        _define_property$3(this, "mcpConfig", void 0);
+        _define_property$3(this, "dispatchService", void 0);
+        _define_property$3(this, "modelApiGetService", void 0);
+        _define_property$3(this, "roleReader", void 0);
+        _define_property$3(this, "_logger", new Logger(McpServerFactoryService_1.name));
+        _define_property$3(this, "_cachedTools", void 0);
+        _define_property$3(this, "_cachedStaticTools", void 0);
+        _define_property$3(this, "_cachedManifest", void 0);
+        _define_property$3(this, "_cachedManifestModels", void 0);
+        _define_property$3(this, "_cachedManifestAuth", void 0);
+        _define_property$3(this, "_manifestLoaded", false);
+        _define_property$3(this, "_loggedSkips", false);
+        _define_property$3(this, "_warnedMissingRoleReader", false);
+        _define_property$3(this, "_analyticsService", void 0);
         this.mcpConfig = mcpConfig;
         this.dispatchService = dispatchService;
         this.modelApiGetService = modelApiGetService;
         this.roleReader = roleReader;
+        this._analyticsService = analyticsService !== null && analyticsService !== void 0 ? analyticsService : noopMcpAnalyticsService();
     }
-    _create_class$2(McpServerFactoryService, [
+    _create_class$3(McpServerFactoryService, [
         {
             /**
      * Builds a configured MCP server with tool listing + dispatch handlers wired up.
@@ -2422,14 +2466,14 @@ var McpServerFactoryService_1;
      */ key: "createServer",
             value: function createServer(ctx) {
                 var _this = this;
-                var _this_mcpConfig_serverName, _this_mcpConfig_serverVersion;
+                var _this_mcpConfig_serverName, _this_mcpConfig_serverVersion, _this_mcpConfig_serverInstructions;
                 var baseServerName = (_this_mcpConfig_serverName = this.mcpConfig.serverName) !== null && _this_mcpConfig_serverName !== void 0 ? _this_mcpConfig_serverName : DEFAULT_MCP_SERVER_NAME;
                 var serverName = this.mcpConfig.readOnly === true ? "".concat(baseServerName, " (read-only)") : baseServerName;
                 var server = new McpServer({
                     name: serverName,
                     version: (_this_mcpConfig_serverVersion = this.mcpConfig.serverVersion) !== null && _this_mcpConfig_serverVersion !== void 0 ? _this_mcpConfig_serverVersion : '0.0.0'
                 }, {
-                    instructions: 'Model-bound RPC tools generated from the callModel _apiDetails tree.'
+                    instructions: (_this_mcpConfig_serverInstructions = this.mcpConfig.serverInstructions) !== null && _this_mcpConfig_serverInstructions !== void 0 ? _this_mcpConfig_serverInstructions : DEFAULT_MCP_SERVER_INSTRUCTIONS
                 });
                 server.server.registerCapabilities({
                     tools: {}
@@ -2438,7 +2482,7 @@ var McpServerFactoryService_1;
                 var staticTools = this._resolveStaticTools();
                 var scopes = this._resolveScopes(ctx);
                 var authRoles = this._resolveAuthRoles(ctx);
-                var combinedTools = _to_consumable_array$1(toolGeneration.tools).concat(_to_consumable_array$1(staticTools));
+                var combinedTools = _to_consumable_array$2(toolGeneration.tools).concat(_to_consumable_array$2(staticTools));
                 var visibleTools = this._filterToolsForRequest(combinedTools, {
                     ctx: ctx,
                     scopes: scopes,
@@ -2889,19 +2933,36 @@ var McpServerFactoryService_1;
         },
         {
             key: "_handleToolCall",
-            value: function _handleToolCall(request, definitionsByName, ctx) {
+            value: /**
+     * Central dispatch point for every MCP tool call. Runs the underlying handler — callModel,
+     * static, or unknown-tool — then emits a single analytics event on completion so every call
+     * is tracked uniformly.
+     *
+     * Success vs error is decided by the resolved outcome: an outcome that carries a thrown
+     * error, or a response flagged `isError`, counts as a failure. The original thrown error
+     * (when present) is forwarded on the event.
+     *
+     * @param request - The `tools/call` request carrying the tool name and arguments.
+     * @param definitionsByName - The visible tool definitions keyed by name for this request.
+     * @param ctx - The per-request context (auth, raw request) forwarded to the handler.
+     * @returns The MCP tool response.
+     */ function _handleToolCall(request, definitionsByName, ctx) {
                 return _async_to_generator$2(function() {
-                    var _request_params_arguments, definition, args, response;
+                    var _request_params_arguments, _ctx_auth, toolName, definition, args, startedAt, outcome, isSuccessful, toolKind;
                     return _ts_generator$2(this, function(_state) {
                         switch(_state.label){
                             case 0:
-                                definition = definitionsByName.get(request.params.name);
+                                toolName = request.params.name;
+                                definition = definitionsByName.get(toolName);
                                 args = (_request_params_arguments = request.params.arguments) !== null && _request_params_arguments !== void 0 ? _request_params_arguments : {};
+                                startedAt = Date.now();
                                 if (!(definition == null)) return [
                                     3,
                                     1
                                 ];
-                                response = formatMcpToolErrorResponse(new Error("Unknown tool: ".concat(request.params.name)));
+                                outcome = {
+                                    response: formatMcpToolErrorResponse(new Error("Unknown tool: ".concat(toolName)))
+                                };
                                 return [
                                     3,
                                     5
@@ -2916,7 +2977,7 @@ var McpServerFactoryService_1;
                                     this._handleCallModelToolCall(definition, args, ctx)
                                 ];
                             case 2:
-                                response = _state.sent();
+                                outcome = _state.sent();
                                 return [
                                     3,
                                     5
@@ -2927,23 +2988,57 @@ var McpServerFactoryService_1;
                                     this._handleStaticToolCall(definition.staticHandler, args, ctx)
                                 ];
                             case 4:
-                                response = _state.sent();
+                                outcome = _state.sent();
                                 _state.label = 5;
                             case 5:
+                                isSuccessful = outcome.error == null && outcome.response.isError !== true;
+                                // Unknown tools never reached a handler; classify as 'static' since no callModel dispatch occurred.
+                                toolKind = definition != null && definition.staticHandler == null ? 'callModel' : 'static';
+                                this._emitMcpAnalytics({
+                                    event: toolName,
+                                    toolName: toolName,
+                                    toolKind: toolKind,
+                                    call: definition === null || definition === void 0 ? void 0 : definition.dispatch.call,
+                                    modelType: definition === null || definition === void 0 ? void 0 : definition.dispatch.modelType,
+                                    specifier: definition === null || definition === void 0 ? void 0 : definition.dispatch.specifier,
+                                    uid: (_ctx_auth = ctx.auth) === null || _ctx_auth === void 0 ? void 0 : _ctx_auth.uid,
+                                    auth: ctx.auth,
+                                    readOnly: this.mcpConfig.readOnly === true,
+                                    args: args,
+                                    isSuccessful: isSuccessful,
+                                    error: outcome.error,
+                                    durationMs: Date.now() - startedAt
+                                });
                                 return [
                                     2,
-                                    response
+                                    outcome.response
                                 ];
                         }
                     });
                 }).call(this);
             }
         },
+        {
+            /**
+     * Forwards an event to the registered {@link McpAnalyticsService}, swallowing any failure so
+     * a faulty analytics implementation can never break tool dispatch (fail-soft, matching the
+     * visibility-predicate guards above).
+     *
+     * @param event - The MCP analytics event to forward.
+     */ key: "_emitMcpAnalytics",
+            value: function _emitMcpAnalytics(event) {
+                try {
+                    this._analyticsService.handleMcpAnalyticsEvent(event);
+                } catch (error) {
+                    this._logger.warn("MCP analytics handler threw for tool ".concat(event.toolName, "; ignoring: ").concat(error.message));
+                }
+            }
+        },
         {
             key: "_handleStaticToolCall",
             value: function _handleStaticToolCall(staticHandler, args, ctx) {
                 return _async_to_generator$2(function() {
-                    var response, error;
+                    var outcome, _tmp, error;
                     return _ts_generator$2(this, function(_state) {
                         switch(_state.label){
                             case 0:
@@ -2953,19 +3048,23 @@ var McpServerFactoryService_1;
                                     ,
                                     3
                                 ]);
+                                _tmp = {};
                                 return [
                                     4,
                                     staticHandler(args, ctx)
                                 ];
                             case 1:
-                                response = _state.sent();
+                                outcome = (_tmp.response = _state.sent(), _tmp);
                                 return [
                                     3,
                                     3
                                 ];
                             case 2:
                                 error = _state.sent();
-                                response = formatMcpToolErrorResponse(error);
+                                outcome = {
+                                    response: formatMcpToolErrorResponse(error),
+                                    error: error
+                                };
                                 return [
                                     3,
                                     3
@@ -2973,7 +3072,7 @@ var McpServerFactoryService_1;
                             case 3:
                                 return [
                                     2,
-                                    response
+                                    outcome
                                 ];
                         }
                     });
@@ -2984,7 +3083,7 @@ var McpServerFactoryService_1;
             key: "_handleCallModelToolCall",
             value: function _handleCallModelToolCall(definition, args, ctx) {
                 return _async_to_generator$2(function() {
-                    var params, response, result, error;
+                    var params, outcome, result, error;
                     return _ts_generator$2(this, function(_state) {
                         switch(_state.label){
                             case 0:
@@ -3008,14 +3107,19 @@ var McpServerFactoryService_1;
                                 ];
                             case 2:
                                 result = _state.sent();
-                                response = formatMcpToolResponse(result, params, definition.details);
+                                outcome = {
+                                    response: formatMcpToolResponse(result, params, definition.details)
+                                };
                                 return [
                                     3,
                                     4
                                 ];
                             case 3:
                                 error = _state.sent();
-                                response = formatMcpToolErrorResponse(error);
+                                outcome = {
+                                    response: formatMcpToolErrorResponse(error),
+                                    error: error
+                                };
                                 return [
                                     3,
                                     4
@@ -3023,7 +3127,7 @@ var McpServerFactoryService_1;
                             case 4:
                                 return [
                                     2,
-                                    response
+                                    outcome
                                 ];
                         }
                     });
@@ -3040,7 +3144,9 @@ McpServerFactoryService = McpServerFactoryService_1 = __decorate([
     __param(2, Optional()),
     __param(2, Inject(ModelApiGetService)),
     __param(3, Optional()),
-    __param(3, Inject(MCP_AUTH_ROLE_READER))
+    __param(3, Inject(MCP_AUTH_ROLE_READER)),
+    __param(4, Optional()),
+    __param(4, Inject(MCP_ANALYTICS_SERVICE))
 ], McpServerFactoryService);
 
 function asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, key, arg) {
@@ -3248,12 +3354,12 @@ function _async_to_generator(fn) {
         });
     };
 }
-function _class_call_check$1(instance, Constructor) {
+function _class_call_check$2(instance, Constructor) {
     if (!(instance instanceof Constructor)) {
         throw new TypeError("Cannot call a class as a function");
     }
 }
-function _defineProperties$1(target, props) {
+function _defineProperties$2(target, props) {
     for(var i = 0; i < props.length; i++){
         var descriptor = props[i];
         descriptor.enumerable = descriptor.enumerable || false;
@@ -3262,11 +3368,11 @@ function _defineProperties$1(target, props) {
         Object.defineProperty(target, descriptor.key, descriptor);
     }
 }
-function _create_class$1(Constructor, protoProps, staticProps) {
-    if (protoProps) _defineProperties$1(Constructor.prototype, protoProps);
+function _create_class$2(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties$2(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property$1(obj, key, value) {
+function _define_property$2(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -3391,12 +3497,12 @@ var McpController_1;
  * be layered on later if streaming tool output becomes a requirement.
  */ var McpController = McpController_1 = /*#__PURE__*/ function() {
     function McpController(factory) {
-        _class_call_check$1(this, McpController);
-        _define_property$1(this, "factory", void 0);
-        _define_property$1(this, "_logger", new Logger(McpController_1.name));
+        _class_call_check$2(this, McpController);
+        _define_property$2(this, "factory", void 0);
+        _define_property$2(this, "_logger", new Logger(McpController_1.name));
         this.factory = factory;
     }
-    _create_class$1(McpController, [
+    _create_class$2(McpController, [
         {
             key: "handleMcpRequest",
             value: function handleMcpRequest(req, res) {
@@ -3463,12 +3569,12 @@ McpController = McpController_1 = __decorate([
     __param(0, Inject(McpServerFactoryService))
 ], McpController);
 
-function _class_call_check(instance, Constructor) {
+function _class_call_check$1(instance, Constructor) {
     if (!(instance instanceof Constructor)) {
         throw new TypeError("Cannot call a class as a function");
     }
 }
-function _defineProperties(target, props) {
+function _defineProperties$1(target, props) {
     for(var i = 0; i < props.length; i++){
         var descriptor = props[i];
         descriptor.enumerable = descriptor.enumerable || false;
@@ -3477,11 +3583,11 @@ function _defineProperties(target, props) {
         Object.defineProperty(target, descriptor.key, descriptor);
     }
 }
-function _create_class(Constructor, protoProps, staticProps) {
-    if (protoProps) _defineProperties(Constructor.prototype, protoProps);
+function _create_class$1(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties$1(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property(obj, key, value) {
+function _define_property$1(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -3505,11 +3611,11 @@ function _define_property(obj, key, value) {
  * in `firebase-server/oidc` for the corresponding OIDC excludes).
  */ var McpWellKnownController = /*#__PURE__*/ function() {
     function McpWellKnownController(mcpConfig) {
-        _class_call_check(this, McpWellKnownController);
-        _define_property(this, "mcpConfig", void 0);
+        _class_call_check$1(this, McpWellKnownController);
+        _define_property$1(this, "mcpConfig", void 0);
         this.mcpConfig = mcpConfig;
     }
-    _create_class(McpWellKnownController, [
+    _create_class$1(McpWellKnownController, [
         {
             key: "getProtectedResourceMetadata",
             value: function getProtectedResourceMetadata() {
@@ -3532,30 +3638,30 @@ McpWellKnownController = __decorate([
     __param(0, Inject(McpModuleConfig))
 ], McpWellKnownController);
 
-function _array_like_to_array(arr, len) {
+function _array_like_to_array$1(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_without_holes(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array(arr);
+function _array_without_holes$1(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$1(arr);
 }
-function _iterable_to_array(iter) {
+function _iterable_to_array$1(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _non_iterable_spread() {
+function _non_iterable_spread$1() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _to_consumable_array(arr) {
-    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+function _to_consumable_array$1(arr) {
+    return _array_without_holes$1(arr) || _iterable_to_array$1(arr) || _unsupported_iterable_to_array$1(arr) || _non_iterable_spread$1();
 }
-function _unsupported_iterable_to_array(o, minLen) {
+function _unsupported_iterable_to_array$1(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$1(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$1(o, minLen);
 }
 /**
  * Routes the firebase-server/mcp module owns. Apps should exclude these from
@@ -3592,18 +3698,242 @@ function _unsupported_iterable_to_array(o, minLen) {
     return {
         imports: [
             dependencyModule
-        ].concat(_to_consumable_array(imports !== null && imports !== void 0 ? imports : [])),
+        ].concat(_to_consumable_array$1(imports !== null && imports !== void 0 ? imports : [])),
         controllers: [
             McpController,
             McpWellKnownController
         ],
         exports: [
             McpServerFactoryService
-        ].concat(_to_consumable_array(exports !== null && exports !== void 0 ? exports : [])),
+        ].concat(_to_consumable_array$1(exports !== null && exports !== void 0 ? exports : [])),
         providers: [
             McpServerFactoryService
-        ].concat(_to_consumable_array(providers !== null && providers !== void 0 ? providers : []))
+        ].concat(_to_consumable_array$1(providers !== null && providers !== void 0 ? providers : []))
+    };
+}
+
+/**
+ * Default analytics event name used by {@link FirebaseServerMcpAnalyticsService} when
+ * forwarding a completed MCP tool call to the downstream analytics pipeline.
+ */ var DEFAULT_MCP_ANALYTICS_EVENT_NAME = 'mcp-tool';
+/**
+ * NestJS injection token for the optional {@link FirebaseServerMcpAnalyticsConfig} provider.
+ *
+ * @example
+ * ```typescript
+ * @Module(appMcpAnalyticsModuleMetadata({ mcpAnalyticsConfig: { eventName: 'mcp-tool', logEvents: true } }))
+ * export class AppMcpAnalyticsModule {}
+ * ```
+ */ var FIREBASE_SERVER_MCP_ANALYTICS_CONFIG = 'FIREBASE_SERVER_MCP_ANALYTICS_CONFIG';
+
+function _assert_this_initialized(self) {
+    if (self === void 0) {
+        throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
+    }
+    return self;
+}
+function _call_super(_this, derived, args) {
+    derived = _get_prototype_of(derived);
+    return _possible_constructor_return(_this, _is_native_reflect_construct() ? Reflect.construct(derived, [], _get_prototype_of(_this).constructor) : derived.apply(_this, args));
+}
+function _class_call_check(instance, Constructor) {
+    if (!(instance instanceof Constructor)) {
+        throw new TypeError("Cannot call a class as a function");
+    }
+}
+function _defineProperties(target, props) {
+    for(var i = 0; i < props.length; i++){
+        var descriptor = props[i];
+        descriptor.enumerable = descriptor.enumerable || false;
+        descriptor.configurable = true;
+        if ("value" in descriptor) descriptor.writable = true;
+        Object.defineProperty(target, descriptor.key, descriptor);
+    }
+}
+function _create_class(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties(Constructor.prototype, protoProps);
+    return Constructor;
+}
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _get_prototype_of(o) {
+    _get_prototype_of = Object.setPrototypeOf ? Object.getPrototypeOf : function getPrototypeOf(o) {
+        return o.__proto__ || Object.getPrototypeOf(o);
+    };
+    return _get_prototype_of(o);
+}
+function _inherits(subClass, superClass) {
+    if (typeof superClass !== "function" && superClass !== null) {
+        throw new TypeError("Super expression must either be null or a function");
+    }
+    subClass.prototype = Object.create(superClass && superClass.prototype, {
+        constructor: {
+            value: subClass,
+            writable: true,
+            configurable: true
+        }
+    });
+    if (superClass) _set_prototype_of(subClass, superClass);
+}
+function _possible_constructor_return(self, call) {
+    if (call && (_type_of(call) === "object" || typeof call === "function")) {
+        return call;
+    }
+    return _assert_this_initialized(self);
+}
+function _set_prototype_of(o, p) {
+    _set_prototype_of = Object.setPrototypeOf || function setPrototypeOf(o, p) {
+        o.__proto__ = p;
+        return o;
+    };
+    return _set_prototype_of(o, p);
+}
+function _type_of(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+function _is_native_reflect_construct() {
+    try {
+        var result = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function() {}));
+    } catch (_) {}
+    return (_is_native_reflect_construct = function() {
+        return !!result;
+    })();
+}
+var FirebaseServerMcpAnalyticsService_1;
+/**
+ * Reusable {@link McpAnalyticsService} that forwards each completed MCP tool call to the app's
+ * {@link FirebaseServerAnalyticsService}, so MCP-transport analytics feed the same downstream
+ * pipeline (e.g. Segment) as model analytics.
+ *
+ * Registered globally via {@link appMcpAnalyticsModuleMetadata}; tuned via
+ * {@link FirebaseServerMcpAnalyticsConfig}. When no analytics service is available the call is a
+ * no-op aside from the optional log line.
+ */ var FirebaseServerMcpAnalyticsService = FirebaseServerMcpAnalyticsService_1 = /*#__PURE__*/ function(McpAnalyticsService) {
+    _inherits(FirebaseServerMcpAnalyticsService, McpAnalyticsService);
+    function FirebaseServerMcpAnalyticsService(analyticsService, config) {
+        _class_call_check(this, FirebaseServerMcpAnalyticsService);
+        var _this;
+        var _ref, _ref1;
+        _this = _call_super(this, FirebaseServerMcpAnalyticsService), _define_property(_this, "analyticsService", void 0), _define_property(_this, "_logger", new Logger(FirebaseServerMcpAnalyticsService_1.name)), _define_property(_this, "_eventName", void 0), _define_property(_this, "_logEvents", void 0);
+        _this.analyticsService = analyticsService;
+        _this._eventName = (_ref = config === null || config === void 0 ? void 0 : config.eventName) !== null && _ref !== void 0 ? _ref : DEFAULT_MCP_ANALYTICS_EVENT_NAME;
+        _this._logEvents = (_ref1 = config === null || config === void 0 ? void 0 : config.logEvents) !== null && _ref1 !== void 0 ? _ref1 : true;
+        return _this;
+    }
+    _create_class(FirebaseServerMcpAnalyticsService, [
+        {
+            key: "handleMcpAnalyticsEvent",
+            value: function handleMcpAnalyticsEvent(event) {
+                if (this._logEvents) {
+                    var uidSuffix = event.uid ? " uid=".concat(event.uid) : '';
+                    var durationSuffix = event.durationMs != null ? " (".concat(event.durationMs, "ms)") : '';
+                    var outcome = event.isSuccessful ? 'Succeeded' : 'Failed';
+                    this._logger.log("MCP ".concat(event.toolName, " [").concat(event.toolKind, "] ").concat(outcome).concat(uidSuffix).concat(durationSuffix));
+                }
+                if (this.analyticsService != null) {
+                    var _event_call, _event_modelType, _event_specifier;
+                    this.analyticsService.sendEventData(event.uid, this._eventName, {
+                        tool: event.toolName,
+                        toolKind: event.toolKind,
+                        call: (_event_call = event.call) !== null && _event_call !== void 0 ? _event_call : '',
+                        modelType: (_event_modelType = event.modelType) !== null && _event_modelType !== void 0 ? _event_modelType : '',
+                        specifier: (_event_specifier = event.specifier) !== null && _event_specifier !== void 0 ? _event_specifier : '',
+                        success: event.isSuccessful
+                    });
+                }
+            }
+        }
+    ]);
+    return FirebaseServerMcpAnalyticsService;
+}(McpAnalyticsService);
+FirebaseServerMcpAnalyticsService = FirebaseServerMcpAnalyticsService_1 = __decorate([
+    Injectable(),
+    __param(0, Optional()),
+    __param(0, Inject(FirebaseServerAnalyticsService)),
+    __param(1, Optional()),
+    __param(1, Inject(FIREBASE_SERVER_MCP_ANALYTICS_CONFIG))
+], FirebaseServerMcpAnalyticsService);
+
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(arr);
+}
+function _iterable_to_array(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _non_iterable_spread() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+/**
+ * Generates NestJS module metadata that registers {@link FirebaseServerMcpAnalyticsService} as the
+ * MCP analytics consumer, aliased to {@link MCP_ANALYTICS_SERVICE}.
+ *
+ * Mirrors the convention used by `appAnalyticsModuleMetadata`. Unlike `mcpModuleMetadata`, this
+ * requires no dependency module — `FirebaseServerAnalyticsService` is resolved optionally and is
+ * expected to be supplied globally by the app's analytics module.
+ *
+ * Decorate a `@Global()` module with the result so the `MCP_ANALYTICS_SERVICE` token is visible to
+ * the `McpServerFactoryService` provided by the app's MCP module.
+ *
+ * @param config - Optional metadata + analytics config to merge in.
+ * @returns NestJS module metadata providing + exporting the MCP analytics service and token.
+ *
+ * @example
+ * ```typescript
+ * @Global()
+ * @Module(appMcpAnalyticsModuleMetadata())
+ * export class AppMcpAnalyticsModule {}
+ * ```
+ */ function appMcpAnalyticsModuleMetadata() {
+    var config = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
+    var mcpAnalyticsConfig = config.mcpAnalyticsConfig, imports = config.imports, exports = config.exports, providers = config.providers;
+    var configProviders = mcpAnalyticsConfig ? [
+        {
+            provide: FIREBASE_SERVER_MCP_ANALYTICS_CONFIG,
+            useValue: mcpAnalyticsConfig
+        }
+    ] : [];
+    return {
+        imports: _to_consumable_array(imports !== null && imports !== void 0 ? imports : []),
+        exports: [
+            MCP_ANALYTICS_SERVICE,
+            FirebaseServerMcpAnalyticsService
+        ].concat(_to_consumable_array(exports !== null && exports !== void 0 ? exports : [])),
+        providers: [
+            FirebaseServerMcpAnalyticsService,
+            {
+                provide: MCP_ANALYTICS_SERVICE,
+                useExisting: FirebaseServerMcpAnalyticsService
+            }
+        ].concat(_to_consumable_array(configProviders), _to_consumable_array(providers !== null && providers !== void 0 ? providers : []))
     };
 }
 
-export { DEFAULT_JSON_SCHEMA_GENERATION_OPTIONS, DEFAULT_MCP_PATH, DEFAULT_MCP_SERVER_NAME, DEFAULT_SPECIFIER_KEY, DEFAULT_VOID_MCP_SUCCESS_VALUE, FIREBASE_SERVER_MCP_ROUTES_FOR_GLOBAL_ROUTE_EXCLUDE, MCP_AUTH_ROLE_READER, MCP_MANIFEST_VERSION, MCP_MODEL_GET_BATCH_SIZE, MODEL_DECODE_DISPATCH_CALL, MODEL_DECODE_DISPATCH_MODEL_TYPE, MODEL_DECODE_TOOL_NAME, MODEL_GET_DISPATCH_CALL, MODEL_GET_DISPATCH_MODEL_TYPE, MODEL_GET_TOOL_NAME, MODEL_INFO_DISPATCH_CALL, MODEL_INFO_DISPATCH_MODEL_TYPE, MODEL_INFO_TOOL_NAME, McpController, McpModuleConfig, McpServerFactoryService, McpWellKnownController, buildDefaultMcpToolDescription, buildMcpToolName, buildStaticWireEntry, classifyVisibility, createModelDecodeTool, createModelGetTool, createModelInfoTool, decodeFirestoreModelKey, findModelEntry, formatMcpToolErrorResponse, formatMcpToolResponse, generateMcpToolDefinitions, handleStreamableHttpMcpRequest, mcpManifestKey, mcpModuleMetadata, resolveEffectiveReadOnly, resolveRequiredScope };
+export { DEFAULT_JSON_SCHEMA_GENERATION_OPTIONS, DEFAULT_MCP_ANALYTICS_EVENT_NAME, DEFAULT_MCP_PATH, DEFAULT_MCP_SERVER_INSTRUCTIONS, DEFAULT_MCP_SERVER_NAME, DEFAULT_SPECIFIER_KEY, DEFAULT_VOID_MCP_SUCCESS_VALUE, FIREBASE_SERVER_MCP_ANALYTICS_CONFIG, FIREBASE_SERVER_MCP_ROUTES_FOR_GLOBAL_ROUTE_EXCLUDE, FirebaseServerMcpAnalyticsService, MCP_ANALYTICS_SERVICE, MCP_AUTH_ROLE_READER, MCP_MANIFEST_VERSION, MCP_MODEL_GET_BATCH_SIZE, MODEL_DECODE_DISPATCH_CALL, MODEL_DECODE_DISPATCH_MODEL_TYPE, MODEL_DECODE_TOOL_NAME, MODEL_GET_DISPATCH_CALL, MODEL_GET_DISPATCH_MODEL_TYPE, MODEL_GET_TOOL_NAME, MODEL_INFO_DISPATCH_CALL, MODEL_INFO_DISPATCH_MODEL_TYPE, MODEL_INFO_TOOL_NAME, McpAnalyticsService, McpController, McpModuleConfig, McpServerFactoryService, McpWellKnownController, appMcpAnalyticsModuleMetadata, buildDefaultMcpToolDescription, buildMcpToolName, buildStaticWireEntry, classifyVisibility, createModelDecodeTool, createModelGetTool, createModelInfoTool, decodeFirestoreModelKey, findModelEntry, formatMcpToolErrorResponse, formatMcpToolResponse, generateMcpToolDefinitions, handleStreamableHttpMcpRequest, mcpManifestKey, mcpModuleMetadata, noopMcpAnalyticsService, resolveEffectiveReadOnly, resolveRequiredScope };