Finding experiments
Users refer to experiments by name, description, or relative references — not by ID. This skill resolves natural language references to concrete experiment IDs.
How to find an experiment
Use the experiment-list tool from the Posthog-local MCP server.
IMPORTANT: Do NOT use feature-flag-get-all or any feature flag tool to find
experiments. Use the dedicated experiment list tool: experiment-list.
This tool returns experiments with their id, name, status, feature_flag_key, start_date, end_date, and created_at. Browse the returned list to find the experiment matching the user's reference:
- By name: scan the
namefield for matches - By recency: results are ordered newest first by default
- By status: match the
statusfield (draft, running, paused, exposure_frozen, stopped) - By flag key: match the
feature_flag_keyfield
After finding matches
- Exactly one match: Use it. Confirm with the user by name before destructive actions (delete, ship, end).
- Multiple matches: List them with name, status, and creation date. Ask the user to pick.
- No matches: Tell the user. Suggest checking archived experiments or different terms.
Get full details if needed
After resolving to an ID, call experiment-get for the full object (metrics, flag details, parameters).
Examples
When NOT to search
- You already have the experiment ID from earlier in the conversation
- The user just created the experiment — you have the ID from the create response
- The user provided the ID directly
Related skills
managing-experiment-lifecycle— act on the experiment once you've resolved its IDdiagnosing-experiment-results— investigate the experiment you found
