Skip to main content
skill CX Codex

exploring-mcp-sessions — Claude Code skill: setup and features

exploring-mcp-sessions investigates PostHog MCP sessions to inspect tool call sequences, agent intent, and run failures.

no license 202 installs ★ 101 updated 2026-10-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add PostHog/ai-plugin --skill exploring-mcp-sessions -a claude-code
Open on GitHub

What exploring-mcp-sessions does

The skill inspects individual agent executions recorded as $mcp_tool_call events in PostHog. It relies on typed posthog:mcp-analytics-* tools to inspect session history, pull sequential actions, and summarize the overall goal with an LLM. When typed tools are missing or when analyzing cross-session error patterns, it falls back to HogQL via posthog:execute-sql.

A key catch is the 7-day default lookback window in the detailed tools. Querying an older session yields empty results unless its session_start timestamp is supplied to date_from. In addition, list rows lack error flags, so tracking down broken runs requires executing SQL queries with countIf(toBool(properties.$mcp_is_error)).

What it helps with

  • reconstruct chronological tool calls for a specific agent run
  • identify failing MCP sessions and error messages
  • generate a goal summary from agent intent records
  • audit client names and users interacting with MCP endpoints

Example prompts for the agent

  • Show tool calls for session 019283-abc
  • Which MCP sessions ran into errors over the last 3 days?
  • Summarize what the agent was trying to achieve in session 019283-def

How to install exploring-mcp-sessions

1Skills CLI (Vercel)

npx skills add PostHog/ai-plugin --skill exploring-mcp-sessions -a claude-code

2Manually: put the files in place

~/.claude/skills/exploring-mcp-sessions/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/exploring-mcp-sessions/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about exploring-mcp-sessions

How do I install exploring-mcp-sessions in Claude Code?

Run npx skills add PostHog/ai-plugin --skill exploring-mcp-sessions -a claude-code. The skill definition will be placed into ~/.claude/skills/exploring-mcp-sessions/SKILL.md.

What does exploring-mcp-sessions do?

It investigates agent interactions logged by PostHog MCP Analytics. The skill audits tool execution timelines, retrieves error payloads, and evaluates run intent.

Why do tool calls return empty for an existing session?

Detail endpoints restrict queries to a 7-day time window. To inspect older activity, pass the session's session_start timestamp into the date_from parameter.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set82

The whole set →
auditing-warehouse-view-health auditing-warehouse-view-health runs a project-wide check on PostHog materialized views: lists the ones that failed to refresh and points at materialized views nobody queries. CX Codex +1 204installs building-workflows building-workflows is a Claude Code skill for building, patching, and testing PostHog automation graphs over MCP before publishing them in the visual editor. CX Codex +1 204installs exploring-replay-vision-observations The exploring-replay-vision-observations skill guides an agent through Replay Vision scanner results, from recurring patterns to individual session recordings. Use it to review findings and decide what to investigate next. CX Codex +1 203installs signals-scout-customer-analytics The signals-scout-customer-analytics skill tracks account-level engagement in PostHog and spots churn-risk or expansion patterns. Use it for recurring customer-health checks. CX Codex +1 203installs exploring-mcp-tool-quality exploring-mcp-tool-quality reads PostHog MCP analytics to rank tools by failure share, latency and reach, then drills into the ones that break. CX Codex +1 202installs exploring-mcp-intent-clusters exploring-mcp-intent-clusters analyzes PostHog MCP agent intent clusters to reveal what agents attempt to do, tool failure patterns, and semantic routing competition. CX Codex +1 202installs managing-reminders managing-reminders is a Claude Code skill that creates and manages private PostHog reminders with one-time or repeating schedules. It can nudge you about a task or resource. CX Codex +1 202installs signals-scout-apm signals-scout-apm watches OpenTelemetry traces in PostHog for error-rate and latency shifts per service, new error signatures and traffic drops, and files a report only on a confirmed change. CX Codex +1 202installs

Project sponsors

Companies that keep this analytics open