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
npx skills add PostHog/ai-plugin --skill exploring-mcp-sessions -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/exploring-mcp-sessions/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/exploring-mcp-sessions/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill exploring-mcp-sessions -a codex2Manually: put the files in place
.agents/skills/exploring-mcp-sessions/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill exploring-mcp-sessions -a cursor2Manually: put the files in place
.cursor/skills/exploring-mcp-sessions/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostHog/ai-plugin skills/exploring-mcp-sessions2Manually: put the files in place
.github/skills/exploring-mcp-sessions/SKILL.md1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill exploring-mcp-sessions -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostHog/ai-plugin --path skills/exploring-mcp-sessionsManually: put the files in place
.devin/skills/exploring-mcp-sessions/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill exploring-mcp-sessions -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.