PostHog
Arcade.dev LLM tools for PostHog analytics
1.0.0Available tools(41)
| Tool name | Description | Secrets | |
|---|---|---|---|
Pin an existing insight as a tile on a dashboard. | 2 | ||
Compare the same metric across two date ranges side-by-side. | 2 | ||
Create a new empty dashboard. Insights can be pinned to it as tiles afterward. | 2 | ||
Create an A/B test experiment.
Before creating, verify the feature_flag_key is not already in
use and confirm the event names for metrics are valid.
Note: PostHog does not enforce unique feature_flag_key values
across experiments. Duplicate keys will not error but will cause
unpredictable behavior. | 2 | ||
Create a feature flag and an experiment in one step.
The flag is created with the specified rollout_percentage, then
the experiment is linked to it.
Note: PostHog does not enforce unique feature_flag_key values
across experiments. Duplicate keys will not error but will cause
unpredictable behavior. | 2 | ||
Create a new feature flag.
Verify the key is not already in use to avoid duplicates. After
creation, consult PostHog SDK documentation for the user's
language/framework to integrate the flag. | 2 | ||
Save a tested query as a reusable insight.
Always verify the query produces expected results before saving
it as an insight. The query_id is not validated by PostHog —
ensure it is a valid cache_key from a previously executed query.
Passing an invalid query_id will create a broken insight. | 2 | ||
Create a new survey.
Verify the name is not already in use to avoid duplicates. After
creation, consult PostHog SDK documentation to integrate the
survey into the user's application. | 2 | ||
Soft-delete a dashboard by ID. The dashboard is marked as deleted but can be restored. | 2 | ||
Soft-delete an experiment by ID (marks as archived).
Important: archiving an experiment does NOT unlink its feature
flag. PostHog still considers the flag as linked to an "active"
experiment, blocking flag deletion. To fully clean up, delete
the flag separately after the experiment is archived. | 2 | ||
Soft-delete a feature flag by numeric ID or key. Provide one of flag_id or flag_key.
Note: flags linked to an experiment cannot be deleted until the
experiment is concluded and deleted first. PostHog considers even
archived experiments as "active" for flag linkage purposes. | 2 | ||
Soft-delete an insight by ID. | 2 | ||
Soft-delete a survey by ID (marks as archived). | 2 | ||
Get the activity log across all surveys.
Returns a chronological list of changes made to any survey
(created, updated, archived, etc.), not response metrics. | 2 | ||
Get a dashboard's full configuration including all insight tiles.
Provide dashboard_id or dashboard_name. | 2 | ||
Get stack trace, occurrence count, and affected users/sessions for a specific error. | 2 | ||
Get an experiment's full configuration.
Includes variants, metrics, and current status. Provide either
the numeric ID or the name. | 2 | ||
Get experiment results including metric data and exposure counts.
Only available for launched experiments that have collected data.
Draft, not-yet-launched, or legacy experiments return 404. | 2 | ||
Get a feature flag's full definition including rollout rules.
Provide either the numeric ID or the flag key. | 2 | ||
Build a multi-step conversion funnel with optional property breakdowns. | 2 | ||
Get an insight's full configuration and current query results.
Provide either the numeric ID or the name. | 2 | ||
Get cohort retention data showing what percentage of users return.
Shows return rates after a user's initial event. | 2 | ||
Get a survey's full configuration.
Includes questions, targeting rules, and scheduling. Provide
either the numeric ID or the name. | 2 | ||
Get the activity log for a survey.
Returns a chronological list of changes made to the survey
(created, updated, archived, etc.), not response metrics. | 2 | ||
Get a time-series trend for an event over a date range.
Optionally broken down by a property. | 2 |
Selected tools
No tools selected.
Click "Show all tools" to add tools.
Requirements
Select tools to see requirements
Posthog.AddInsightToDashboard
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Pin an existing insight as a tile on a dashboard.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
insight_id | integer | Required | Numeric insight ID to add. |
dashboard_id | integer | Required | Numeric dashboard ID to add the insight to. |
project_id | string | Required | PostHog project ID. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.ComparePeriods
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Compare the same metric across two date ranges side-by-side.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
event | string | Required | Event name to compare. |
current_date_from | string | Required | Start of current period in YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS format (UTC), or relative offset: -Nh (hours), -Nd (days), -Nw (weeks), -Nm (months). |
project_id | string | Required | PostHog project ID. |
current_date_to | string | Optional | End of current period in YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS format (UTC), or relative offset. Defaults to now. |
previous_date_from | string | Optional | Start of comparison period in YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS format (UTC), or relative offset. Default auto-calculates same duration before current period. |
time_grouping | string | Optional | Time interval for grouping data points. Defaults to DAY.dayweekmonth |
math | string | Optional | Aggregation method. Defaults to TOTAL.totaldauweekly_activemonthly_active |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.CreateDashboard
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Create a new empty dashboard. Insights can be pinned to it as tiles afterward.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
name | string | Required | Dashboard name. |
project_id | string | Required | PostHog project ID. |
description | string | Optional | What this dashboard tracks |
pinned | boolean | Optional | Pin to the top of the dashboards list. Defaults to false. |
tags | array<string> | Optional | Tags for organization. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.CreateExperiment
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Create an A/B test experiment. Before creating, verify the feature_flag_key is not already in use and confirm the event names for metrics are valid. Note: PostHog does not enforce unique feature_flag_key values across experiments. Duplicate keys will not error but will cause unpredictable behavior.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
name | string | Required | Experiment name describing the hypothesis. |
feature_flag_key | string | Required | Feature flag key for this experiment. Lowercase letters, numbers, hyphens, and underscores only. |
project_id | string | Required | PostHog project ID. |
description | string | Optional | Detailed hypothesis and expected outcome |
experiment_type | string | Optional | Experiment type.productweb |
primary_metrics | array<json> | Optional | Primary success metrics to measure. |
secondary_metrics | array<json> | Optional | Secondary metrics to monitor for side effects |
variants | array<json> | Optional | Variant definitions (default: 50/50 control/test) |
draft | boolean | Optional | Create as draft (true) or launch immediately (false). Defaults to true. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.CreateExperimentWithFlag
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Create a feature flag and an experiment in one step. The flag is created with the specified rollout_percentage, then the experiment is linked to it. Note: PostHog does not enforce unique feature_flag_key values across experiments. Duplicate keys will not error but will cause unpredictable behavior.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
name | string | Required | Experiment name describing the hypothesis. |
feature_flag_key | string | Required | Feature flag key. Lowercase letters, numbers, hyphens, and underscores only. |
project_id | string | Required | PostHog project ID. |
description | string | Optional | Detailed hypothesis and expected outcome |
experiment_type | string | Optional | Experiment type.productweb |
primary_metrics | array<json> | Optional | Primary success metrics. |
secondary_metrics | array<json> | Optional | Secondary metrics to monitor for side effects |
rollout_percentage | integer | Optional | Percentage of users who see the experiment (0-100). Default 100. |
draft | boolean | Optional | Create as draft (true) or launch immediately (false). Defaults to true. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.CreateFeatureFlag
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Create a new feature flag. Verify the key is not already in use to avoid duplicates. After creation, consult PostHog SDK documentation for the user's language/framework to integrate the flag.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
key | string | Required | Unique flag key using lowercase letters, numbers, hyphens, and underscores. |
project_id | string | Required | PostHog project ID. |
name | string | Optional | Human-readable display name |
description | string | Optional | What this flag controls and why |
active | boolean | Optional | Whether the flag is active. Defaults to true. |
filters | json | Optional | Rollout and targeting rules. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.CreateInsightFromQuery
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Save a tested query as a reusable insight. Always verify the query produces expected results before saving it as an insight. The query_id is not validated by PostHog — ensure it is a valid cache_key from a previously executed query. Passing an invalid query_id will create a broken insight.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
query_id | string | Required | Query identifier or cache_key from a previously executed query result. Not validated by PostHog — ensure it is a valid cache_key from a previously executed query. Passing an invalid query_id will create a broken insight. |
name | string | Required | Display name for the saved insight. |
project_id | string | Required | PostHog project ID. |
description | string | Optional | What this insight measures |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.CreateSurvey
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Create a new survey. Verify the name is not already in use to avoid duplicates. After creation, consult PostHog SDK documentation to integrate the survey into the user's application.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
name | string | Required | Survey name. |
project_id | string | Required | PostHog project ID. |
description | string | Optional | Internal description of the survey's purpose |
survey_type | string | Optional | Survey display type.popoverapiwidgetbutton |
questions | array<json> | Optional | List of survey questions. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.DeleteDashboard
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Soft-delete a dashboard by ID. The dashboard is marked as deleted but can be restored.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
dashboard_id | integer | Required | Numeric dashboard ID to delete |
project_id | string | Required | PostHog project ID. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.DeleteExperiment
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Soft-delete an experiment by ID (marks as archived). Important: archiving an experiment does NOT unlink its feature flag. PostHog still considers the flag as linked to an "active" experiment, blocking flag deletion. To fully clean up, delete the flag separately after the experiment is archived.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
experiment_id | integer | Required | Numeric experiment ID to delete |
project_id | string | Required | PostHog project ID. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.DeleteFeatureFlag
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Soft-delete a feature flag by numeric ID or key. Provide one of flag_id or flag_key. Note: flags linked to an experiment cannot be deleted until the experiment is concluded and deleted first. PostHog considers even archived experiments as "active" for flag linkage purposes.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
flag_id | integer | Optional | Numeric flag ID. |
flag_key | string | Optional | Flag key string. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.DeleteInsight
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Soft-delete an insight by ID.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
insight_id | integer | Required | Numeric insight ID to delete |
project_id | string | Required | PostHog project ID. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.DeleteSurvey
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Soft-delete a survey by ID (marks as archived).
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
survey_id | string | Required | Survey ID (UUID string) to delete. |
project_id | string | Required | PostHog project ID. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.GetAllSurveyActivity
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Get the activity log across all surveys. Returns a chronological list of changes made to any survey (created, updated, archived, etc.), not response metrics.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.GetDashboard
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Get a dashboard's full configuration including all insight tiles. Provide dashboard_id or dashboard_name.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
dashboard_id | integer | Optional | Numeric dashboard ID to retrieve |
dashboard_name | string | Optional | Dashboard name (case-insensitive exact match). |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.GetErrorDetails
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Get stack trace, occurrence count, and affected users/sessions for a specific error.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
issue_id | string | Required | Error issue fingerprint (the 'fingerprint' field from list_errors results). |
project_id | string | Required | PostHog project ID. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.GetExperiment
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Get an experiment's full configuration. Includes variants, metrics, and current status. Provide either the numeric ID or the name.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
experiment_id | integer | Optional | Numeric experiment ID. |
experiment_name | string | Optional | Experiment name (case-insensitive exact match). |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.GetExperimentResults
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Get experiment results including metric data and exposure counts. Only available for launched experiments that have collected data. Draft, not-yet-launched, or legacy experiments return 404.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
experiment_id | integer | Required | Numeric experiment ID to get results for |
project_id | string | Required | PostHog project ID. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.GetFeatureFlag
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Get a feature flag's full definition including rollout rules. Provide either the numeric ID or the flag key.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
flag_id | integer | Optional | Numeric flag ID. |
flag_key | string | Optional | Flag key string. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.GetFunnel
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Build a multi-step conversion funnel with optional property breakdowns.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
steps | array<string> | Required | Ordered list of event names for funnel steps. |
project_id | string | Required | PostHog project ID. |
date_from | string | Optional | Start date in YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS format (UTC), or relative offset: -Nh (hours), -Nd (days), -Nw (weeks), -Nm (months). Defaults to '-7d'. |
date_to | string | Optional | End date in YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS format (UTC), or relative offset: -Nh (hours), -Nd (days), -Nw (weeks), -Nm (months). Future dates are clamped to now. Defaults to now. |
breakdown_property | string | Optional | Property to break down funnel by (e.g., '$initial_utm_source'). Shows conversion per segment. |
breakdown_type | string | Optional | Breakdown type. Defaults to EVENT.eventpersonsession |
funnel_window_days | integer | Optional | Max days between first and last step. Defaults to 14. |
property_filters | array<json> | Optional | Property filters applied to all steps. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.GetInsight
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Get an insight's full configuration and current query results. Provide either the numeric ID or the name.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
insight_id | integer | Optional | Numeric insight ID. |
insight_name | string | Optional | Insight name (case-insensitive exact match). |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.GetRetention
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Get cohort retention data showing what percentage of users return. Shows return rates after a user's initial event.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
start_event | string | Required | Event that defines the cohort entry. |
project_id | string | Required | PostHog project ID. |
return_event | string | Optional | Event that counts as a return. Defaults to same as start_event. |
date_from | string | Optional | Start date in YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS format (UTC), or relative offset: -Nh (hours), -Nd (days), -Nw (weeks), -Nm (months). Defaults to '-30d'. |
date_to | string | Optional | End date in YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS format (UTC), or relative offset: -Nh (hours), -Nd (days), -Nw (weeks), -Nm (months). Future dates are clamped to now. Defaults to now. |
retention_type | string | Optional | Retention type. Defaults to FIRST_TIME (first-time users only).retention_first_timeretention_recurring |
period | string | Optional | Retention period granularity. Defaults to WEEK.dayweekmonth |
total_intervals | integer | Optional | Number of intervals to show (e.g., 7 for D0-D7, 28 for D0-D28). Defaults to 8. |
property_filters | array<json> | Optional | Property filters for the cohort. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.GetSurvey
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Get a survey's full configuration. Includes questions, targeting rules, and scheduling. Provide either the numeric ID or the name.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
survey_id | string | Optional | Survey ID (UUID string). |
survey_name | string | Optional | Survey name (case-insensitive exact match). |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.GetSurveyActivity
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Get the activity log for a survey. Returns a chronological list of changes made to the survey (created, updated, archived, etc.), not response metrics.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
survey_id | string | Required | Survey ID (UUID string) to get activity for. |
project_id | string | Required | PostHog project ID. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.GetTrend
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Get a time-series trend for an event over a date range. Optionally broken down by a property.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
event | string | Required | Event name to trend. |
project_id | string | Required | PostHog project ID. |
date_from | string | Optional | Start date in YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS format (UTC), or relative offset: -Nh (hours), -Nd (days), -Nw (weeks), -Nm (months). Defaults to '-8w'. |
date_to | string | Optional | End date in YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS format (UTC), or relative offset: -Nh (hours), -Nd (days), -Nw (weeks), -Nm (months). Future dates are clamped to now. Defaults to now. |
time_grouping | string | Optional | Time interval for grouping data points. Defaults to WEEK.dayweekmonth |
breakdown_property | string | Optional | Property to break down by (e.g., '$initial_utm_source', '$browser'). Omit for a single series. |
breakdown_type | string | Optional | Breakdown type. Defaults to EVENT.eventpersonsession |
math | string | Optional | Aggregation method. Defaults to TOTAL (count).totaldauweekly_activemonthly_active |
property_filters | array<json> | Optional | Property filters to narrow results. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.GetTrends
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Batch trend query: get time-series data for multiple events. Returns a time-series for each event. Unknown event names return zero counts rather than errors.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
events | array<string> | Required | List of event names to trend. |
project_id | string | Required | PostHog project ID. |
date_from | string | Optional | Start date in YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS format (UTC), or relative offset: -Nh (hours), -Nd (days), -Nw (weeks), -Nm (months). Defaults to '-8w'. |
date_to | string | Optional | End date in YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS format (UTC), or relative offset: -Nh (hours), -Nd (days), -Nw (weeks), -Nm (months). Future dates are clamped to now. Defaults to now. |
time_grouping | string | Optional | Time interval for grouping data points. Defaults to WEEK.dayweekmonth |
math | string | Optional | Aggregation method. Defaults to TOTAL (count).totaldauweekly_activemonthly_active |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.ListDashboards
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
List all dashboards in the project. Returns summaries (id, name, pinned, tags, created_at). Use a dashboard's ID to get its full configuration and insight tiles.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
limit | integer | Optional | Maximum results to return (1-100). Defaults to 100. |
offset | integer | Optional | Number of items to skip for pagination (zero-based). Defaults to 0. |
search | string | Optional | Filter dashboards by name (case-insensitive substring match) |
pinned | boolean | Optional | Filter to only pinned (true) or unpinned (false) dashboards |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.ListErrors
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
List error tracking issues. Returns summaries (id, fingerprint, status, occurrences, users, first_seen, last_seen). Use an error's fingerprint with get_error_details to get full stack traces.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
limit | integer | Optional | Maximum results to return (1-100). Defaults to 100. |
offset | integer | Optional | Number of items to skip for pagination (zero-based). Defaults to 0. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.ListEventDefinitions
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
List all tracked event names in the project. This is the discovery starting point -- use it to find valid event names, then look up an event's properties to discover available filters and breakdowns.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
search | string | Optional | Filter events by name (server-side, case-insensitive substring match). |
limit | integer | Optional | Maximum results to return (1-100). Defaults to 100. |
offset | integer | Optional | Number of items to skip for pagination (zero-based). Defaults to 0. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.ListExperiments
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
List all A/B test experiments. Returns summaries (id, name, feature_flag_key, start_date, end_date). Use an experiment's ID or name to get its full configuration.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
limit | integer | Optional | Maximum results to return (1-100). Defaults to 100. |
offset | integer | Optional | Number of items to skip for pagination (zero-based). Defaults to 0. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.ListFeatureFlags
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
List all feature flags. Returns summaries (id, key, name, active). Use a flag's ID or key to get its full rollout rules and targeting detail.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
limit | integer | Optional | Maximum results to return (1-100). Defaults to 100. |
offset | integer | Optional | Number of items to skip for pagination (zero-based). Defaults to 0. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.ListInsights
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
List all saved insights. Returns summaries (id, name, description, last_modified_at). Use an insight's ID or name to get its full configuration and query results.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
search | string | Optional | Filter insights by name (case-insensitive substring match). |
limit | integer | Optional | Maximum results to return (1-100). Defaults to 100. |
offset | integer | Optional | Number of items to skip for pagination (zero-based). Defaults to 0. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.ListProperties
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
List property definitions with names, types, and example values. Use this as a schema exploration step: after identifying tracked event names, query with event_name to discover its properties for use in filters and breakdowns.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
event_name | string | Optional | Event name to get properties for (required when type is 'event'). |
property_type | string | Optional | Property type. When set to 'event', event_name is required.eventperson |
limit | integer | Optional | Maximum results to return (1-100). Defaults to 100. |
offset | integer | Optional | Number of items to skip for pagination (zero-based). Defaults to 0. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.ListSurveys
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
List all surveys. Returns summaries (id, name, type, created_at). Use a survey's ID or name to get its full configuration.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
search | string | Optional | Filter surveys by name (case-insensitive substring match) |
limit | integer | Optional | Maximum results to return (1-100). Defaults to 100. |
offset | integer | Optional | Number of items to skip for pagination (zero-based). Defaults to 0. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.RunQuery
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Execute a raw PostHog query. For common analytics patterns (trends, funnels, retention), prefer purpose-built tools if available. Use this for custom query shapes. Discover valid event names before constructing a query. For the full query schema and supported kinds, see https://posthog.com/docs/api/queries
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
query | json | Required | PostHog query object. Must include a 'kind' field that determines the query type (TrendsQuery, FunnelsQuery, RetentionQuery, EventsQuery, HogQLQuery, etc.). Common optional fields: 'dateRange' (object with 'date_from' and/or 'date_to' strings), 'series' (list of event node objects with 'event' and 'kind' fields), 'properties' (filter object). For HogQL queries, include a 'query' field with the SQL string. For common analytics patterns, prefer purpose-built tools instead. |
project_id | string | Required | PostHog project ID. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.UpdateDashboard
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Update a dashboard's name, description, pinned status, or tags. Review the dashboard's current values before updating.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
dashboard_id | integer | Required | Numeric dashboard ID to update |
project_id | string | Required | PostHog project ID. |
name | string | Optional | New dashboard name |
description | string | Optional | New dashboard description |
pinned | boolean | Optional | Pin or unpin the dashboard |
tags | array<string> | Optional | Replace tags. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.UpdateExperiment
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Update an experiment's properties or lifecycle state. Review the experiment's current state before updating. To launch: set launch=true. To conclude: set conclude='winning_variant_name'. To restart: set restart=true.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
experiment_id | integer | Required | Numeric experiment ID to update |
project_id | string | Required | PostHog project ID. |
name | string | Optional | New experiment name |
description | string | Optional | New experiment description |
primary_metrics | array<json> | Optional | Replace primary metrics. |
secondary_metrics | array<json> | Optional | Replace secondary metrics |
launch | boolean | Optional | Set true to launch a draft experiment. Defaults to false. |
conclude | string | Optional | Conclusion result string to end the experiment |
restart | boolean | Optional | Set true to restart a concluded experiment. Defaults to false. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.UpdateFeatureFlag
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Update a feature flag's properties or rollout rules. Provide one of flag_id or flag_key. Review the flag's current state before updating. To enable: set active=true and rollout_percentage=100. To disable: set active=false.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | PostHog project ID. |
flag_id | integer | Optional | Numeric flag ID. |
flag_key | string | Optional | Flag key string. |
name | string | Optional | New display name |
description | string | Optional | New description |
active | boolean | Optional | Set active (true) or inactive (false) |
filters | json | Optional | New rollout and targeting rules for the flag. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.UpdateInsight
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Update an insight's name, description, or query filters. Review the insight's current query structure first and only modify the parts you need to change.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
insight_id | integer | Required | Numeric insight ID to update |
project_id | string | Required | PostHog project ID. |
name | string | Optional | New insight name |
description | string | Optional | New insight description |
filters | json | Optional | New query filters (overwrites existing). Review the insight's current structure before overwriting. |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.UpdateSurvey
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Update a survey's name, description, or questions. Review the survey's current configuration before updating.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
survey_id | string | Required | Survey ID (UUID string) to update. |
project_id | string | Required | PostHog project ID. |
name | string | Optional | New survey name |
description | string | Optional | New survey description |
questions | array<json> | Optional | Replacement question list (overwrites existing questions) |
Requirements
Output
json— No description provided.No code example available for this tool.
Posthog.WhoAmI
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Return the authenticated user's identity, organizations, and projects. Call this first to confirm credentials and discover available organization and project IDs.
Parameters
No parameters required.
Requirements
Output
json— No description provided.No code example available for this tool.