Built by Metorial, the integration platform for agentic AI.
Create a new A/B test experiment. Experiments run on top of feature flags. The feature flag must be implemented in your code first.
List session recording metadata. Supports filtering by person, date range, and pagination. Note: This returns metadata only, not the raw replay data. Use the PostHog UI to view full replays.
List analytics insights (trends, funnels, retention, paths, stickiness, lifecycle). Supports searching by name and filtering to saved insights only.
List all property definitions in the project. Property definitions describe the possible properties that can be attached to events or persons. Use this to discover available properties for filtering, grouping, and analysis.
List all cohorts in the project. Cohorts are groups of users that match specific criteria. Static cohorts are manually managed lists, while dynamic cohorts are automatically updated every 24 hours.
Send one or more events to PostHog. Supports single event capture or batch capture of multiple events. Use this to track pageviews, custom events, screen views, identify users (`$identify`), create aliases (`$create_alias`), or send any custom event. Person properties can be set or updated via the `set` and `setOnce` fields.
Retrieve detailed information about a specific feature flag by its ID.
Retrieve detailed information about a specific A/B test experiment including its configuration, metrics, and results.
Permanently delete a feature flag. This cannot be undone.
Permanently delete a survey.
Retrieve detailed information and results for a specific insight by its ID.
Create a new dashboard for organizing insights and analytics visualizations.
List projects accessible with the current credentials. Provide organizationId to use PostHog's current organization-scoped project endpoint.
List all event definitions in the project. Event definitions describe the possible event names that have been captured. Use this to discover which events are available for querying, filtering, and analysis.
Search and list person profiles in PostHog. Supports filtering by search query and person properties. Returns paginated results with person details including distinct IDs and properties.
Delete an annotation from charts/dashboards.
Create a new cohort. Static cohorts are manually managed user lists; dynamic cohorts automatically include users matching specified criteria.
Update an existing dashboard's name, description, pinned status, or tags.
Update an existing A/B test experiment's name, description, dates, or configuration. Only provided fields will be updated.
Permanently delete a dashboard.
Retrieve detailed information about a specific dashboard by its ID, including its tiles and configuration.
Update an existing survey's name, description, questions, targeting, or dates. Only provided fields will be updated.
List all feature flags in the project. Supports searching by flag key or name. Returns flag configuration including key, active status, rollout percentage, and targeting rules.
Retrieve metadata about a specific session recording by its ID. Returns timing, activity metrics, and user information. Does not include the raw replay JSON.
Create a new survey with questions and optional targeting. Surveys can be of various types (e.g. popover) and can be linked to feature flags.
List annotations on charts/dashboards. Annotations mark significant events or deployments with text notes at specific dates.
Create a new annotation to mark a significant event or deployment on PostHog charts and dashboards.
Evaluate all feature flags for a specific user (distinct ID). Returns the computed flag values based on the user's properties and targeting rules. Optionally pass person properties and group properties inline for server-side evaluation without requiring prior identification.
Update an existing feature flag's name, active status, rollout percentage, or targeting configuration. Only provided fields will be updated.
Retrieve detailed information about a specific person by their PostHog person ID. Returns the person's distinct IDs, all properties, and creation timestamp.
Retrieve detailed information about a specific survey by its ID, including questions, targeting, and status.
Create a new feature flag. Supports boolean flags, multivariate flags (for A/B test variants), and remote config flags. Provide the key, name, and optionally configure rollout percentage and targeting filters.
List A/B test experiments in the project. Returns experiment metadata, status, and associated feature flag keys.
Retrieve detailed information about a specific cohort by its ID.
List all surveys in the project with their configuration, questions, and status.
List all dashboards in the project. Supports searching by name.
Execute an ad-hoc HogQL query against your PostHog data. HogQL is PostHog's SQL-like query language that supports querying events, persons, sessions, and more. Use this for custom analytics queries, aggregations, and data exploration that go beyond predefined insights.
Permanently delete a person profile from PostHog. This removes the person and all their associated data. To create or update persons, use the Capture Event tool with `$identify` event and `set`/`setOnce` properties instead.
Retrieve a specific PostHog annotation by ID.
Set or update properties for a PostHog group.
Create a PostHog action from event, selector, URL, or property matching steps.
Create or update a PostHog group for a configured group type.
Permanently delete a cohort from PostHog.
Delete a PostHog action.
Retrieve a specific PostHog action by ID, including its step rules.
List PostHog actions. Actions group one or more event patterns into reusable analytics definitions.
List configured PostHog group types. Use the returned groupTypeIndex with group list/find/update tools.
Update an annotation's content, date marker, or scope.
List groups for a specific PostHog group type. Uses PostHog's forward-only cursor pagination.
Update an existing cohort's name, description, static state, or filter groups.
Retrieve the current PostHog user, current organization, and current team/project context.
Permanently delete an experiment from PostHog.
Delete one or more properties from a PostHog group.
Update a PostHog action's metadata, tags, deletion state, or step rules.
List PostHog organizations accessible with the current credentials. Use an organization ID with List Projects for the current documented project API.
Find a specific PostHog group by group type index and group key.