skills.rest
PostHog
PostHogOFFICIAL
Explore all skills by this author →
Website𝕏@PostHogGitHub

exploring-mcp-tool-usage

Routes broad questions about PostHog MCP server tool usage to typed analytics query tools.

713|118|Updated Aug 11, 2020
Search Tags:#mcp#tool usage#Analytics#PostHog#query routing#HogQL#Agent Monitoring
One-click install
npx skills add https://github.com/PostHog/posthog-foss --skill exploring-mcp-tool-usage
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: exploring-mcp-tool-usage
Source: https://github.com/PostHog/posthog-foss/tree/main/products/mcp_analytics/skills/exploring-mcp-tool-usage
Command: npx skills add https://github.com/PostHog/posthog-foss --skill exploring-mcp-tool-usage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When you know you want to investigate how your PostHog-instrumented MCP server is being used but haven't formulated a specific question, this Skill acts as a front door: it presents a menu of common questions and routes each one to the typed query tool or focused skill that answers it, so you never hand-write HogQL for covered cases.

Core Features & Use Cases

  • Question Menu & Routing: Maps questions like "Which tools fail most?" or "Who uses tool X?" to the right typed tool (e.g. posthog:query-mcp-tool-stats, posthog:query-mcp-tool-failures, posthog:query-mcp-tool-top-users).
  • Per-Tool Drill-Downs: Guides calls to per-tool tools with a toolName and dateRange, covering stats, daily trends, failures, top users, neighbors, intents, and descriptions.
  • SQL Fallback Guidance: Clearly delineates which questions are covered by typed tools versus which require posthog:execute-sql (e.g. cross-tool rankings, errored-session filtering), including when the mcp-analytics feature flag is off.
  • Use Case: You paste an MCP analytics URL and ask "how is my MCP doing?" — the Skill offers the question menu, ranks tools via the tool-quality skill, then drills into the worst offender's error messages.

Quick Start

Ask "how is my MCP server doing?" and pick a question from the menu to get routed to the right analytics query.

Frequently Asked Questions about exploring-mcp-tool-usage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze MCP tool usage in PostHog?▼

Start with the question menu: pick what you want to know, and the Skill routes you to a typed query tool like posthog:query-mcp-tool-stats for headline numbers or posthog:query-mcp-tool-failures for errors. Each tool takes a toolName and dateRange and returns results matching the tool-detail UI.

How do I find which MCP tool fails most often?▼

Use the exploring-mcp-tool-quality skill to rank all tools by error rate, latency, and reach, then drill into a specific tool with posthog:query-mcp-tool-failures to see its top error messages grouped by client harness.

What toolName should I pass to the MCP analytics query tools?▼

Pass the effective tool name — the inner tool for single-exec wrapper calls, matching what the tool-quality ranking returns. The exception is posthog:query-mcp-tool-failures, which matches $exception events by the raw registered $mcp_tool_name.

When should I use posthog:execute-sql instead of the typed MCP tools?▼

Use execute-sql for cross-tool rankings, errored-session filtering, effective tool names inside sessions, or any custom breakdown not covered by a typed tool. It is also the fallback when the mcp-analytics feature flag is off, since all typed tools are gated behind it.

Can I see what agents are trying to do with my MCP tools?▼

Yes. Use posthog:query-mcp-tool-sample-intents to see recent agent intents for one tool, or the exploring-mcp-intent-clusters skill to group agent goals by semantic similarity across all tools.

Related Skills

Explore More Data & Analytics Skills→
vZulinvZulin

posthog-automation

Automate PostHog event capture and feature-flag management via Rube MCP.

Community
Intermediate
VrooliVrooli
54

Agent Manager Process Investigation Apply

Apply prioritized investigation report fixes to resume agent-manager runs.

Official
Advanced
openaiopenai
5.3k

posthog

Query PostHog analytics, feature flags, experiments, and error tracking through connected app tools.

Official
Intermediate
byaan-aibyaan-ai
94

posthog

Query events and analytics via HogQL using the PostHog REST API.

Official
Advanced