@posthog/mcp 0.0.6 → 0.0.8

package/README.md

@@ -103,6 +103,7 @@ Important properties:
 - `$mcp_intent_source` as `context_parameter` or `inferred`
 - `$mcp_tool_name` and `$mcp_resource_name`
 - `$mcp_tool_description`, the tool's current `description` at the moment of the call — populated on `mcp_tool_call` and on the paired `$exception` event so the description is visible inline while triaging
+- `$mcp_listed_tool_names`, the array of tool names advertised in a `tools/list` response — populated on `mcp_tools_list` events so you can correlate "tools the agent was offered" with "tools the agent actually called" (e.g. find advertised tools that never get picked)
 - `$mcp_parameters` and `$mcp_response`, after redaction and truncation
 - `$mcp_duration_ms`
 - `$mcp_is_error`

package/dist/index.cjs

@@ -382,6 +382,7 @@ const PostHogMCPAnalyticsProperty = {
 	IsError: "$mcp_is_error",
 	Intent: "$mcp_intent",
 	IntentSource: "$mcp_intent_source",
+	ListedToolNames: "$mcp_listed_tool_names",
 	Parameters: "$mcp_parameters",
 	ResourceName: "$mcp_resource_name",
 	Response: "$mcp_response",
@@ -459,6 +460,7 @@ function addCommonEventProperties(event, properties) {
 		if (event.eventType === MCPAnalyticsEventType.mcpToolsCall) properties[PostHogMCPAnalyticsProperty.ToolName] = event.resourceName;
 	}
 	if (event.toolDescription && event.eventType === MCPAnalyticsEventType.mcpToolsCall) properties[PostHogMCPAnalyticsProperty.ToolDescription] = event.toolDescription;
+	if (event.listedToolNames && event.listedToolNames.length > 0 && event.eventType === MCPAnalyticsEventType.mcpToolsList) properties[PostHogMCPAnalyticsProperty.ListedToolNames] = event.listedToolNames;
 	if (event.duration !== void 0) properties[PostHogMCPAnalyticsProperty.DurationMs] = event.duration;
 	if (event.serverName) properties[PostHogMCPAnalyticsProperty.ServerName] = event.serverName;
 	if (event.serverVersion) properties[PostHogMCPAnalyticsProperty.ServerVersion] = event.serverVersion;
@@ -557,6 +559,7 @@ const PROTECTED_FIELDS = new Set([
 	"identifyData",
 	"resourceName",
 	"toolDescription",
+	"listedToolNames",
 	"eventType",
 	"actorId",
 	"tags",
@@ -734,7 +737,7 @@ function sanitizeParameters(obj) {
 }
 //#endregion
 //#region package.json
-var version = "0.0.6";
+var version = "0.0.8";
 //#endregion
 //#region src/modules/session.ts
 function newSessionId() {
@@ -1195,6 +1198,7 @@ function publishEvent(server, eventInput) {
 		identifyActorData: sessionInfo.identifyActorData,
 		resourceName: eventInput.resourceName,
 		toolDescription: eventInput.toolDescription,
+		listedToolNames: eventInput.listedToolNames,
 		parameters: eventInput.parameters,
 		response: eventInput.response,
 		userIntent: eventInput.userIntent,
@@ -1869,6 +1873,12 @@ function getReportMissingToolDescriptor() {
 				description: "A description of your goal and what kind of tool would help accomplish it."
 			} },
 			required: ["context"]
+		},
+		annotations: {
+			readOnlyHint: true,
+			idempotentHint: false,
+			openWorldHint: false,
+			destructiveHint: false
 		}
 	};
 }
@@ -1924,9 +1934,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;
@@ -2129,11 +2138,17 @@ async function handleListToolsRequest(server, originalListToolsHandler, request,
 		return { tools };
 	}
 	event.response = { tools };
+	event.listedToolNames = collectListedToolNames(tools);
 	event.isError = false;
 	event.duration = getEventDuration(event);
 	publishEvent(server, event);
 	return { tools };
 }
+function collectListedToolNames(tools) {
+	if (!tools || tools.length === 0) return;
+	const names = tools.map((tool) => tool?.name).filter((name) => typeof name === "string");
+	return names.length > 0 ? names : void 0;
+}
 async function getTracedToolsList(server, originalListToolsHandler, request, extra, event) {
 	try {
 		const data = getServerTrackingData(server);