@posthog/mcp 0.0.5 → 0.0.7

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;
@@ -500,6 +502,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;
+	addCustomEventProperties(event, properties);
 	return {
 		event: PostHogMCPAnalyticsEvent.Exception,
 		distinct_id: distinctId,
@@ -556,6 +559,7 @@ const PROTECTED_FIELDS = new Set([
 	"identifyData",
 	"resourceName",
 	"toolDescription",
+	"listedToolNames",
 	"eventType",
 	"actorId",
 	"tags",
@@ -733,7 +737,7 @@ function sanitizeParameters(obj) {
 }
 //#endregion
 //#region package.json
-var version = "0.0.5";
+var version = "0.0.7";
 //#endregion
 //#region src/modules/session.ts
 function newSessionId() {
@@ -1194,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,
@@ -2128,11 +2133,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);