:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
from django.db import OperationalError
from prometheus_client import Counter
from posthog.api.statement_timeout import is_query_canceled
from posthog.exceptions import ClickHouseClusterMemoryLimitExceeded, ClickHouseQueryMemoryLimitExceeded
from posthog.sync import database_sync_to_async
from ee.hogai.chat_agent.query_planner.toolkit import TaxonomyAgentToolkit
from ee.hogai.mcp_tool import MCPTool, mcp_tool_registry
from ee.hogai.tool_errors import MaxToolFatalError, MaxToolRetryableError, MaxToolTransientError
from .core import ReadTaxonomyToolArgs, execute_taxonomy_query
READ_TAXONOMY_TIMED_OUT_COUNTER = Counter(
"read_taxonomy_timed_out_total",
"read_taxonomy reads cancelled by the statement timeout.",
labelnames=["query_kind"],
)
@mcp_tool_registry.register(scopes=["action:read", "property_definition:read", "event_definition:read"])
class ReadTaxonomyMCPTool(MCPTool[ReadTaxonomyToolArgs]):
"""
MCP version of ReadTaxonomyTool.
Explores the user's taxonomy (events, actions, properties, and property values).
"""
name = "read_taxonomy"
args_schema = ReadTaxonomyToolArgs
async def execute(self, args: ReadTaxonomyToolArgs) -> str:
toolkit = TaxonomyAgentToolkit(self._team, self._user, event_source=self._event_source)
try:
@database_sync_to_async(thread_sensitive=False)
def _execute_query():
return execute_taxonomy_query(
args.query, toolkit, self._team, self._user, event_source=self._event_source
)
return await _execute_query()
except ValueError as e:
raise MaxToolRetryableError(str(e))
except ClickHouseClusterMemoryLimitExceeded as e:
raise MaxToolTransientError(
ClickHouseClusterMemoryLimitExceeded.default_detail.rstrip("."), error_type="rate_limited"
) from e
except ClickHouseQueryMemoryLimitExceeded as e:
raise MaxToolFatalError(
"Reading the schema ran out of memory. This tool does not support date filters. "
"Use execute-sql with a short, explicit date range for a targeted lookup",
error_type="memory_limit",
) from e
except OperationalError as e:
# Only a statement cancelled by statement_timeout (SQLSTATE 57014) is worth a retry.
# Let connection loss, shutdown, deadlocks, and the like reach the generic handler so
# they are logged and captured instead of mislabeled as a timeout.
if not is_query_canceled(e):
raise
# The MCP transport answers a MaxToolError without logging or capturing it, so a timeout
# that reaches the caller as one leaves no trace. Count it here, or the rate this change
# is meant to drive to zero becomes unmeasurable the moment it stops being an exception.
READ_TAXONOMY_TIMED_OUT_COUNTER.labels(query_kind=args.query.kind).inc()
# MaxToolError appends its own retry hint and a period, so this ends bare. The hint for
# a transient error offers one unchanged retry, so do not suggest narrowing the read.
raise MaxToolTransientError(
"Reading the taxonomy timed out. This can happen on large projects", error_type="timeout"
) from e