# PostHog MCP tools reference - Docs

The PostHog MCP server exposes function-calling tools across every PostHog product – from feature flags and experiments to error tracking, logs, surveys, and SQL. Your agent picks the right tool based on the goals and context already in the conversation.

Tool names are stable and can be used with the [`tools` query parameter](/docs/model-context-protocol/faq.md#filtering-available-tools) to scope a session to a specific subset.

> **Tip:** Browse the [example prompts](/docs/model-context-protocol/use-cases.md) to see what each tool is good for in practice.

## Available tools

Click any category to expand the full list of tools it contains.

**Actions** (5 tools)

`action-create`

Create action

`action-delete`

Delete action

`action-get`

Get action

`action-update`

Update action

`actions-get-all`

Get all actions

**AI observability** (69 tools)

`evaluation-create`

Create a new evaluation.

`evaluation-delete`

Delete an evaluation.

`evaluation-get`

Get a specific evaluation by ID.

`evaluation-run`

Run an evaluation on a specific event.

`evaluation-test-hog`

Dry-run Hog evaluation code against sample events.

`evaluation-update`

Update an evaluation.

`evaluations-get`

List AI observability evaluations.

`get-llm-total-costs-for-project`

Fetches the total LLM daily costs for each model for a project over a given number of days.

`llma-clustering-job-get`

Get clustering job

`llma-clustering-job-list`

List clustering jobs

`llma-evaluation-config-get`

Get evaluation config

`llma-evaluation-config-set-active-key`

Set active evaluation provider key

`llma-evaluation-create`

Create evaluation

`llma-evaluation-delete`

Delete evaluation

`llma-evaluation-get`

Get evaluation

`llma-evaluation-judge-models`

List supported llm\_judge models

`llma-evaluation-list`

List evaluations

`llma-evaluation-report-create`

Create evaluation report config

`llma-evaluation-report-delete`

Delete evaluation report config

`llma-evaluation-report-generate`

Trigger evaluation report generation

`llma-evaluation-report-get`

Get evaluation report config

`llma-evaluation-report-list`

List evaluation report configs

`llma-evaluation-report-run-list`

List evaluation report runs

`llma-evaluation-report-update`

Update evaluation report config

`llma-evaluation-run`

Run evaluation

`llma-evaluation-summary-create`

Summarize evaluation results

`llma-evaluation-test-hog`

Test Hog evaluation code

`llma-evaluation-update`

Update evaluation

`llma-personal-spend`

Get my LLM spend analysis

`llma-prompt-create`

Create prompt

`llma-prompt-duplicate`

Duplicate prompt

`llma-prompt-get`

Get prompt

`llma-prompt-list`

List prompts

`llma-prompt-update`

Update prompt

`llma-review-queue-create`

Create review queue

`llma-review-queue-delete`

Delete review queue

`llma-review-queue-get`

Get review queue

`llma-review-queue-item-create`

Create review queue item

`llma-review-queue-item-delete`

Delete review queue item

`llma-review-queue-item-get`

Get review queue item

`llma-review-queue-item-list`

List review queue items

`llma-review-queue-item-update`

Update review queue item

`llma-review-queue-list`

List review queues

`llma-review-queue-update`

Update review queue

`llma-score-definition-create`

Create scorer

`llma-score-definition-get`

Get scorer

`llma-score-definition-list`

List scorers

`llma-score-definition-new-version`

Bump scorer to a new version

`llma-score-definition-update`

Update scorer metadata

`llma-sentiment-create`

Analyze sentiment

`llma-skill-archive`

Archive skill

`llma-skill-create`

Create skill

`llma-skill-duplicate`

Duplicate skill

`llma-skill-file-create`

Create skill file

`llma-skill-file-delete`

Delete skill file

`llma-skill-file-get`

Get skill file

`llma-skill-file-rename`

Rename skill file

`llma-skill-get`

Get skill

`llma-skill-list`

List skills

`llma-skill-update`

Update skill

`llma-summarization-create`

Summarize trace or generation

`llma-tagger-create`

Create tagger

`llma-tagger-list`

List taggers

`llma-tagger-test-hog`

Test Hog tagger code

`llma-trace-review-create`

Create trace review

`llma-trace-review-delete`

Delete trace review

`llma-trace-review-get`

Get trace review

`llma-trace-review-list`

List trace reviews

`llma-trace-review-update`

Update trace review

**Alerts** (6 tools)

`alert-create`

Create alert

`alert-delete`

Delete alert

`alert-get`

Get alert

`alert-simulate`

Simulate detector on insight

`alert-update`

Update alert

`alerts-list`

List alerts

**Annotations** (5 tools)

`annotation-create`

Create annotation

`annotation-delete`

Delete annotation

`annotation-retrieve`

Retrieve annotation

`annotations-list`

List annotations

`annotations-partial-update`

Update annotation

**Cohorts** (6 tools)

`cohorts-add-persons-to-static-cohort-partial-update`

Add persons to static cohort

`cohorts-create`

Create cohort

`cohorts-list`

List all cohorts

`cohorts-partial-update`

Update cohort

`cohorts-retrieve`

Get cohort

`cohorts-rm-person-from-static-cohort-partial-update`

Remove person from static cohort

**Conversations** (3 tools)

`conversations-tickets-list`

List support tickets

`conversations-tickets-retrieve`

Get support ticket

`conversations-tickets-update`

Update support ticket

**Core** (11 tools)

`project-get`

Get project

`project-settings-update`

Update project settings

`subscriptions-create`

Create subscription

`subscriptions-deliveries-list`

List subscription deliveries

`subscriptions-deliveries-retrieve`

Get subscription delivery

`subscriptions-list`

List subscriptions

`subscriptions-partial-update`

Update subscription

`subscriptions-retrieve`

Get subscription

`subscriptions-test-delivery-create`

Send test delivery

`user-get`

Get user

`user-settings-update`

Update user settings

**Customer analytics** (14 tools)

`accounts-create`

Create account

`accounts-destroy`

Delete account

`accounts-list`

List accounts

`accounts-notebooks-create`

Create account notebook

`accounts-notebooks-destroy`

Delete account notebook

`accounts-notebooks-list`

List account notebooks

`accounts-notebooks-retrieve`

Get account notebook

`accounts-partial-update`

Update account

`accounts-retrieve`

Get account

`usage-metrics-create`

Create usage metric

`usage-metrics-destroy`

Delete usage metric

`usage-metrics-list`

List usage metrics

`usage-metrics-partial-update`

Update usage metric

`usage-metrics-retrieve`

Get usage metric

**Dashboards** (7 tools)

`dashboard-create`

Create dashboard

`dashboard-delete`

Delete dashboard

`dashboard-get`

Get dashboard

`dashboard-insights-run`

Run dashboard insights

`dashboard-reorder-tiles`

Reorder dashboard tiles

`dashboard-update`

Update dashboard

`dashboards-get-all`

Get all dashboards

**Data pipelines** (8 tools)

`batch-export-create`

Create batch export

`batch-export-delete`

Delete batch export

`batch-export-get`

Get batch export

`batch-export-update`

Update batch export

`batch-exports-list`

List batch exports

`file-download-batch-exports-cancel-create`

Cancel a running file download export

`file-download-batch-exports-create`

Start file download export

`file-download-batch-exports-retrieve`

Get file download export status

**Data schema** (2 tools)

`read-data-schema`

Explore the user's events, actions, properties, and property values.

`read-data-warehouse-schema`

Read core data warehouse schemas and table lists.

**Data warehouse** (37 tools)

`data-warehouse-data-health-issues-retrieve`

List data pipeline health issues

`external-data-schemas-cancel`

Cancel running sync

`external-data-schemas-delete-data`

Delete synced table data

`external-data-schemas-incremental-fields-create`

Refresh candidate incremental fields for a schema

`external-data-schemas-list`

List data import schemas

`external-data-schemas-partial-update`

Update data import schema

`external-data-schemas-reload`

Trigger sync for a table schema

`external-data-schemas-resync`

Resync table schema from scratch

`external-data-schemas-retrieve`

Get data import schema

`external-data-sources-check-cdc-prerequisites-create`

Check Postgres CDC prerequisites

`external-data-sources-create`

Create data warehouse source

`external-data-sources-create-webhook-create`

Create and register a webhook for a source

`external-data-sources-db-schema`

Discover tables and sync methods for a source

`external-data-sources-delete-webhook-create`

Delete a source's webhook

`external-data-sources-destroy`

Delete data warehouse source

`external-data-sources-jobs`

List sync job history for a source with optional date and schema filters.

`external-data-sources-list`

List data warehouse sources

`external-data-sources-partial-update`

Update data warehouse source

`external-data-sources-refresh-schemas`

Refresh available schemas

`external-data-sources-reload`

Trigger sync for a source

`external-data-sources-retrieve`

Get data warehouse source

`external-data-sources-update-webhook-inputs-create`

Update webhook inputs (signing secret, etc.)

`external-data-sources-webhook-info-retrieve`

Get webhook status for a source

`external-data-sources-wizard`

Get source type configurations

`external-data-sync-logs`

Get sync job logs for a data warehouse table.

`sql-variables-create`

Create SQL variable

`sql-variables-delete`

Delete SQL variable

`sql-variables-update`

Update SQL variable

`view-create`

Create saved query

`view-delete`

Delete saved query

`view-get`

Get saved query

`view-list`

List saved queries

`view-materialize`

Materialize saved query

`view-run`

Run saved query

`view-run-history`

Get run history

`view-unmaterialize`

Revert materialization

`view-update`

Update saved query

**Debug** (1 tool)

`debug-mcp-ui-apps`

Debug tool for testing MCP Apps SDK.

**Docs** (1 tool)

`docs-search`

Search documentation

**Early access features** (5 tools)

`early-access-feature-create`

Create early access feature

`early-access-feature-destroy`

Delete early access feature

`early-access-feature-list`

List early access features

`early-access-feature-partial-update`

Update early access feature

`early-access-feature-retrieve`

Get early access feature

**Endpoints** (9 tools)

`endpoint-create`

Create endpoint

`endpoint-delete`

Delete endpoint

`endpoint-get`

Get endpoint

`endpoint-materialization-status`

Get materialization status

`endpoint-openapi-spec`

Get endpoint OpenAPI spec

`endpoint-run`

Run endpoint

`endpoint-update`

Update endpoint

`endpoint-versions`

Get endpoint versions

`endpoints-get-all`

Get all endpoints

**Error tracking** (17 tools)

`error-tracking-assignment-rules-create`

Create error tracking assignment rule

`error-tracking-assignment-rules-list`

List error tracking assignment rules

`error-tracking-grouping-rules-create`

Create error tracking grouping rule

`error-tracking-grouping-rules-list`

List error tracking grouping rules

`error-tracking-grouping-rules-update`

Update error tracking grouping rule

`error-tracking-issues-merge-create`

Merge error tracking issues

`error-tracking-issues-partial-update`

Update error tracking issue

`error-tracking-issues-split-create`

Split error tracking issue fingerprints

`error-tracking-suppression-rules-create`

Create error tracking suppression rule

`error-tracking-suppression-rules-list`

List error tracking suppression rules

`error-tracking-suppression-rules-update`

Update error tracking suppression rule

`error-tracking-symbol-sets-download-retrieve`

Download error tracking symbol set

`error-tracking-symbol-sets-list`

List error tracking symbol sets

`error-tracking-symbol-sets-retrieve`

Get error tracking symbol set

`query-error-tracking-issue`

Query error tracking issue

`query-error-tracking-issue-events`

Query error tracking issue events

`query-error-tracking-issues-list`

Query error tracking issues list

**Events & properties** (3 tools)

`event-definition-update`

Update an event definition's metadata.

`event-definitions-list`

List all event definitions in the project with optional filtering.

`properties-list`

Get properties for events or persons.

**Experiments** (23 tools)

`experiment-archive`

Archive experiment

`experiment-create`

Create experiment

`experiment-delete`

Delete experiment

`experiment-duplicate`

Duplicate experiment

`experiment-end`

End experiment

`experiment-get`

Get experiment details

`experiment-get-all`

Deprecated alias for experiment-list.

`experiment-launch`

Launch experiment

`experiment-list`

Get all experiments

`experiment-pause`

Pause experiment

`experiment-reset`

Reset experiment

`experiment-results-get`

Get experiment metric and exposure results with self-describing per-metric metadata.

`experiment-resume`

Resume experiment

`experiment-saved-metrics-create`

Create shared experiment metric

`experiment-saved-metrics-destroy`

Delete shared experiment metric

`experiment-saved-metrics-list`

List shared experiment metrics

`experiment-saved-metrics-partial-update`

Update shared experiment metric

`experiment-saved-metrics-retrieve`

Get shared experiment metric

`experiment-ship-variant`

Ship experiment variant

`experiment-stats`

Get experiment velocity stats

`experiment-timeseries-results`

Get experiment timeseries results

`experiment-unarchive`

Unarchive experiment

`experiment-update`

Update experiment

**Feature flags** (21 tools)

`create-feature-flag`

Create feature flag

`delete-feature-flag`

Delete feature flag

`feature-flag-get-all`

Get all feature flags

`feature-flag-get-definition`

Get feature flag definition

`feature-flags-activity-retrieve`

Get feature flag activity log

`feature-flags-bulk-delete-create`

Bulk delete feature flags

`feature-flags-bulk-keys-create`

Look up feature flag keys by ID

`feature-flags-bulk-update-tags-create`

Bulk update tags on feature flags

`feature-flags-copy-flags-create`

Copy feature flag across projects

`feature-flags-dependent-flags-retrieve`

Get dependent feature flags

`feature-flags-evaluation-reasons-retrieve`

Get feature flag evaluation reasons

`feature-flags-my-flags-retrieve`

Get my evaluated feature flags

`feature-flags-status-retrieve`

Get feature flag status

`feature-flags-test-evaluation-create`

Test feature flag evaluation

`feature-flags-user-blast-radius-create`

Get user blast radius

`scheduled-changes-create`

Create a scheduled change

`scheduled-changes-delete`

Delete a scheduled change

`scheduled-changes-get`

Get a scheduled change

`scheduled-changes-list`

List scheduled changes for feature flags

`scheduled-changes-update`

Update a scheduled change

`update-feature-flag`

Update feature flag

**Feedback** (1 tool)

`agent-feedback`

Optional: submit feedback about the PostHog MCP server.

**Function templates** (2 tools)

`cdp-function-templates-list`

List function templates

`cdp-function-templates-retrieve`

Get function template

**Functions** (9 tools)

`cdp-functions-create`

Create function

`cdp-functions-delete`

Delete function

`cdp-functions-invocations-create`

Test-invoke function

`cdp-functions-list`

List functions

`cdp-functions-logs-retrieve`

Get function logs

`cdp-functions-metrics-retrieve`

Get function metrics

`cdp-functions-partial-update`

Update function

`cdp-functions-rearrange-partial-update`

Reorder transformation execution

`cdp-functions-retrieve`

Get function

**Insights & analytics** (5 tools)

`hogql-schema`

List tables and columns available to HogQL queries.

`insight-query`

Run a saved insight's query and return results.

`query-generate-hogql-from-question`

Queries project's PostHog data based on a provided natural language question.

`query-run`

Run a trend, funnel, paths or HogQL query.

`query-validate`

Validate a HogQL query without executing it.

**Integrations** (4 tools)

`integration-delete`

Delete integration

`integration-get`

Get integration

`integrations-channels-retrieve`

List integration channels

`integrations-list`

List integrations

**Logs** (16 tools)

`logs-alerts-create`

Create log alert

`logs-alerts-destinations-create`

Attach alert destination

`logs-alerts-destinations-delete-create`

Detach alert destination

`logs-alerts-destroy`

Delete log alert

`logs-alerts-events-list`

List alert events

`logs-alerts-list`

List log alerts

`logs-alerts-partial-update`

Update log alert

`logs-alerts-retrieve`

Get log alert

`logs-alerts-simulate-create`

Simulate log alert

`logs-attribute-values-list`

List log attribute values

`logs-attributes-list`

List log attributes

`logs-count`

Count logs

`logs-count-ranges`

Count logs by time bucket

`logs-services-create`

List services with stats

`logs-sparkline-query`

Query logs sparkline

`query-logs`

Query logs

**Notebooks** (5 tools)

`notebooks-create`

Create notebook

`notebooks-destroy`

Delete notebook

`notebooks-list`

List notebooks

`notebooks-partial-update`

Update notebook

`notebooks-retrieve`

Get notebook

**Organization & project management** (4 tools)

`projects-get`

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

`property-definitions`

Get event and property definitions for the project.

`switch-organization`

Switch the active PostHog organization for subsequent tool calls.

`switch-project`

Switch the active PostHog project for subsequent tool calls.

**Persons** (7 tools)

`persons-bulk-delete`

Bulk delete persons

`persons-cohorts-retrieve`

Get person cohorts

`persons-list`

List persons

`persons-property-delete`

Delete person property

`persons-property-set`

Set person property

`persons-retrieve`

Get person

`persons-values-retrieve`

Get person property values

**Platform Features** (19 tools)

`activity-log-list`

List recent activity in the project.

`advanced-activity-logs-filters`

Get available activity log filter options.

`advanced-activity-logs-list`

List activity logs with advanced filtering.

`approval-policies-list`

List approval policies for the project.

`approval-policy-get`

Get a specific approval policy.

`change-request-get`

Get details of a specific approval request.

`change-requests-list`

List pending and resolved approval requests.

`comment-count`

Get comment counts.

`comment-get`

Get a specific comment.

`comment-thread`

Get all replies in a comment thread.

`comments-list`

List comments and discussion threads.

`org-members-list`

List organization members.

`organization-get`

Get organization details.

`organizations-list`

List organizations.

`role-get`

Get a specific role.

`role-members-list`

List members of a role.

`roles-list`

List organization roles.

`user-home-settings-get`

Get pinned tabs and homepage.

`user-home-settings-update`

Update pinned tabs and homepage.

**Product analytics** (8 tools)

`insight-create`

Create insight

`insight-delete`

Delete insight

`insight-get`

Get insight

`insight-update`

Update insight

`insights-activity-retrieve`

Get insight activity log

`insights-all-activity-retrieve`

Get recent insight activity across the project

`insights-list`

Get all insights

`insights-trending-retrieve`

Get most-viewed insights

**Query wrappers** (10 tools)

`query-funnel`

Run a funnel query

`query-lifecycle`

Run a lifecycle query

`query-lifecycle-actors`

List persons in a lifecycle bucket

`query-llm-trace`

Get LLM trace

`query-llm-traces-list`

List LLM traces

`query-paths`

Run a paths query

`query-retention`

Run a retention query

`query-stickiness`

Run a stickiness query

`query-trends`

Run a trends query

`query-trends-actors`

List persons behind a trends data point

**Replay vision** (5 tools)

`vision-scanners-get`

Get replay vision scanner

`vision-scanners-list`

List replay vision scanners

`vision-scanners-observations-get`

Get scanner observation

`vision-scanners-observations-list`

List scanner observations

`vision-scanners-scan-session`

Run scanner against a session now

**Reverse proxy** (6 tools)

`proxy-create`

Create reverse proxy

`proxy-delete`

Delete reverse proxy

`proxy-diagnose`

Diagnose reverse proxy

`proxy-get`

Get reverse proxy details

`proxy-list`

List reverse proxies

`proxy-retry`

Retry reverse proxy provisioning

**SDK Doctor** (1 tool)

`sdk-doctor-get`

Get SDK health report

**Search** (1 tool)

`entity-search`

Search for entities by name or description.

**Session replays** (8 tools)

`query-session-recordings-list`

List session recordings

`session-recording-delete`

Delete session recording

`session-recording-get`

Get session recording

`session-recording-playlist-create`

Create session recording playlist

`session-recording-playlist-get`

Get session recording playlist

`session-recording-playlist-update`

Update session recording playlist

`session-recording-playlists-list`

List session recording playlists

`session-recording-summarize`

Generate AI-powered summaries of session recordings via streaming.

**Signals** (4 tools)

`inbox-reports-list`

List signal reports

`inbox-reports-retrieve`

Get signal report

`inbox-source-configs-list`

List signal source configs

`inbox-source-configs-retrieve`

Get signal source config

**SQL** (1 tool)

`execute-sql`

Execute an SQL query.

**Surveys** (7 tools)

`survey-create`

Creates a new survey in the project.

`survey-delete`

Delete a survey by ID.

`survey-get`

Get a specific survey by ID.

`survey-stats`

Get response statistics for a specific survey.

`survey-update`

Update an existing survey by ID.

`surveys-get-all`

Get all surveys in the project with optional filtering.

`surveys-global-stats`

Get aggregated response statistics across all surveys.

**Tracing** (7 tools)

`apm-attribute-values-list`

List tracing attribute values

`apm-attributes-list`

List tracing span attributes

`apm-services-list`

List tracing service names

`apm-spans-aggregate`

Aggregate span statistics

`apm-spans-tree`

Aggregate span call tree

`apm-trace-get`

Retrieve trace spans

`query-apm-spans`

Query tracing spans

**User interview topics** (17 tools)

`user-interview-topics-add-interviewee`

Add an interviewee to a topic

`user-interview-topics-create`

Create user interview topic

`user-interview-topics-generate-links`

Generate public interview links for a topic

`user-interview-topics-interviewees-bulk-create`

Create many per-interviewee context rows at once

`user-interview-topics-interviewees-create`

Add per-interviewee context to a topic

`user-interview-topics-interviewees-destroy`

Delete a per-interviewee context row

`user-interview-topics-interviewees-list`

List per-interviewee contexts for a topic

`user-interview-topics-interviewees-partial-update`

Update a per-interviewee context row

`user-interview-topics-links-csv`

Export interview links for a topic as CSV

`user-interview-topics-list`

List user interview topics

`user-interview-topics-partial-update`

Update a user interview topic

`user-interview-topics-remove-interviewee`

Remove an interviewee from a topic

`user-interview-topics-retrieve`

Get user interview topic

`user-interview-topics-send-invites`

Email interview invites to every targeted interviewee

`user-interviews-list`

List user interview responses

`user-interviews-retrieve`

Retrieve a user interview response

`user-interviews-search`

Semantic search across interview responses

**Visual review** (10 tools)

`visual-review-repos-list`

List visual review repos

`visual-review-repos-retrieve`

Get visual review repo

`visual-review-runs-approve-create`

Approve visual review snapshots

`visual-review-runs-counts-retrieve`

Visual review run counts

`visual-review-runs-list`

List visual review runs

`visual-review-runs-retrieve`

Get visual review run

`visual-review-runs-snapshot-history-list`

Snapshot change history

`visual-review-runs-snapshots-list`

List run snapshots

`visual-review-runs-tolerate-create`

Tolerate visual review snapshot

`visual-review-runs-tolerated-hashes-list`

List tolerated hashes

**Web analytics** (1 tool)

`web-analytics-weekly-digest`

Summarize web analytics

**Workflows** (4 tools)

`hog-flows-logs-retrieve`

Get workflow logs

`hog-flows-metrics-retrieve`

Get workflow metrics

`workflows-get`

Get workflow

`workflows-list`

List workflows

## Keep exploring

-   [Use cases](/docs/model-context-protocol/use-cases.md) – example prompts and multi-step recipes
-   [FAQ and advanced setup](/docs/model-context-protocol/faq.md) – auth, scoping, and filtering
-   [Overview](/docs/model-context-protocol.md) – back to the MCP overview and install instructions

### Community questions

Ask a question

### Was this page useful?

HelpfulCould be better