PostHog · rodrigoi · Sep 18, 2025 · Sep 7, 2025 · Sep 7, 2025 · Sep 8, 2025
diff --git a/python/schema/tool_inputs.py b/python/schema/tool_inputs.py
diff --git a/schema/tool-definitions.json b/schema/tool-definitions.json
@@ -209,6 +209,48 @@
 			"readOnlyHint": true
 		}
 	},
+	"experiment-create": {
+		"description": "Create a comprehensive A/B test experiment. PROCESS: 1) Understand experiment goal and hypothesis 2) Search existing feature flags with 'feature-flags-get-all' tool first and suggest reuse or new key 3) Help user define success metrics by asking what they want to optimize 4) MOST IMPORTANT: Use 'event-definitions-list' tool to find available events in their project 5) For funnel metrics, ask for specific event sequence (e.g., ['product_view', 'add_to_cart', 'purchase']) and use funnel_steps parameter 6) Configure variants (default 50/50 control/test unless they specify otherwise) 7) Set targeting criteria if needed.",
+		"category": "Experiments",
+		"feature": "experiments",
+		"summary": "Create A/B test experiment with guided metric and feature flag setup",
+		"title": "Create experiment",
+		"required_scopes": ["experiment:write"],
+		"annotations": {
+			"destructiveHint": false,
+			"idempotentHint": false,
+			"openWorldHint": true,
+			"readOnlyHint": false
+		}
+	},
+	"experiment-delete": {
+		"description": "Delete an experiment by ID.",
+		"category": "Experiments",
+		"feature": "experiments",
+		"summary": "Delete an experiment by ID.",
+		"title": "Delete experiment",
+		"required_scopes": ["experiment:write"],
+		"annotations": {
+			"destructiveHint": true,
+			"idempotentHint": true,
+			"openWorldHint": true,
+			"readOnlyHint": false
+		}
+	},
+	"experiment-update": {
+		"description": "Update an existing experiment by ID. Can update name, description, lifecycle state, variants, metrics, and other properties. RESTART WORKFLOW: To restart a concluded experiment, set end_date=null, conclusion=null, conclusion_comment=null, and optionally set a new start_date. To make it draft again, also set start_date=null. COMMON PATTERNS: Launch draft (set start_date), stop running (set end_date + conclusion), archive (set archived=true), modify variants (update parameters.feature_flag_variants). NOTE: feature_flag_key cannot be changed after creation.",
+		"category": "Experiments",
+		"feature": "experiments",
+		"summary": "Update an existing experiment with lifecycle management and restart capability.",
+		"title": "Update experiment",
+		"required_scopes": ["experiment:write"],
+		"annotations": {
+			"destructiveHint": false,
+			"idempotentHint": true,
+			"openWorldHint": true,
+			"readOnlyHint": false
+		}
+	},
 	"experiment-get": {
 		"description": "Get details of a specific experiment by ID.",
 		"category": "Experiments",
@@ -223,6 +265,20 @@
 			"readOnlyHint": true
 		}
 	},
+	"experiment-results-get": {
+		"description": "Get comprehensive experiment results including all metrics data (primary and secondary) and exposure data. This tool fetches the experiment details and executes the necessary queries to get complete experiment results. Only works with new experiments (not legacy experiments).",
+		"category": "Experiments",
+		"feature": "experiments",
+		"summary": "Get comprehensive experiment results including metrics and exposure data.",
+		"title": "Get experiment results",
+		"required_scopes": ["experiment:read"],
+		"annotations": {
+			"destructiveHint": false,
+			"idempotentHint": true,
+			"openWorldHint": true,
+			"readOnlyHint": true
+		}
+	},
 	"insight-create-from-query": {
 		"description": "Create an insight from a query that you have previously tested with 'query-run'. You should check the query runs, before creating an insight. Do not create an insight before running the query, unless you know already that it is correct (e.g. you are making a minor modification to an existing query you have seen).",
 		"category": "Insights & analytics",