mcpField
Q
query-examples

query-examples

github.com/posthogData & databases9542 installsUpdated today
Repository

About query-examples

query-examples is a reference skill for querying PostHog data. It combines core data-schema guidance, HogQL references, and example analytics queries across product, web, session, and error data.

Key features

  1. 01PostHog core data-schema reference
  2. 02HogQL functions and syntax guidance
  3. 03Analytics query examples across domains
  4. 04LLM trace and session analysis examples

Use cases

  1. 01Build trends, funnels, and retention queries
  2. 02Inspect web traffic and user paths
  3. 03Query errors, logs, and session recordings

MCP support

The skill provides guidance for querying PostHog when an MCP server does not supply its own instructions.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/posthog/ai-plugin --skill query-examples

After installing, type/query-examplesin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
available-functions.md
example-error-tracking.md
example-event-taxonomy.md
example-funnel-breakdown.md
example-funnel-trends.md
example-lifecycle.md
example-llm-trace.md
example-llm-traces-list.md
example-logs.md
example-paths.md
example-person-property-taxonomy.md
example-retention.md
example-session-replay.md
example-sessions.md
example-stickiness.md
example-team-taxonomy.md
example-trends-breakdowns.md
example-trends-unique-users.md
example-web-overview.md
example-web-path-stats.md
example-web-traffic-by-device-type.md
example-web-traffic-channels.md
guidelines.md
hogql-extensions.md
models-actions.md
models-activity-logs.md
models-alerts.md
models-annotations.md
models-batch-exports.md
models-cohorts.md

Details

From the project README

Querying data in PostHog

If the MCP server haven't provided instructions on querying data in PostHog, read the guidelines.

Data Schema

Schema reference for PostHog's core system models, organized by domain:

HogQL References

Analytics Query Examples

Use the examples below to create optimized analytical queries.

Comments

Markdown supported