@posthog/mcp 0.0.7 → 0.0.9

package/LICENSE

@@ -1,6 +1,7 @@
 MIT License
 
-Copyright (c) 2025 MCPcat
+Copyright (c) 2025-2026 MCPcat
+Copyright (c) 2026 PostHog
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,11 +1,12 @@
-# PostHog MCP
+# PostHog MCP Analytics
 
-TypeScript SDK for instrumenting Model Context Protocol servers with PostHog analytics.
+TypeScript SDK for instrumenting Model Context Protocol (MCP) servers with PostHog analytics.
 
-> Warning:
+> [!WARNING]
 > This package is in very early access and is not suitable for production use yet.
 > The API, event names, PostHog property schema, tracing behavior, and release process may change without notice while we dogfood the SDK.
 > We publish in public because PostHog builds in public, but you should treat `0.0.x` releases as experimental.
+> We do no promise that this will eventually be shipped as a PostHog product. We are using it internally for our MCP for testing purposes.
 
 The initial goal is to help MCP server owners understand tool usage, agent intent, client/session metadata, errors, and feedback without hand-rolling MCP-specific analytics.
 
@@ -18,17 +19,17 @@ pnpm add @posthog/mcp
 ## Usage
 
 ```ts
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { track } from "@posthog/mcp";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js"
+import { track } from "@posthog/mcp"
 
-const server = new Server({ name: "my-mcp-server", version: "1.0.0" });
+const server = new Server({ name: "my-mcp-server", version: "1.0.0" })
 
 track(server, {
   apiKey: process.env.POSTHOG_API_KEY,
   context: true,
   enableAITracing: true,
   host: "https://us.i.posthog.com",
-});
+})
 ```
 
 With `context: true`, the SDK adds a required `context` argument to every tool call, strips it before invoking your handler, and captures it as `$mcp_intent` on PostHog events.
@@ -43,10 +44,10 @@ track(server, {
   apiKey: process.env.POSTHOG_API_KEY,
   context: true,
   intentFallback: (request) => {
-    const toolName = request.params?.name;
-    return toolName ? `Calling ${toolName}` : undefined;
+    const toolName = request.params?.name
+    return toolName ? `Calling ${toolName}` : undefined
   },
-});
+})
 ```
 
 With `enableAITracing: true`, tool calls also emit `$ai_span` events with `$ai_trace_id` and `$ai_span_id`.
@@ -60,7 +61,7 @@ When `enableConversationId: true` is passed to `track()`, the SDK injects an opt
 track(server, {
   apiKey: process.env.POSTHOG_API_KEY,
   enableConversationId: true,
-});
+})
 ```
 
 **Caveats:**
@@ -73,14 +74,14 @@ The SDK sends events through `posthog-node`, so it uses the same PostHog ingesti
 If your application already owns a PostHog client, pass it in instead:
 
 ```ts
-import { PostHog } from "posthog-node";
-import { track } from "@posthog/mcp";
+import { PostHog } from "posthog-node"
+import { track } from "@posthog/mcp"
 
-const posthog = new PostHog(process.env.POSTHOG_API_KEY ?? "");
+const posthog = new PostHog(process.env.POSTHOG_API_KEY ?? "")
 
 track(server, {
   posthogClient: posthog,
-});
+})
 ```
 
 ## Event schema
@@ -143,4 +144,4 @@ Release approval requests are posted in Slack to `#approvals-client-libraries`.
 
 ## Attribution
 
-This SDK started from a duplicated copy of the MIT-licensed [MCPcat TypeScript SDK](https://github.com/MCPCat/mcpcat-typescript-sdk). We are grateful for their work on MCP server instrumentation patterns, especially tool-call tracing, context capture, and MCP SDK compatibility handling.
+This SDK started as a fork from [mcpcat.io](https://mcpcat.io)'s [MCPcat TypeScript SDK](https://github.com/MCPCat/mcpcat-typescript-sdk). We are grateful for their work on MCP server instrumentation patterns, especially tool-call tracing, context capture, and MCP SDK compatibility handling.

package/dist/index.cjs

@@ -296,7 +296,7 @@ async function handleIdentify(server, data, request, extra) {
 		redactionFn: data.options.redactSensitiveInformation
 	};
 	try {
-		const identityResult = await data.options.identify(request, extra);
+		const identityResult = typeof data.options.identify === "function" ? await data.options.identify(request, extra) : data.options.identify;
 		if (identityResult) {
 			const currentSessionId = data.sessionId;
 			const previousIdentity = _globalIdentityCache.get(currentSessionId);
@@ -737,7 +737,7 @@ function sanitizeParameters(obj) {
 }
 //#endregion
 //#region package.json
-var version = "0.0.7";
+var version = "0.0.9";
 //#endregion
 //#region src/modules/session.ts
 function newSessionId() {
@@ -1873,6 +1873,13 @@ function getReportMissingToolDescriptor() {
 				description: "A description of your goal and what kind of tool would help accomplish it."
 			} },
 			required: ["context"]
+		},
+		annotations: {
+			title: "Get More Tools",
+			readOnlyHint: true,
+			openWorldHint: true,
+			idempotentHint: true,
+			destructiveHint: false
 		}
 	};
 }
@@ -1928,9 +1935,8 @@ function setupMCPAnalyticsTools(server) {
 				return { tools };
 			}
 			if (isContextEnabled(data.options.context)) tools = addContextParameterToTools(tools, getContextDescription(data.options.context));
-			if (data.options.reportMissing) {
-				if (!tools.some((tool) => tool?.name === "get_more_tools")) tools.push(getReportMissingToolDescriptor());
-			}
+			if (data.options.reportMissing) if (tools.some((tool) => tool?.name === "get_more_tools")) writeToLog("Warning: report_missing tool already present in tools list. Skipping addition. This is likely due to the server already including a report_missing tool. If you want to rely on the PostHog MCP Analytics report_missing tool, you should disable the server's report_missing tool.");
+			else tools.push(getReportMissingToolDescriptor());
 			event.response = { tools };
 			event.isError = false;
 			event.duration = event.timestamp && Date.now() - event.timestamp.getTime() || 0;
@@ -2508,7 +2514,7 @@ async function handleWrappedToolsCall(originalHandler, server, request, extra) {
 	const startTime = /* @__PURE__ */ new Date();
 	const conversation = resolveConversationId(getServerTrackingData(server)?.options.enableConversationId ?? false, request.params?.arguments, request.params?.name);
 	const tracing = await initializeToolCallEvent(server, request, conversation.conversationId ? cloneRequestWithoutConversationId(request) : request, extra, startTime, conversation);
-	if (request?.params?.name === "get_more_tools") return await executeReportMissingTool(server, request, tracing, startTime);
+	if (request?.params?.name === "get_more_tools") return executeReportMissingTool(server, request, tracing, startTime);
 	return await executeOriginalTool(originalHandler, server, request, extra, tracing, startTime);
 }
 async function initializeToolCallEvent(server, request, downstreamRequest, extra, startTime, conversation) {
@@ -2557,10 +2563,10 @@ async function applyResolvedMetadata(event, data, request, extra) {
 	const resolvedProperties = await resolveEventProperties(data, request, extra);
 	if (resolvedProperties) event.properties = resolvedProperties;
 }
-async function executeReportMissingTool(server, request, tracing, startTime) {
+function executeReportMissingTool(server, request, tracing, startTime) {
 	try {
 		const context = getContextArgument(request) || "";
-		const result = await handleReportMissing({ context });
+		const result = handleReportMissing({ context });
 		publishSuccessfulToolEvent(server, tracing, result, startTime, {
 			userIntent: context,
 			userIntentSource: "context_parameter"