PostHog Tools

Add an existing insight to a dashboard. Requires insight ID and dashboard ID. Optionally supports layout and color customization.

Create a new dashboard in the project. Requires name and optional description, tags, and other properties.

Create a comprehensive A/B test experiment. PROCESS: 1) Understand experiment goal and hypothesis 2) Search existing feature flags first 3) Help user ...

Creates a new feature flag in the project. Once you have created a feature flag, you should: Ask the user if they want to add it to their codebase, Us...

Create an insight from a query that you have previously tested with 'posthog_run_query'. You should check the query runs before creating an insight. D...

Creates a new survey in the project. Surveys can be popover or API-based and support various question types including open-ended, multiple choice, rat...

Delete a dashboard by ID (soft delete - marks as deleted).

Delete an experiment by ID. CAUTION: This action cannot be undone.

Delete a feature flag in the project. CAUTION: This action cannot be undone.

Delete an insight by ID (soft delete - marks as deleted).

Delete a survey by ID (soft delete - marks as archived).

Generate HogQL (SQL) from natural language questions about your analytics data. Use when you need complex event analytics, custom aggregations, or que...

Get a specific dashboard by ID. The response will include insights / tiles that are on the dashboard.

Get all dashboards in the project with optional filtering. Can filter by pinned status, search term, or pagination.

Get detailed information about a specific error issue including stack traces, occurrence counts, affected users/sessions, and metadata. Useful for deb...

Get details of a specific experiment by ID.

Get comprehensive experiment results including all metrics data (primary and secondary) and exposure data. This tool fetches the experiment details an...

Get all experiments in the project.

Get the definition of a feature flag. You can provide either the flag_id or the flag_key. If you provide both, the flag_id will be used.

Get all feature flags in the project.

Get a specific insight by ID.

Get all saved analytics insights (charts, reports, dashboards tiles) in the project. Insights are saved queries showing trends, funnels, retention, pa...

Fetches the total LLM daily costs for each model for a project over a given number of days. If no number of days is provided, it defaults to 7. The re...

Get the details of the active organization.

Get the organizations the user has access to.

Fetches projects that the user has access to in the current organization.

Get a specific survey by ID. Returns the survey configuration including questions, targeting, and scheduling details.

Get all surveys in the project with optional filtering. Can filter by search term or use pagination.

Get aggregated response statistics across all surveys in the project. Includes event counts (shown, dismissed, sent), unique respondents, conversion r...

Get response statistics for a specific survey. Includes detailed event counts (shown, dismissed, sent), unique respondents, conversion rates, and timi...

List error tracking issues grouped by fingerprint. Returns aggregated statistics including exception types, counts, first/last seen timestamps, and un...

Retrieve all event definitions for the project. Events are the foundation of PostHog analytics - use this to discover what events are being tracked be...

Retrieve property definitions for events, persons, or groups. Properties are metadata attached to events and users - use this to discover available di...

Execute a query on an existing insight to get its results/data. Provide the insight ID to retrieve the current query results.

Run analytics queries to analyze events, pageviews, sessions, and user behavior. Use this to answer questions about event volume, metrics, conversion ...

Search the PostHog documentation for how to implement features, integrate SDKs, or use PostHog features. Use this when you need to help users add Post...

Change the active organization from the default organization. You should only use this tool if the user asks you to change the organization - otherwis...

Change the active project from the default project. You should only use this tool if the user asks you to change the project - otherwise, the default ...

Update an existing dashboard by ID. Can update name, description, pinned status or tags.

Update an existing experiment by ID. Can update name, description, lifecycle state, variants, metrics. To restart a concluded experiment, set end_date...

Update a feature flag in the project. To enable a feature flag, you should make sure it is active and the rollout percentage is set to 100 for the gro...

Update an existing insight by ID. Can update name, description, filters, and other properties. You should get the insight before updating it to see it...

Update an existing survey by ID. Can update name, description, questions, scheduling, and other survey properties.