@posthog/mcp 0.4.4 → 0.5.0

package/dist/index.d.ts

@@ -28,6 +28,25 @@ import type { McpAnalytics, MCPAnalyticsOptions } from './types';
  * ```
  */
 declare function instrument(server: unknown, posthog: PostHog, options?: MCPAnalyticsOptions): McpAnalytics;
+/**
+ * A point-free `(server) => server` helper for framework server-mutation hooks (e.g.
+ * `@rekog/mcp-nest`'s `serverMutator`). It instruments the server and returns it, so you
+ * don't trip over {@link instrument} returning the analytics handle rather than the server —
+ * the bare `(s) => instrument(s, posthog)` would replace the server with the handle.
+ *
+ * @example
+ * ```ts
+ * McpModule.forRoot({ serverMutator: instrumentMutator(posthog) })
+ * ```
+ *
+ * Need the handle for custom events? Call {@link instrument} directly inside your own mutator
+ * and return the server. See https://posthog.com/docs/mcp-analytics/installation.
+ *
+ * @param posthog - A `posthog-node` client you construct and own.
+ * @param options - Optional configuration. See `MCPAnalyticsOptions`.
+ * @returns A `(server) => server` mutator that instruments the server and returns it.
+ */
+declare function instrumentMutator<TServer>(posthog: PostHog, options?: MCPAnalyticsOptions): (server: TServer) => TServer;
 export { deriveSessionIdFromMCPSession };
 export { POSTHOG_MCP_ANALYTICS_SOURCE, PostHogMCPAnalyticsEvent, PostHogMCPAnalyticsProperty, } from './extensions/constants';
 export { PostHogMCP, type PostHogMCPOptions } from './extensions/posthog-mcp';
@@ -36,5 +55,5 @@ export { setLogger } from './extensions/logger';
 export { PostHog, type PostHogOptions } from 'posthog-node';
 export type { BeforeSendFn, CaptureEventData, InitializeCaptureData, McpAnalytics, McpCaptureCommon, MCPAnalyticsContextOptions, MCPAnalyticsIntentSource, MCPAnalyticsOptions, MissingCapabilityCaptureData, PreparedToolCall, PrepareToolListOptions, ToolCallCaptureData, ToolsListCaptureData, UserIdentity, } from './types';
 export type IdentifyFunction = MCPAnalyticsOptions['identify'];
-export { instrument };
+export { instrument, instrumentMutator };
 //# sourceMappingURL=index.d.ts.map

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

package/dist/index.js

@@ -29,6 +29,7 @@ __webpack_require__.d(__webpack_exports__, {
     deriveSessionIdFromMCPSession: ()=>session_js_namespaceObject.deriveSessionIdFromMCPSession,
     POSTHOG_MCP_ANALYTICS_SOURCE: ()=>constants_js_namespaceObject.POSTHOG_MCP_ANALYTICS_SOURCE,
     instrument: ()=>instrument,
+    instrumentMutator: ()=>instrumentMutator,
     setLogger: ()=>logger_js_namespaceObject.setLogger,
     PostHogMCPAnalyticsEvent: ()=>constants_js_namespaceObject.PostHogMCPAnalyticsEvent,
     getMoreToolsResult: ()=>tools_js_namespaceObject.getMoreToolsResult,
@@ -69,6 +70,12 @@ function instrument(server, posthog, options = {}) {
         };
     }
 }
+function instrumentMutator(posthog, options) {
+    return (server)=>{
+        instrument(server, posthog, options);
+        return server;
+    };
+}
 function createAnalyticsHandle(lowLevelServer) {
     return {
         capture: (eventData)=>captureCustomEvent(lowLevelServer, eventData)
@@ -131,6 +138,7 @@ exports.PostHogMCPAnalyticsProperty = __webpack_exports__.PostHogMCPAnalyticsPro
 exports.deriveSessionIdFromMCPSession = __webpack_exports__.deriveSessionIdFromMCPSession;
 exports.getMoreToolsResult = __webpack_exports__.getMoreToolsResult;
 exports.instrument = __webpack_exports__.instrument;
+exports.instrumentMutator = __webpack_exports__.instrumentMutator;
 exports.setLogger = __webpack_exports__.setLogger;
 for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "POSTHOG_MCP_ANALYTICS_SOURCE",
@@ -141,6 +149,7 @@ for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "deriveSessionIdFromMCPSession",
     "getMoreToolsResult",
     "instrument",
+    "instrumentMutator",
     "setLogger"
 ].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
 Object.defineProperty(exports, '__esModule', {

package/dist/index.mjs

@@ -33,6 +33,12 @@ function instrument(server, posthog, options = {}) {
         };
     }
 }
+function instrumentMutator(posthog, options) {
+    return (server)=>{
+        instrument(server, posthog, options);
+        return server;
+    };
+}
 function createAnalyticsHandle(lowLevelServer) {
     return {
         capture: (eventData)=>captureCustomEvent(lowLevelServer, eventData)
@@ -87,4 +93,4 @@ async function captureCustomEvent(lowLevelServer, eventData) {
     await captureEvent(lowLevelServer, event);
     log(`Captured event "${eventData.event}" for session ${trackingData.sessionId}`);
 }
-export { POSTHOG_MCP_ANALYTICS_SOURCE, PostHog, PostHogMCP, PostHogMCPAnalyticsEvent, PostHogMCPAnalyticsProperty, deriveSessionIdFromMCPSession, getMoreToolsResult, instrument, setLogger };
+export { POSTHOG_MCP_ANALYTICS_SOURCE, PostHog, PostHogMCP, PostHogMCPAnalyticsEvent, PostHogMCPAnalyticsProperty, deriveSessionIdFromMCPSession, getMoreToolsResult, instrument, instrumentMutator, setLogger };

package/dist/version.d.ts

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

package/package.json

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

package/src/index.ts

@@ -79,6 +79,31 @@ function instrument(server: unknown, posthog: PostHog, options: MCPAnalyticsOpti
   }
 }
 
+/**
+ * A point-free `(server) => server` helper for framework server-mutation hooks (e.g.
+ * `@rekog/mcp-nest`'s `serverMutator`). It instruments the server and returns it, so you
+ * don't trip over {@link instrument} returning the analytics handle rather than the server —
+ * the bare `(s) => instrument(s, posthog)` would replace the server with the handle.
+ *
+ * @example
+ * ```ts
+ * McpModule.forRoot({ serverMutator: instrumentMutator(posthog) })
+ * ```
+ *
+ * Need the handle for custom events? Call {@link instrument} directly inside your own mutator
+ * and return the server. See https://posthog.com/docs/mcp-analytics/installation.
+ *
+ * @param posthog - A `posthog-node` client you construct and own.
+ * @param options - Optional configuration. See `MCPAnalyticsOptions`.
+ * @returns A `(server) => server` mutator that instruments the server and returns it.
+ */
+function instrumentMutator<TServer>(posthog: PostHog, options?: MCPAnalyticsOptions): (server: TServer) => TServer {
+  return (server: TServer): TServer => {
+    instrument(server, posthog, options)
+    return server
+  }
+}
+
 function createAnalyticsHandle(lowLevelServer: MCPServerLike): McpAnalytics {
   return {
     capture: (eventData) => captureCustomEvent(lowLevelServer, eventData),
@@ -190,4 +215,4 @@ export type {
   UserIdentity,
 } from './types'
 export type IdentifyFunction = MCPAnalyticsOptions['identify']
-export { instrument }
+export { instrument, instrumentMutator }

package/src/version.ts

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