@posthog/mcp 0.6.0 → 0.7.0

package/dist/extensions/constants.d.ts

@@ -2,7 +2,7 @@ export declare const INACTIVITY_TIMEOUT_IN_MINUTES = 30;
 export declare const DEFAULT_CONTEXT_PARAMETER_DESCRIPTION = "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\"";
 export declare const DEFAULT_CONVERSATION_ID_DESCRIPTION = "Echo the conversation_id from the server's previous response. The server provides it on the first call \u2014 never invent one, and do not issue parallel tool calls until you have it.";
 export declare const POSTHOG_MCP_ANALYTICS_SOURCE = "posthog_mcp_analytics";
-export declare const POSTHOG_MCP_LIB_NAME = "@posthog/mcp";
+export declare const POSTHOG_MCP_LIB_NAME = "posthog-node-mcp";
 export declare const PostHogMCPAnalyticsEvent: {
     readonly Custom: "$mcp_custom";
     readonly Exception: "$exception";
@@ -26,8 +26,6 @@ export declare const PostHogMCPAnalyticsProperty: {
     readonly Intent: "$mcp_intent";
     readonly IntentSource: "$mcp_intent_source";
     readonly ListedToolNames: "$mcp_listed_tool_names";
-    readonly McpLib: "$mcp_lib";
-    readonly McpLibVersion: "$mcp_lib_version";
     readonly Parameters: "$mcp_parameters";
     readonly ResourceName: "$mcp_resource_name";
     readonly Response: "$mcp_response";

package/dist/extensions/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/extensions/constants.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,6BAA6B,KAAK,CAAA;AAE/C,eAAO,MAAM,qCAAqC,2hBAAyhB,CAAA;AAE3kB,eAAO,MAAM,mCAAmC,4LACsI,CAAA;AAEtL,eAAO,MAAM,4BAA4B,0BAA0B,CAAA;AAKnE,eAAO,MAAM,oBAAoB,iBAAiB,CAAA;AAIlD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;CAY3B,CAAA;AAEV,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAA;AAE/G,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;CAqB9B,CAAA;AAEV,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/extensions/constants.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,6BAA6B,KAAK,CAAA;AAE/C,eAAO,MAAM,qCAAqC,2hBAAyhB,CAAA;AAE3kB,eAAO,MAAM,mCAAmC,4LACsI,CAAA;AAEtL,eAAO,MAAM,4BAA4B,0BAA0B,CAAA;AAMnE,eAAO,MAAM,oBAAoB,qBAAqB,CAAA;AAItD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;CAY3B,CAAA;AAEV,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAA;AAE/G,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;CAmB9B,CAAA;AAEV,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAA"}

package/dist/extensions/constants.js

@@ -36,7 +36,7 @@ const INACTIVITY_TIMEOUT_IN_MINUTES = 30;
 const DEFAULT_CONTEXT_PARAMETER_DESCRIPTION = "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\"";
 const DEFAULT_CONVERSATION_ID_DESCRIPTION = "Echo the conversation_id from the server's previous response. The server provides it on the first call \u2014 never invent one, and do not issue parallel tool calls until you have it.";
 const POSTHOG_MCP_ANALYTICS_SOURCE = 'posthog_mcp_analytics';
-const POSTHOG_MCP_LIB_NAME = '@posthog/mcp';
+const POSTHOG_MCP_LIB_NAME = 'posthog-node-mcp';
 const PostHogMCPAnalyticsEvent = {
     Custom: '$mcp_custom',
     Exception: '$exception',
@@ -59,8 +59,6 @@ const PostHogMCPAnalyticsProperty = {
     Intent: '$mcp_intent',
     IntentSource: '$mcp_intent_source',
     ListedToolNames: '$mcp_listed_tool_names',
-    McpLib: '$mcp_lib',
-    McpLibVersion: '$mcp_lib_version',
     Parameters: '$mcp_parameters',
     ResourceName: '$mcp_resource_name',
     Response: '$mcp_response',

package/dist/extensions/constants.mjs

@@ -2,7 +2,7 @@ const INACTIVITY_TIMEOUT_IN_MINUTES = 30;
 const DEFAULT_CONTEXT_PARAMETER_DESCRIPTION = "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\"";
 const DEFAULT_CONVERSATION_ID_DESCRIPTION = "Echo the conversation_id from the server's previous response. The server provides it on the first call \u2014 never invent one, and do not issue parallel tool calls until you have it.";
 const POSTHOG_MCP_ANALYTICS_SOURCE = 'posthog_mcp_analytics';
-const POSTHOG_MCP_LIB_NAME = '@posthog/mcp';
+const POSTHOG_MCP_LIB_NAME = 'posthog-node-mcp';
 const PostHogMCPAnalyticsEvent = {
     Custom: '$mcp_custom',
     Exception: '$exception',
@@ -25,8 +25,6 @@ const PostHogMCPAnalyticsProperty = {
     Intent: '$mcp_intent',
     IntentSource: '$mcp_intent_source',
     ListedToolNames: '$mcp_listed_tool_names',
-    McpLib: '$mcp_lib',
-    McpLibVersion: '$mcp_lib_version',
     Parameters: '$mcp_parameters',
     ResourceName: '$mcp_resource_name',
     Response: '$mcp_response',

package/dist/extensions/lib-identity.d.ts

@@ -0,0 +1,19 @@
+import type { PostHog } from 'posthog-node';
+/**
+ * Make `client` report `@posthog/mcp`'s identity as the standard PostHog `$lib`
+ * / `$lib_version` on every event it sends.
+ *
+ * posthog-node stamps `$lib` / `$lib_version` from `getLibraryId()` /
+ * `getLibraryVersion()` and spreads them *last* when building the payload, so
+ * they can't be overridden per-event via the captured properties (nor via
+ * `before_send`, which runs earlier). Overriding the two methods is the only
+ * lever. Shared by {@link PostHogMCP} (which calls this in its constructor) and
+ * `instrument()` (which applies it to the host-supplied client) so both emit
+ * paths report identical lib metadata.
+ *
+ * Because `$lib` is a client-level property, this relabels *every* event the
+ * client sends as `posthog-node-mcp`, not just `$mcp_*` events — expected for a
+ * dedicated MCP-analytics client.
+ */
+export declare function applyMcpLibIdentity(client: PostHog): void;
+//# sourceMappingURL=lib-identity.d.ts.map

package/dist/extensions/lib-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib-identity.d.ts","sourceRoot":"","sources":["../../src/extensions/lib-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAK3C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAGzD"}

package/dist/extensions/lib-identity.js

@@ -0,0 +1,41 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    applyMcpLibIdentity: ()=>applyMcpLibIdentity
+});
+const external_version_js_namespaceObject = require("../version.js");
+const external_constants_js_namespaceObject = require("./constants.js");
+function applyMcpLibIdentity(client) {
+    client.getLibraryId = ()=>external_constants_js_namespaceObject.POSTHOG_MCP_LIB_NAME;
+    client.getLibraryVersion = ()=>external_version_js_namespaceObject.version;
+}
+exports.applyMcpLibIdentity = __webpack_exports__.applyMcpLibIdentity;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "applyMcpLibIdentity"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/extensions/lib-identity.mjs

@@ -0,0 +1,7 @@
+import { version } from "../version.mjs";
+import { POSTHOG_MCP_LIB_NAME } from "./constants.mjs";
+function applyMcpLibIdentity(client) {
+    client.getLibraryId = ()=>POSTHOG_MCP_LIB_NAME;
+    client.getLibraryVersion = ()=>version;
+}
+export { applyMcpLibIdentity };

package/dist/extensions/posthog-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"posthog-events.d.ts","sourceRoot":"","sources":["../../src/extensions/posthog-events.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AA8BrC,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,SAAS,CAAA;CAChB;AAED,MAAM,WAAW,gCAAgC;IAC/C,2FAA2F;IAC3F,0BAA0B,CAAC,EAAE,OAAO,CAAA;CACrC;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,gCAAqC,GAC7C,mBAAmB,EAAE,CAQvB"}
+{"version":3,"file":"posthog-events.d.ts","sourceRoot":"","sources":["../../src/extensions/posthog-events.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAyBrC,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,SAAS,CAAA;CAChB;AAED,MAAM,WAAW,gCAAgC;IAC/C,2FAA2F;IAC3F,0BAA0B,CAAC,EAAE,OAAO,CAAA;CACrC;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,gCAAqC,GAC7C,mBAAmB,EAAE,CAQvB"}

package/dist/extensions/posthog-events.js

@@ -98,7 +98,6 @@ function addCommonEventProperties(event, properties) {
     if (event.serverVersion) properties[external_constants_js_namespaceObject.PostHogMCPAnalyticsProperty.ServerVersion] = event.serverVersion;
     if (event.clientName) properties[external_constants_js_namespaceObject.PostHogMCPAnalyticsProperty.ClientName] = event.clientName;
     if (event.clientVersion) properties[external_constants_js_namespaceObject.PostHogMCPAnalyticsProperty.ClientVersion] = event.clientVersion;
-    addMcpLibProperties(event, properties);
     if (event.userIntent) properties[external_constants_js_namespaceObject.PostHogMCPAnalyticsProperty.Intent] = event.userIntent;
     if (event.userIntentSource) properties[external_constants_js_namespaceObject.PostHogMCPAnalyticsProperty.IntentSource] = event.userIntentSource;
     if (void 0 !== event.isError) properties[external_constants_js_namespaceObject.PostHogMCPAnalyticsProperty.IsError] = event.isError;
@@ -111,12 +110,6 @@ function addCommonEventProperties(event, properties) {
 function addCustomEventProperties(event, properties) {
     if (event.properties) for (const [key, value] of Object.entries(event.properties))properties[key] = value;
 }
-function addMcpLibProperties(event, properties) {
-    if (event.sdkVersion) {
-        properties[external_constants_js_namespaceObject.PostHogMCPAnalyticsProperty.McpLib] = external_constants_js_namespaceObject.POSTHOG_MCP_LIB_NAME;
-        properties[external_constants_js_namespaceObject.PostHogMCPAnalyticsProperty.McpLibVersion] = event.sdkVersion;
-    }
-}
 function buildExceptionEvent(event) {
     const distinctId = getDistinctId(event);
     const timestamp = getTimestamp(event);
@@ -136,7 +129,6 @@ function buildExceptionEvent(event) {
     if (event.serverVersion) properties[external_constants_js_namespaceObject.PostHogMCPAnalyticsProperty.ServerVersion] = event.serverVersion;
     if (event.clientName) properties[external_constants_js_namespaceObject.PostHogMCPAnalyticsProperty.ClientName] = event.clientName;
     if (event.clientVersion) properties[external_constants_js_namespaceObject.PostHogMCPAnalyticsProperty.ClientVersion] = event.clientVersion;
-    addMcpLibProperties(event, properties);
     addCustomEventProperties(event, properties);
     return {
         event: external_constants_js_namespaceObject.PostHogMCPAnalyticsEvent.Exception,

package/dist/extensions/posthog-events.mjs

@@ -1,4 +1,4 @@
-import { POSTHOG_MCP_ANALYTICS_SOURCE, POSTHOG_MCP_LIB_NAME, PostHogMCPAnalyticsEvent, PostHogMCPAnalyticsProperty } from "./constants.mjs";
+import { POSTHOG_MCP_ANALYTICS_SOURCE, PostHogMCPAnalyticsEvent, PostHogMCPAnalyticsProperty } from "./constants.mjs";
 import { MCPAnalyticsEventType } from "./event-types.mjs";
 const BUILT_IN_EVENT_NAME_BY_TYPE = {
     [MCPAnalyticsEventType.custom]: PostHogMCPAnalyticsEvent.Custom,
@@ -70,7 +70,6 @@ function addCommonEventProperties(event, properties) {
     if (event.serverVersion) properties[PostHogMCPAnalyticsProperty.ServerVersion] = event.serverVersion;
     if (event.clientName) properties[PostHogMCPAnalyticsProperty.ClientName] = event.clientName;
     if (event.clientVersion) properties[PostHogMCPAnalyticsProperty.ClientVersion] = event.clientVersion;
-    addMcpLibProperties(event, properties);
     if (event.userIntent) properties[PostHogMCPAnalyticsProperty.Intent] = event.userIntent;
     if (event.userIntentSource) properties[PostHogMCPAnalyticsProperty.IntentSource] = event.userIntentSource;
     if (void 0 !== event.isError) properties[PostHogMCPAnalyticsProperty.IsError] = event.isError;
@@ -83,12 +82,6 @@ function addCommonEventProperties(event, properties) {
 function addCustomEventProperties(event, properties) {
     if (event.properties) for (const [key, value] of Object.entries(event.properties))properties[key] = value;
 }
-function addMcpLibProperties(event, properties) {
-    if (event.sdkVersion) {
-        properties[PostHogMCPAnalyticsProperty.McpLib] = POSTHOG_MCP_LIB_NAME;
-        properties[PostHogMCPAnalyticsProperty.McpLibVersion] = event.sdkVersion;
-    }
-}
 function buildExceptionEvent(event) {
     const distinctId = getDistinctId(event);
     const timestamp = getTimestamp(event);
@@ -108,7 +101,6 @@ function buildExceptionEvent(event) {
     if (event.serverVersion) properties[PostHogMCPAnalyticsProperty.ServerVersion] = event.serverVersion;
     if (event.clientName) properties[PostHogMCPAnalyticsProperty.ClientName] = event.clientName;
     if (event.clientVersion) properties[PostHogMCPAnalyticsProperty.ClientVersion] = event.clientVersion;
-    addMcpLibProperties(event, properties);
     addCustomEventProperties(event, properties);
     return {
         event: PostHogMCPAnalyticsEvent.Exception,

package/dist/extensions/posthog-mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"posthog-mcp.d.ts","sourceRoot":"","sources":["../../src/extensions/posthog-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAG3D,OAAO,KAAK,EACV,qBAAqB,EAIrB,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,UAAU,CAAA;AACjB,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,sBAAsB,CAAA;AAO7B;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,UAAW,SAAQ,OAAO;;gBAWzB,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB;IAK3D,8FAA8F;IAC9F,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;IAgBhD,iEAAiE;IACjE,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI;IAUpD;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAalD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,eAAe,CAAC,KAAK,SAAS,qBAAqB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,GAAE,sBAA2B,GAAG,KAAK,EAAE;IAYnH;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;IAW/E;;;;OAIG;IACH,wBAAwB,CAAC,IAAI,EAAE,4BAA4B,GAAG,IAAI;CAkBnE"}
+{"version":3,"file":"posthog-mcp.d.ts","sourceRoot":"","sources":["../../src/extensions/posthog-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAE3D,OAAO,KAAK,EACV,qBAAqB,EAIrB,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,UAAU,CAAA;AACjB,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,sBAAsB,CAAA;AAQ7B;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,UAAW,SAAQ,OAAO;;gBAWzB,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB;IAO3D,8FAA8F;IAC9F,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;IAgBhD,iEAAiE;IACjE,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI;IAUpD;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAalD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,eAAe,CAAC,KAAK,SAAS,qBAAqB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,GAAE,sBAA2B,GAAG,KAAK,EAAE;IAYnH;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;IAW/E;;;;OAIG;IACH,wBAAwB,CAAC,IAAI,EAAE,4BAA4B,GAAG,IAAI;CAkBnE"}

package/dist/extensions/posthog-mcp.js

@@ -27,10 +27,10 @@ __webpack_require__.d(__webpack_exports__, {
     PostHogMCP: ()=>PostHogMCP
 });
 const external_posthog_node_namespaceObject = require("posthog-node");
-const external_version_js_namespaceObject = require("../version.js");
 const external_context_parameters_js_namespaceObject = require("./context-parameters.js");
 const external_event_types_js_namespaceObject = require("./event-types.js");
 const external_exceptions_js_namespaceObject = require("./exceptions.js");
+const external_lib_identity_js_namespaceObject = require("./lib-identity.js");
 const external_logger_js_namespaceObject = require("./logger.js");
 const external_sink_js_namespaceObject = require("./sink.js");
 const external_tools_js_namespaceObject = require("./tools.js");
@@ -40,6 +40,7 @@ class PostHogMCP extends external_posthog_node_namespaceObject.PostHog {
     constructor(apiKey, options = {}){
         super(apiKey, options), this.#sink = new external_sink_js_namespaceObject.McpEventSink(this);
         this.#missingCapabilityToolName = options.missingCapabilityToolName ?? external_tools_js_namespaceObject.GET_MORE_TOOLS_NAME;
+        (0, external_lib_identity_js_namespaceObject.applyMcpLibIdentity)(this);
     }
     captureToolCall(data) {
         const event = baseEvent(external_event_types_js_namespaceObject.MCPAnalyticsEventType.mcpToolsCall, data);
@@ -113,8 +114,7 @@ function baseEvent(eventType, common) {
         sessionId: common.sessionId,
         timestamp: common.timestamp ?? new Date(),
         properties: common.properties,
-        groups: common.groups,
-        sdkVersion: external_version_js_namespaceObject.version
+        groups: common.groups
     };
     if (common.distinctId) event.identifyActorGivenId = common.distinctId;
     if (common.setProperties && Object.keys(common.setProperties).length > 0) event.identifyActorData = common.setProperties;

package/dist/extensions/posthog-mcp.mjs

@@ -1,8 +1,8 @@
 import { PostHog } from "posthog-node";
-import { version } from "../version.mjs";
 import { addContextParameterToTools, getContextDescription, isContextEnabled } from "./context-parameters.mjs";
 import { MCPAnalyticsEventType } from "./event-types.mjs";
 import { captureException } from "./exceptions.mjs";
+import { applyMcpLibIdentity } from "./lib-identity.mjs";
 import { log } from "./logger.mjs";
 import { McpEventSink } from "./sink.mjs";
 import { GET_MORE_TOOLS_NAME, getReportMissingToolDescriptor } from "./tools.mjs";
@@ -12,6 +12,7 @@ class PostHogMCP extends PostHog {
     constructor(apiKey, options = {}){
         super(apiKey, options), this.#sink = new McpEventSink(this);
         this.#missingCapabilityToolName = options.missingCapabilityToolName ?? GET_MORE_TOOLS_NAME;
+        applyMcpLibIdentity(this);
     }
     captureToolCall(data) {
         const event = baseEvent(MCPAnalyticsEventType.mcpToolsCall, data);
@@ -85,8 +86,7 @@ function baseEvent(eventType, common) {
         sessionId: common.sessionId,
         timestamp: common.timestamp ?? new Date(),
         properties: common.properties,
-        groups: common.groups,
-        sdkVersion: version
+        groups: common.groups
     };
     if (common.distinctId) event.identifyActorGivenId = common.distinctId;
     if (common.setProperties && Object.keys(common.setProperties).length > 0) event.identifyActorData = common.setProperties;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAO3C,OAAO,EAAE,6BAA6B,EAAgC,MAAM,sBAAsB,CAAA;AAGlG,OAAO,KAAK,EAGV,YAAY,EAEZ,mBAAmB,EAGpB,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,iBAAS,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,mBAAwB,GAAG,YAAY,CA6BtG;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,iBAAS,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAKjH;AAmFD,OAAO,EAAE,6BAA6B,EAAE,CAAA;AACxC,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAI/C,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAC3D,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,GACb,MAAM,SAAS,CAAA;AAChB,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAQ3C,OAAO,EAAE,6BAA6B,EAAgC,MAAM,sBAAsB,CAAA;AAGlG,OAAO,KAAK,EAGV,YAAY,EAEZ,mBAAmB,EAGpB,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,iBAAS,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAkCtG;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,iBAAS,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAKjH;AAmFD,OAAO,EAAE,6BAA6B,EAAE,CAAA;AACxC,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAI/C,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAC3D,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,GACb,MAAM,SAAS,CAAA;AAChB,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/index.js

@@ -41,6 +41,7 @@ const event_types_js_namespaceObject = require("./extensions/event-types.js");
 const internal_js_namespaceObject = require("./extensions/internal.js");
 const logger_js_namespaceObject = require("./extensions/logger.js");
 const capture_js_namespaceObject = require("./extensions/capture.js");
+const lib_identity_js_namespaceObject = require("./extensions/lib-identity.js");
 const session_js_namespaceObject = require("./extensions/session.js");
 const instrument_lowlevel_js_namespaceObject = require("./extensions/instrument-lowlevel.js");
 const instrument_highlevel_js_namespaceObject = require("./extensions/instrument-highlevel.js");
@@ -58,6 +59,7 @@ function instrument(server, posthog, options = {}) {
             (0, logger_js_namespaceObject.log)('instrument() - Server already instrumented, skipping initialization');
             return createAnalyticsHandle(lowLevelServer);
         }
+        if (posthog) (0, lib_identity_js_namespaceObject.applyMcpLibIdentity)(posthog);
         const sink = posthog ? new sink_js_namespaceObject.McpEventSink(posthog) : void 0;
         const mcpAnalyticsData = buildTrackingData(lowLevelServer, options, sink);
         (0, internal_js_namespaceObject.setServerTrackingData)(lowLevelServer, mcpAnalyticsData);

package/dist/index.mjs

@@ -4,6 +4,7 @@ import { MCPAnalyticsEventType } from "./extensions/event-types.mjs";
 import { IdentityCache, getServerTrackingData, setServerTrackingData } from "./extensions/internal.mjs";
 import { log, setLogger } from "./extensions/logger.mjs";
 import { captureEvent } from "./extensions/capture.mjs";
+import { applyMcpLibIdentity } from "./extensions/lib-identity.mjs";
 import { deriveSessionIdFromMCPSession, getSessionInfo, newSessionId } from "./extensions/session.mjs";
 import { instrumentLowLevelServer } from "./extensions/instrument-lowlevel.mjs";
 import { instrumentHighLevelServer } from "./extensions/instrument-highlevel.mjs";
@@ -21,6 +22,7 @@ function instrument(server, posthog, options = {}) {
             log('instrument() - Server already instrumented, skipping initialization');
             return createAnalyticsHandle(lowLevelServer);
         }
+        if (posthog) applyMcpLibIdentity(posthog);
         const sink = posthog ? new McpEventSink(posthog) : void 0;
         const mcpAnalyticsData = buildTrackingData(lowLevelServer, options, sink);
         setServerTrackingData(lowLevelServer, mcpAnalyticsData);

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "0.6.0";
+export declare const version = "0.7.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -26,7 +26,7 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     version: ()=>version
 });
-const version = '0.6.0';
+const version = '0.7.0';
 exports.version = __webpack_exports__.version;
 for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "version"

package/dist/version.mjs

@@ -1,2 +1,2 @@
-const version = '0.6.0';
+const version = '0.7.0';
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/mcp",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "bugs": {
     "url": "https://github.com/PostHog/posthog-js/issues"
   },

package/src/extensions/constants.ts

@@ -11,10 +11,11 @@ export const DEFAULT_CONVERSATION_ID_DESCRIPTION =
 
 export const POSTHOG_MCP_ANALYTICS_SOURCE = 'posthog_mcp_analytics'
 
-// Identifies the SDK that produced an `$mcp_*` event. Distinct from `$lib`
-// (posthog-node, the transport that actually sends the event) — this names the
-// higher-level analytics layer, mirroring `@posthog/ai`'s `$ai_lib`.
-export const POSTHOG_MCP_LIB_NAME = '@posthog/mcp'
+// The `$lib` identity stamped on every event @posthog/mcp sends. posthog-node
+// would otherwise report itself (`posthog-node`, the transport SDK); we override
+// `getLibraryId()` so MCP events self-identify the same way every other PostHog
+// SDK does. See `applyMcpLibIdentity` in `./lib-identity`.
+export const POSTHOG_MCP_LIB_NAME = 'posthog-node-mcp'
 
 // All PostHog-owned event names start with `$` per the PostHog convention.
 // Non-`$` names would be treated as customer-defined events and confuse the schema.
@@ -43,8 +44,6 @@ export const PostHogMCPAnalyticsProperty = {
   Intent: '$mcp_intent',
   IntentSource: '$mcp_intent_source',
   ListedToolNames: '$mcp_listed_tool_names',
-  McpLib: '$mcp_lib',
-  McpLibVersion: '$mcp_lib_version',
   Parameters: '$mcp_parameters',
   ResourceName: '$mcp_resource_name',
   Response: '$mcp_response',

package/src/extensions/lib-identity.ts

@@ -0,0 +1,25 @@
+import type { PostHog } from 'posthog-node'
+
+import { version } from '../version'
+import { POSTHOG_MCP_LIB_NAME } from './constants'
+
+/**
+ * Make `client` report `@posthog/mcp`'s identity as the standard PostHog `$lib`
+ * / `$lib_version` on every event it sends.
+ *
+ * posthog-node stamps `$lib` / `$lib_version` from `getLibraryId()` /
+ * `getLibraryVersion()` and spreads them *last* when building the payload, so
+ * they can't be overridden per-event via the captured properties (nor via
+ * `before_send`, which runs earlier). Overriding the two methods is the only
+ * lever. Shared by {@link PostHogMCP} (which calls this in its constructor) and
+ * `instrument()` (which applies it to the host-supplied client) so both emit
+ * paths report identical lib metadata.
+ *
+ * Because `$lib` is a client-level property, this relabels *every* event the
+ * client sends as `posthog-node-mcp`, not just `$mcp_*` events — expected for a
+ * dedicated MCP-analytics client.
+ */
+export function applyMcpLibIdentity(client: PostHog): void {
+  client.getLibraryId = () => POSTHOG_MCP_LIB_NAME
+  client.getLibraryVersion = () => version
+}

package/src/extensions/posthog-events.ts

@@ -3,12 +3,7 @@
 // Licensed under the MIT License: https://github.com/MCPCat/mcpcat-typescript-sdk/blob/main/LICENSE
 
 import type { Event } from '../types'
-import {
-  POSTHOG_MCP_ANALYTICS_SOURCE,
-  POSTHOG_MCP_LIB_NAME,
-  PostHogMCPAnalyticsEvent,
-  PostHogMCPAnalyticsProperty,
-} from './constants'
+import { POSTHOG_MCP_ANALYTICS_SOURCE, PostHogMCPAnalyticsEvent, PostHogMCPAnalyticsProperty } from './constants'
 import { MCPAnalyticsEventType } from './event-types'
 
 const BUILT_IN_EVENT_NAME_BY_TYPE = {
@@ -155,7 +150,6 @@ function addCommonEventProperties(event: Event, properties: Record<string, unkno
   if (event.clientVersion) {
     properties[PostHogMCPAnalyticsProperty.ClientVersion] = event.clientVersion
   }
-  addMcpLibProperties(event, properties)
   if (event.userIntent) {
     properties[PostHogMCPAnalyticsProperty.Intent] = event.userIntent
   }
@@ -187,18 +181,6 @@ function addCustomEventProperties(event: Event, properties: Record<string, unkno
   }
 }
 
-/**
- * Stamps the `@posthog/mcp` SDK identity (`$mcp_lib` / `$mcp_lib_version`) onto
- * the event. Shared by the regular and `$exception` builders so both report
- * which analytics SDK release produced the event.
- */
-function addMcpLibProperties(event: Event, properties: Record<string, unknown>): void {
-  if (event.sdkVersion) {
-    properties[PostHogMCPAnalyticsProperty.McpLib] = POSTHOG_MCP_LIB_NAME
-    properties[PostHogMCPAnalyticsProperty.McpLibVersion] = event.sdkVersion
-  }
-}
-
 function buildExceptionEvent(event: Event): PostHogCaptureEvent {
   const distinctId = getDistinctId(event)
   const timestamp = getTimestamp(event)
@@ -239,7 +221,6 @@ function buildExceptionEvent(event: Event): PostHogCaptureEvent {
   if (event.clientVersion) {
     properties[PostHogMCPAnalyticsProperty.ClientVersion] = event.clientVersion
   }
-  addMcpLibProperties(event, properties)
 
   addCustomEventProperties(event, properties)
 

package/src/extensions/posthog-mcp.ts

@@ -1,6 +1,5 @@
 import { PostHog, type PostHogOptions } from 'posthog-node'
 
-import { version } from '../version'
 import type {
   InitializeCaptureData,
   JsonRecord,
@@ -20,6 +19,7 @@ import {
 } from './context-parameters'
 import { MCPAnalyticsEventType } from './event-types'
 import { captureException } from './exceptions'
+import { applyMcpLibIdentity } from './lib-identity'
 import { log } from './logger'
 import { McpEventSink } from './sink'
 import { GET_MORE_TOOLS_NAME, getReportMissingToolDescriptor } from './tools'
@@ -85,6 +85,8 @@ export class PostHogMCP extends PostHog {
   constructor(apiKey: string, options: PostHogMCPOptions = {}) {
     super(apiKey, options)
     this.#missingCapabilityToolName = options.missingCapabilityToolName ?? GET_MORE_TOOLS_NAME
+    // Report `$lib: 'posthog-node-mcp'` instead of the inherited `posthog-node`.
+    applyMcpLibIdentity(this)
   }
 
   /** Capture a tool invocation. Emits `$mcp_tool_call` (+ an `$exception` sibling on error). */
@@ -242,7 +244,6 @@ function baseEvent(eventType: MCPAnalyticsEventType, common: McpCaptureCommon):
     timestamp: common.timestamp ?? new Date(),
     properties: common.properties,
     groups: common.groups,
-    sdkVersion: version,
   }
   if (common.distinctId) {
     event.identifyActorGivenId = common.distinctId

package/src/index.ts

@@ -9,6 +9,7 @@ import { MCPAnalyticsEventType } from './extensions/event-types'
 import { IdentityCache, getServerTrackingData, setServerTrackingData } from './extensions/internal'
 import { log, setLogger } from './extensions/logger'
 import { captureEvent } from './extensions/capture'
+import { applyMcpLibIdentity } from './extensions/lib-identity'
 import { deriveSessionIdFromMCPSession, getSessionInfo, newSessionId } from './extensions/session'
 import { instrumentLowLevelServer } from './extensions/instrument-lowlevel'
 import { instrumentHighLevelServer } from './extensions/instrument-highlevel'
@@ -65,6 +66,11 @@ function instrument(server: unknown, posthog: PostHog, options: MCPAnalyticsOpti
       return createAnalyticsHandle(lowLevelServer)
     }
 
+    if (posthog) {
+      // Report `$lib: 'posthog-node-mcp'` on this client's events instead of the
+      // inherited `posthog-node`. Relabels every event the client sends.
+      applyMcpLibIdentity(posthog)
+    }
     const sink = posthog ? new McpEventSink(posthog) : undefined
     const mcpAnalyticsData = buildTrackingData(lowLevelServer, options, sink)
 

package/src/version.ts

@@ -1 +1 @@
-export const version = '0.6.0'
+export const version = '0.7.0'