@posthog/mcp 0.5.0 → 0.6.0

package/README.md

@@ -7,3 +7,32 @@ SDK usage examples and code snippets live in the official documentation so they
 ## Documentation
 
 - [MCP analytics docs](https://posthog.com/docs/mcp-analytics)
+
+## Developing locally
+
+To test local changes in a consumer app (e.g. a dummy MCP server), symlink **both**
+`@posthog/mcp` and its `posthog-node` peer from this monorepo into the app — run from the
+app's directory:
+
+```bash
+mkdir -p node_modules/@posthog   # in case the app has no other @posthog/-scoped deps yet
+ln -s /absolute/path/to/posthog-js/packages/mcp  node_modules/@posthog/mcp
+ln -s /absolute/path/to/posthog-js/packages/node node_modules/posthog-node
+```
+
+Then keep a watch build running and restart the app after each change:
+
+```bash
+cd /absolute/path/to/posthog-js/packages/mcp && pnpm dev   # rebuilds dist/ on save
+
+# in the app (e.g. dummy mcp), after each rebuild:
+npm start                                                  # Node caches dist/ at startup, so restart to pick it up
+```
+
+- **`npm install` in the app replaces both symlinks with published copies** — re-create them if you run it.
+
+## Run tests
+
+```bash
+cd packages/mcp && pnpm test:unit
+```

package/dist/extensions/constants.d.ts

@@ -2,6 +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 PostHogMCPAnalyticsEvent: {
     readonly Custom: "$mcp_custom";
     readonly Exception: "$exception";
@@ -25,6 +26,8 @@ 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;AAInE,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"}
+{"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"}

package/dist/extensions/constants.js

@@ -28,6 +28,7 @@ __webpack_require__.d(__webpack_exports__, {
     DEFAULT_CONVERSATION_ID_DESCRIPTION: ()=>DEFAULT_CONVERSATION_ID_DESCRIPTION,
     INACTIVITY_TIMEOUT_IN_MINUTES: ()=>INACTIVITY_TIMEOUT_IN_MINUTES,
     POSTHOG_MCP_ANALYTICS_SOURCE: ()=>POSTHOG_MCP_ANALYTICS_SOURCE,
+    POSTHOG_MCP_LIB_NAME: ()=>POSTHOG_MCP_LIB_NAME,
     PostHogMCPAnalyticsEvent: ()=>PostHogMCPAnalyticsEvent,
     PostHogMCPAnalyticsProperty: ()=>PostHogMCPAnalyticsProperty
 });
@@ -35,6 +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 PostHogMCPAnalyticsEvent = {
     Custom: '$mcp_custom',
     Exception: '$exception',
@@ -57,6 +59,8 @@ 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',
@@ -72,6 +76,7 @@ exports.DEFAULT_CONTEXT_PARAMETER_DESCRIPTION = __webpack_exports__.DEFAULT_CONT
 exports.DEFAULT_CONVERSATION_ID_DESCRIPTION = __webpack_exports__.DEFAULT_CONVERSATION_ID_DESCRIPTION;
 exports.INACTIVITY_TIMEOUT_IN_MINUTES = __webpack_exports__.INACTIVITY_TIMEOUT_IN_MINUTES;
 exports.POSTHOG_MCP_ANALYTICS_SOURCE = __webpack_exports__.POSTHOG_MCP_ANALYTICS_SOURCE;
+exports.POSTHOG_MCP_LIB_NAME = __webpack_exports__.POSTHOG_MCP_LIB_NAME;
 exports.PostHogMCPAnalyticsEvent = __webpack_exports__.PostHogMCPAnalyticsEvent;
 exports.PostHogMCPAnalyticsProperty = __webpack_exports__.PostHogMCPAnalyticsProperty;
 for(var __webpack_i__ in __webpack_exports__)if (-1 === [
@@ -79,6 +84,7 @@ for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "DEFAULT_CONVERSATION_ID_DESCRIPTION",
     "INACTIVITY_TIMEOUT_IN_MINUTES",
     "POSTHOG_MCP_ANALYTICS_SOURCE",
+    "POSTHOG_MCP_LIB_NAME",
     "PostHogMCPAnalyticsEvent",
     "PostHogMCPAnalyticsProperty"
 ].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];

package/dist/extensions/constants.mjs

@@ -2,6 +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 PostHogMCPAnalyticsEvent = {
     Custom: '$mcp_custom',
     Exception: '$exception',
@@ -24,6 +25,8 @@ 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',
@@ -35,4 +38,4 @@ const PostHogMCPAnalyticsProperty = {
     ToolDescription: "$mcp_tool_description",
     ToolName: '$mcp_tool_name'
 };
-export { DEFAULT_CONTEXT_PARAMETER_DESCRIPTION, DEFAULT_CONVERSATION_ID_DESCRIPTION, INACTIVITY_TIMEOUT_IN_MINUTES, POSTHOG_MCP_ANALYTICS_SOURCE, PostHogMCPAnalyticsEvent, PostHogMCPAnalyticsProperty };
+export { DEFAULT_CONTEXT_PARAMETER_DESCRIPTION, DEFAULT_CONVERSATION_ID_DESCRIPTION, INACTIVITY_TIMEOUT_IN_MINUTES, POSTHOG_MCP_ANALYTICS_SOURCE, POSTHOG_MCP_LIB_NAME, PostHogMCPAnalyticsEvent, PostHogMCPAnalyticsProperty };

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;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"}
+{"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"}

package/dist/extensions/posthog-events.js

@@ -98,6 +98,7 @@ 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;
@@ -110,6 +111,12 @@ 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);
@@ -129,6 +136,7 @@ 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, PostHogMCPAnalyticsEvent, PostHogMCPAnalyticsProperty } from "./constants.mjs";
+import { POSTHOG_MCP_ANALYTICS_SOURCE, POSTHOG_MCP_LIB_NAME, PostHogMCPAnalyticsEvent, PostHogMCPAnalyticsProperty } from "./constants.mjs";
 import { MCPAnalyticsEventType } from "./event-types.mjs";
 const BUILT_IN_EVENT_NAME_BY_TYPE = {
     [MCPAnalyticsEventType.custom]: PostHogMCPAnalyticsEvent.Custom,
@@ -70,6 +70,7 @@ 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;
@@ -82,6 +83,12 @@ 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);
@@ -101,6 +108,7 @@ 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;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;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;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"}

package/dist/extensions/posthog-mcp.js

@@ -27,6 +27,7 @@ __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");
@@ -112,7 +113,8 @@ function baseEvent(eventType, common) {
         sessionId: common.sessionId,
         timestamp: common.timestamp ?? new Date(),
         properties: common.properties,
-        groups: common.groups
+        groups: common.groups,
+        sdkVersion: external_version_js_namespaceObject.version
     };
     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,4 +1,5 @@
 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";
@@ -84,7 +85,8 @@ function baseEvent(eventType, common) {
         sessionId: common.sessionId,
         timestamp: common.timestamp ?? new Date(),
         properties: common.properties,
-        groups: common.groups
+        groups: common.groups,
+        sdkVersion: version
     };
     if (common.distinctId) event.identifyActorGivenId = common.distinctId;
     if (common.setProperties && Object.keys(common.setProperties).length > 0) event.identifyActorData = common.setProperties;

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

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/extensions/session.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,6BAA6B,EAC7B,gBAAgB,EAChB,aAAa,EAEb,WAAW,EACZ,MAAM,UAAU,CAAA;AAKjB,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,6BAA6B,GAAG,MAAM,CAoCvG;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,CA8Bb"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/extensions/session.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,6BAA6B,EAC7B,gBAAgB,EAChB,aAAa,EAEb,WAAW,EACZ,MAAM,UAAU,CAAA;AAKjB,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,6BAA6B,GAAG,MAAM,CAoCvG;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,CAgCb"}

package/dist/extensions/session.js

@@ -73,11 +73,11 @@ function setLastActivity(server) {
     (0, external_internal_js_namespaceObject.setServerTrackingData)(server, data);
 }
 function getSessionInfo(server, data, sessionId) {
-    let clientInfo = {
-        name: void 0,
-        version: void 0
-    };
-    if (!data?.sessionInfo.clientName) clientInfo = server.getClientVersion();
+    let clientInfo;
+    clientInfo = data?.sessionInfo.clientName ? {
+        name: data.sessionInfo.clientName,
+        version: data.sessionInfo.clientVersion
+    } : server.getClientVersion();
     const actorInfo = data?.identifiedSessions.get(sessionId ?? data.sessionId);
     const sessionInfo = {
         ipAddress: void 0,

package/dist/extensions/session.mjs

@@ -41,11 +41,11 @@ function setLastActivity(server) {
     setServerTrackingData(server, data);
 }
 function getSessionInfo(server, data, sessionId) {
-    let clientInfo = {
-        name: void 0,
-        version: void 0
-    };
-    if (!data?.sessionInfo.clientName) clientInfo = server.getClientVersion();
+    let clientInfo;
+    clientInfo = data?.sessionInfo.clientName ? {
+        name: data.sessionInfo.clientName,
+        version: data.sessionInfo.clientVersion
+    } : server.getClientVersion();
     const actorInfo = data?.identifiedSessions.get(sessionId ?? data.sessionId);
     const sessionInfo = {
         ipAddress: void 0,

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "0.5.0";
+export declare const version = "0.6.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.5.0';
+const version = '0.6.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.5.0';
+const version = '0.6.0';
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/mcp",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "bugs": {
     "url": "https://github.com/PostHog/posthog-js/issues"
   },
@@ -28,7 +28,7 @@
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
   "dependencies": {
-    "@posthog/core": "^1.38.0"
+    "@posthog/core": "^1.39.1"
   },
   "devDependencies": {
     "@babel/preset-env": "^7.27.1",
@@ -39,8 +39,8 @@
     "@types/node": "^20.0.0",
     "jest": "29.7.0",
     "zod": "^3.25.0",
-    "posthog-node": "^5.38.6",
-    "@posthog-tooling/tsconfig-base": "1.1.1"
+    "@posthog-tooling/tsconfig-base": "1.1.1",
+    "posthog-node": "^5.39.0"
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": ">=1.26.0",

package/src/extensions/constants.ts

@@ -11,6 +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'
+
 // All PostHog-owned event names start with `$` per the PostHog convention.
 // Non-`$` names would be treated as customer-defined events and confuse the schema.
 export const PostHogMCPAnalyticsEvent = {
@@ -38,6 +43,8 @@ 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/posthog-events.ts

@@ -3,7 +3,12 @@
 // 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, PostHogMCPAnalyticsEvent, PostHogMCPAnalyticsProperty } from './constants'
+import {
+  POSTHOG_MCP_ANALYTICS_SOURCE,
+  POSTHOG_MCP_LIB_NAME,
+  PostHogMCPAnalyticsEvent,
+  PostHogMCPAnalyticsProperty,
+} from './constants'
 import { MCPAnalyticsEventType } from './event-types'
 
 const BUILT_IN_EVENT_NAME_BY_TYPE = {
@@ -150,6 +155,7 @@ 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
   }
@@ -181,6 +187,18 @@ 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)
@@ -221,6 +239,7 @@ 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,5 +1,6 @@
 import { PostHog, type PostHogOptions } from 'posthog-node'
 
+import { version } from '../version'
 import type {
   InitializeCaptureData,
   JsonRecord,
@@ -241,6 +242,7 @@ 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/extensions/session.ts

@@ -89,11 +89,13 @@ export function getSessionInfo(
   data: MCPAnalyticsData | undefined,
   sessionId?: string
 ): SessionInfo {
-  let clientInfo: ServerClientInfoLike | undefined = {
-    name: undefined,
-    version: undefined,
-  }
-  if (!data?.sessionInfo.clientName) {
+  let clientInfo: ServerClientInfoLike | undefined
+  if (data?.sessionInfo.clientName) {
+    clientInfo = {
+      name: data.sessionInfo.clientName,
+      version: data.sessionInfo.clientVersion,
+    }
+  } else {
     clientInfo = server.getClientVersion()
   }
   const actorInfo = data?.identifiedSessions.get(sessionId ?? data.sessionId)

package/src/version.ts

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