PostHog MCP tools reference

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 to scope a session to a specific subset.

Tip: Browse the example prompts 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 (16 tools)
desktop-file-system-create
Create desktop channel
desktop-file-system-instructions-partial-update
Update channel instructions
desktop-file-system-instructions-retrieve
Get channel instructions
desktop-file-system-list
List desktop channels
desktop-file-system-retrieve
Get desktop channel
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 (15 tools)
dashboard-create
Create dashboard
dashboard-create-text-tile
Create dashboard text tile
dashboard-delete
Delete dashboard
dashboard-delete-tile
Delete dashboard tile
dashboard-get
Get dashboard
dashboard-insights-run
Run dashboard insights
dashboard-reorder-tiles
Reorder dashboard tiles
dashboard-tile-copy
Copy dashboard tile
dashboard-update
Update dashboard
dashboard-update-text-tile
Update dashboard text tile
dashboard-widget-catalog-list
List dashboard widget catalog
dashboard-widgets-batch-add
Add dashboard widgets
dashboard-widgets-run
Run dashboard widgets
dashboards-get-all
Get all dashboards
dashboards-move-tile-partial-update
Move dashboard tile
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 (38 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-connections-list
List direct-query connections
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 (1 tool)
event-definition-update
Update an event definition's metadata.
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-retrieve
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: report a problem with 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 (1 tool)
insight-query
Run a saved insight's query and return results.
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
Marketing analytics (7 tools)
marketing-analytics-conversion-goals
List conversion goals
marketing-analytics-data-sources
List marketing data sources health
marketing-analytics-diagnose
Diagnose marketing analytics setup
marketing-analytics-explain-conversion-goal
Explain a conversion goal
marketing-analytics-suggest-conversion-goals
Suggest conversion goal candidates
marketing-analytics-suggest-utm-mappings
Suggest utm_source → integration mappings
marketing-analytics-utm-audit
Audit UTM tagging quality
Notebooks (6 tools)
notebook-edit
Edit part of a notebook's content.
notebooks-create
Create notebook
notebooks-destroy
Delete notebook
notebooks-list
List notebooks
notebooks-partial-update
Update notebook
notebooks-retrieve
Get notebook
Organization & project management (3 tools)
projects-get
Fetches projects that the user has access to in the current organization.
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 (20 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.
promoted-product-intent-get
Get the team's promoted product.
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 (11 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-paths-actors
List persons on a paths insight
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 (12 tools)
vision-observations-list
List a session's replay vision observations
vision-observations-retrieve
Get a session's replay vision observation
vision-quota-retrieve
Get replay vision quota
vision-scanners-create
Create replay vision scanner
vision-scanners-delete
Delete replay vision scanner
vision-scanners-estimate-create
Estimate replay vision scanner volume
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
vision-scanners-update
Update replay vision scanner
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 Health (1 tool)
sdk-health-get
Get SDK health report
Session replays (10 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-summaries-list
List session summaries
session-recording-summarize
Generate AI-powered summaries of session recordings via streaming.
session-recording-summary-get
Get session summary
Signals (17 tools)
inbox-reports-list
List signal reports
inbox-reports-retrieve
Get signal report
inbox-reports-set-state
Dismiss or snooze a signal report
inbox-source-configs-create
Create signal source config
inbox-source-configs-list
List signal source configs
inbox-source-configs-partial-update
Update signal source config
inbox-source-configs-retrieve
Get signal source config
inbox-source-configs-update
Replace signal source config
signals-scout-config-list
List scout configs
signals-scout-config-update
Update a scout config
signals-scout-emit-signal
Emit a finding for a run
signals-scout-project-profile-get
Get the project profile
signals-scout-runs-list
List recent scout runs
signals-scout-runs-retrieve
Get a scout run by ID
signals-scout-scratchpad-forget
Forget a scratchpad entry by key
signals-scout-scratchpad-remember
Remember a scratchpad entry
signals-scout-scratchpad-search
Search the scout scratchpad
SQL (1 tool)
execute-sql
Execute an SQL query.
Surveys (11 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-launch
Launch a survey now.
survey-stats
Get response statistics for a specific survey.
survey-stop
Stop a survey now.
survey-update
Update an existing survey by ID.
surveys-get-all
List surveys in the project (server-side search + filters).
surveys-global-stats
Get aggregated response statistics across all surveys.
surveys-responses-list
List individual survey responses with resolved question text.
surveys-summarize-responses-create
Summarize survey responses (per question, or survey-wide headline).
Tasks (7 tools)
tasks-file-create
File a task into the project tree
tasks-list
List tasks
tasks-retrieve
Get task
tasks-runs-list
List task runs
tasks-runs-retrieve
Get task run
tasks-runs-session-logs-retrieve
Get task run session logs
tasks-unfile-create
Remove a task from the project tree
Tracing (8 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-count
Count spans
apm-spans-tree
Aggregate span call tree
apm-trace-get
Retrieve trace spans
query-apm-spans
Query tracing spans
User interview topics (18 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-partial-update
Set classifications on an interview response
user-interviews-retrieve
Retrieve a user interview response
user-interviews-search
Semantic search across interview responses
Visual review (11 tools)
visual-review-repos-list
List visual review repos
visual-review-repos-retrieve
Get visual review repo
visual-review-runs-approve-create
Mark visual review snapshots reviewed
visual-review-runs-counts-retrieve
Visual review run counts
visual-review-runs-finalize-create
Finalize a visual review run
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 (8 tools)
heatmaps-events
Get sessions behind heatmap coordinates
heatmaps-list
List heatmap interactions for a page
heatmaps-saved-create
Create a saved heatmap
heatmaps-saved-get
Get a saved heatmap
heatmaps-saved-list
List saved heatmaps
heatmaps-saved-regenerate
Regenerate a saved heatmap screenshot
heatmaps-saved-update
Update a saved heatmap
web-analytics-weekly-digest
Summarize web analytics
Workflows (14 tools)
hog-flows-logs-retrieve
Get workflow logs
hog-flows-metrics-retrieve
Get workflow metrics
workflows-archive
Archive workflow
workflows-blast-radius
Size workflow audience
workflows-create
Create workflow
workflows-enable
Enable workflow
workflows-get
Get workflow
workflows-list
List workflows
workflows-list-batch-jobs
List workflow batch runs
workflows-run
Test-run workflow
workflows-run-batch
Run batch workflow
workflows-schedule-create
Schedule workflow runs
workflows-update
Update workflow
workflows-update-schedule
Update workflow schedule

Keep exploring

Community questions

Was this page useful?

Questions about this page? or post a community question.