# PostHog — how to use (mcp.ai)

Connect your PostHog account and use 507 tools for analytics straight from your AI agent. Connect with your own API key. PostHog is an open-source product analytics platform tracking user interactions and behaviors to help teams refine features, improve funnels, and reduce churn.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_posthog?ms=1787291520000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `posthog_add_dashboard_collaborators_with_access_level`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/posthog`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/posthog/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/posthog/add/dashboard/collaborators/with/access/level` — Add collaborators to a specific project dashboard. Requires 'project_id' and 'dashboard_id'. Supports JSON, form-urlencoded, and multipart data. Returns added collaborator details. Auth: 'PersonalAPIK
  - body: { level: integer, user_uuid: string, project_id: string, dashboard_id: integer }
- `POST https://api.mcp.ai/api/posthog/add/member/to/organization/role` — Add a member to an organization role by submitting their details and UUID in JSON/form, using organization and role IDs. Requires PersonalAPIKeyAuth. Success gives a 201 status.
  - body: { role_id: string, user_uuid: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/add/persons/to/static/cohort` — Add persons to a static cohort by their UUIDs. Use when you need to manually add specific users to a static cohort. Only works with static cohorts (is_static=true), not dynamic cohorts.
  - body: { id: integer, person_ids: string[], project_id: string }
- `POST https://api.mcp.ai/api/posthog/add/product/intent/to/project` — Tool to add a product intent to a PostHog project. Use when you need to register a project's intention to use a specific PostHog product feature. Product intents help track which features (product ana
  - body: { id: integer, product_type: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/add/project/specific/member/roles` — Add members with specific roles to a project by providing their user_uuid and level (member or admin). Requires project_id in the URL. Supports JSON, form-data, and form-urlencoded input. Returns the 
  - body: { level?: integer, user_uuid: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/add/session/recording/to/playlist` — Add an existing session recording to a playlist. This endpoint associates a specific session recording with a playlist, making it part of that collection. Requires 'project_id' (project identifier), '
  - body: { id?: integer, name?: string, pinned?: boolean, deleted?: boolean, filters?: string, short_id: string, created_at?: string, project_id: string, short_id_1?: string, description?: string, derived_name?: string, last_modified_at?: string, session_recording_id: string }
- `POST https://api.mcp.ai/api/posthog/append/desktop/recording/segments` — Append transcript segments to an existing desktop recording for real-time streaming support. Use when you need to add new transcript segments to a recording in batches as they become available from tr
  - body: { id: string, segments: object[], project_id: string }
- `POST https://api.mcp.ai/api/posthog/archive/survey/response` — Tool to archive a single survey response. Use when you need to hide a survey response from analytics while preserving it in the database.
  - body: { id: string, project_id: string, response_uuid: string }
- `POST https://api.mcp.ai/api/posthog/assign/feature/flag/role/based/access` — Set up role-based access for a feature flag using `project_id` and `feature_flag_id`. Submit access info in JSON or form format, with `feature_flag:write` rights. Success returns new details with a 20
  - body: { role_id: string, project_id: string, feature_flag_id: integer }
- `POST https://api.mcp.ai/api/posthog/bulk/create/organization/invites` — POST /api/organizations/{organization_id}/invites/bulk/: Bulk-create organization invites with customizable levels, sender details, and validation checks. Supports email automation and private project
  - body: { invites: object[], organization_id: string }
- `POST https://api.mcp.ai/api/posthog/bulk/delete/feature/flags` — Bulk delete feature flags by filter criteria or explicit IDs. Use when you need to delete multiple feature flags at once. Accepts either 'filters' (same filter params as list endpoint: search, active,
  - body: { ids?: integer[], filters?: object, project_id: string }
- `POST https://api.mcp.ai/api/posthog/bulk/delete/persons` — Tool to bulk delete persons by PostHog person IDs or distinct IDs. Use when you need to delete multiple persons at once (up to 100 per call). Only events captured before the request will be deleted. D
  - body: { ids?: string[], format?: string, project_id: string, keep_person?: boolean, distinct_ids?: string[], delete_events?: boolean, delete_recordings?: boolean }
- `POST https://api.mcp.ai/api/posthog/cancel/project/insights` — The "/api/projects/{project_id}/insights/cancel/" endpoint allows users to cancel insights for a project by providing a project ID and insight details in JSON or CSV, and confirms cancellation in the 
  - body: { id?: integer, name?: string, tags?: string[], hogql?: string, order?: integer, query?: string, saved?: boolean, types?: string, format?: string, result?: string, columns?: string, deleted?: boolean, filters?: string, short_id?: string, timezone?: string, favorited?: boolean, is_cached?: string, is_sample?: boolean, created_at?: string, dashboards?: integer[], project_id: string, updated_at?: string, description?: string, derived_name?: string, last_refresh?: string, query_status?: string, client_query_id?: string, dashboard_tiles?: object[], cache_target_age?: string, last_modified_at?: string, next_allowed_client_refresh?: string }
- `POST https://api.mcp.ai/api/posthog/capture/event` — Capture (ingest) a single analytics event into PostHog using the public ingestion API and a project API key. Use when you need to send custom events like 'lesson_started', 'quiz_completed', or any use
  - body: { event: string, api_key: string, timestamp?: string, properties?: object, distinct_id: string, ingest_host?: string }
- `POST https://api.mcp.ai/api/posthog/check/pipeline/destination/updates` — Check for available updates to a pipeline destination plugin by comparing the currently installed version (tag) with the latest version available in the plugin's repository. Use this to determine if a
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/check/pipeline/import/app/updates` — Retrieve the latest update information for a specific pipeline import app by its ID within an organization. This endpoint returns details such as plugin type, name, description, and version data. Requ
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/check/pipeline/plugin/update/status` — Get update status for a specific pipeline transformation plugin by its unique ID within an organization. This endpoint requires the 'organization_id' and 'plugin' IDs and returns details like plugin t
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/check/project/demo/data/generation/status` — Check if a project is currently generating demo data. This endpoint retrieves the demo data generation status for a specific project within an organization. Returns whether the project is currently in
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/create/ai/insight` — Tool to create and query insights using PostHog's Max AI assistant. Use when you need to generate insights from natural language queries. The AI interprets your query and creates the appropriate insig
  - body: { query: string, project_id: string, insight_type: string }
- `POST https://api.mcp.ai/api/posthog/create/alert` — Tool to create a new alert configuration in PostHog. Use when you need to set up monitoring for insights with specific thresholds and notification settings. The alert will monitor the specified insigh
  - body: { name: string, config?: object, enabled: boolean, insight: integer, condition?: object, threshold: object, project_id: string, skip_weekend?: boolean, snoozed_until?: string, subscribed_users: integer[], calculation_interval?: string|object }
- `POST https://api.mcp.ai/api/posthog/create/batch` — Capture a batch of analytics events to PostHog using the public batch ingestion API. Use when you need to send multiple events efficiently in a single request (e.g., bulk event imports, offline event 
  - body: { batch: object[], api_key: string }
- `POST https://api.mcp.ai/api/posthog/create/batch/export` — Create a new batch export to automatically export PostHog data to external destinations like S3, BigQuery, or Snowflake. Use when you need to set up scheduled data exports with configurable intervals 
  - body: { name: string, model?: string, end_at?: string, paused?: boolean, schema?: object, filters?: object, interval: string, start_at?: string, timezone?: string, offset_day?: integer, project_id: string, destination: object, hogql_query?: string, offset_hour?: integer }
- `POST https://api.mcp.ai/api/posthog/create/batch/export/backfill` — Tool to create a new backfill for a BatchExport. Use when you need to re-export historical data for a specific time range. Requires valid start_at and end_at timestamps in ISO 8601 format. The end_at 
  - body: { end_at: string, start_at: string, project_id: string, batch_export_id: string }
- `POST https://api.mcp.ai/api/posthog/create/batch/export/test/run` — Tool to run a test step for a batch export configuration in PostHog. Use when you need to validate that a batch export is properly configured before enabling it. This endpoint triggers a test run to v
  - body: { id: string, name: string, model?: string, end_at?: string, paused: boolean, schema?: object, filters?: object, team_id: integer, interval: string, start_at?: string, timezone?: string|object, created_at: string, offset_day?: integer, project_id: string, destination: object, hogql_query?: string, latest_runs: object[], offset_hour?: integer, last_paused_at?: string, last_updated_at: string }
- `POST https://api.mcp.ai/api/posthog/create/custom/project/insights` — Create custom analytics insights for a PostHog project. Supported query types (InsightVizNode.source.kind): TrendsQuery, FunnelsQuery, RetentionQuery, PathsQuery, StickinessQuery, LifecycleQuery, WebS
  - body: { id?: integer, name?: string, tags?: string[], hogql?: string, order?: integer, query?: string, saved?: boolean, types?: string, format?: string, result?: string, columns?: string, deleted?: boolean, filters?: string, short_id?: string, timezone?: string, favorited?: boolean, is_cached?: string, is_sample?: boolean, created_at?: string, dashboards?: integer[], project_id: string, updated_at?: string, description?: string, derived_name?: string, last_refresh?: string, query_status?: string, dashboard_tiles?: object[], cache_target_age?: string, last_modified_at?: string, next_allowed_client_refresh?: string }
- `POST https://api.mcp.ai/api/posthog/create/customer/profile/config` — Create a customer profile configuration for a PostHog project. Use when you need to configure how customer profiles are displayed and organized for persons or groups within a project.
  - body: { scope: string, content?: object, sidebar?: object, project_id: string }
- `POST https://api.mcp.ai/api/posthog/create/data/color/theme` — Tool to create a new data color theme in a PostHog project. Use when you need to define custom color palettes for data visualization. Requires a theme name and list of hex color codes. Returns the cre
  - body: { name: string, colors: string[], project_id: string }
- `POST https://api.mcp.ai/api/posthog/create/dataset` — Tool to create a new dataset in a PostHog project. Use when you need to create a dataset for organizing data. Requires a project ID and a dataset name; description and metadata are optional.
  - body: { name: string, metadata?: object, project_id: string, description?: string }
- `POST https://api.mcp.ai/api/posthog/create/dataset/item` — Tool to create a new dataset item in a PostHog project dataset. Use when you need to add a new item with input/output data to a dataset for ML/AI experimentation or tracking.
  - body: { input?: object, output?: object, dataset: string, metadata?: object, project_id: string, ref_trace_id?: string, ref_source_id?: string, ref_timestamp?: string }
- `POST https://api.mcp.ai/api/posthog/create/desktop/recording` — Create a new desktop recording and get Recall.ai upload token for the desktop SDK. Use when you need to initiate a new recording session and obtain credentials for uploading audio/video data.
  - body: { platform?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/create/endpoint` — Tool to create a new endpoint for a PostHog project. Endpoints allow you to define and execute custom queries (HogQL, Trends, Funnels, etc.) that can be accessed via a URL-safe name. Use when you need
  - body: { name: string, query: object, version?: integer, is_active?: boolean, project_id: string, description?: string, sync_frequency?: string, is_materialized?: boolean, cache_age_seconds?: number, derived_from_insight?: string }
- `POST https://api.mcp.ai/api/posthog/create/error/tracking/autocapture/control` — Tool to create a new error tracking autocapture control configuration for a PostHog project. Use when you need to set up error tracking rules for specific libraries with URL triggers, event triggers, 
  - body: { id: string, library: string, match_type?: string, project_id: string, sample_rate?: string, url_triggers?: string[], url_blocklist?: string[], event_triggers?: string[], linked_feature_flag?: string|object }
- `POST https://api.mcp.ai/api/posthog/create/error/tracking/release` — Create a new error tracking release in PostHog. Use when you need to register a new application version or deployment for error tracking purposes. This helps track errors across different versions of 
  - body: { id: string, hash_id: string, project: string, team_id: integer, version: string, metadata?: object, created_at: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/create/error/tracking/suppression/rule` — Tool to create a new error tracking suppression rule for a project. Use when you need to automatically suppress specific error tracking issues based on filters. Suppression rules prevent matching erro
  - body: { id: string, filters: object, order_key: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/create/evaluation` — Create a new evaluation for a PostHog project to assess AI-generated content or responses. Use when you need to set up LLM-based evaluation criteria for quality assessment, content moderation, or perf
  - body: { name: string, deleted?: boolean, enabled?: boolean, conditions?: object, project_id: string, description?: string, output_type: string, output_config?: object, evaluation_type: string, evaluation_config?: object, model_configuration?: object }
- `POST https://api.mcp.ai/api/posthog/create/evaluation/run` — Tool to create a new evaluation run and enqueue a Temporal workflow to asynchronously execute the evaluation. Use when you need to run an evaluation against a specific event in PostHog. Returns HTTP 2
  - body: { event: string, timestamp: string, project_id: string, evaluation_id: string, target_event_id: string }
- `POST https://api.mcp.ai/api/posthog/create/event/definition` — Create a new event definition in a PostHog project. Event definitions help you organize and document the events being tracked in your application. Use this to formally define events, add descriptions,
  - body: { name: string, tags?: string[], owner?: integer, verified?: boolean, project_id: string, description?: string }
- `POST https://api.mcp.ai/api/posthog/create/experiment/exposure/cohort` — Create a new exposure cohort for an experiment in a project by sending a POST request with experiment details and feature flag data. Requires experiment ID and project ID in the path.
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/create/experiment/holdout` — Tool to create a new experiment holdout group in PostHog. Use when you need to set up a control group for experiments with specific filter configurations and rollout percentages.
  - body: { name: string, filters: object[], project_id: string, description?: string }
- `POST https://api.mcp.ai/api/posthog/create/experiment/saved/metric` — Tool to create a new experiment saved metric in a PostHog project. Use when you need to define a reusable metric configuration for experiments. The query field requires 'kind' (ExperimentTrendsQuery o
  - body: { name: string, tags?: string[], query: object, project_id: string, description?: string }
- `POST https://api.mcp.ai/api/posthog/create/feature/flag` — Tool to create a new feature flag in a PostHog project. Use when you need to add feature toggles, perform gradual rollouts, or target specific user segments without deploying new code.
  - body: { key: string, name?: string, tags?: string[], active?: boolean, deleted?: boolean, filters?: object, project_id: string, is_simple_flag?: boolean, ensure_experience_continuity?: boolean }
- `POST https://api.mcp.ai/api/posthog/create/feature/flag/cohort` — Manage feature flags for apps with create, read, update, and delete operations using PostHog's JavaScript Library or dedicated endpoint. More info in the docs.
  - body: { id: integer, key?: string, name?: string, tags?: string[], active?: boolean, deleted?: boolean, filters?: object, surveys?: object, can_edit?: boolean, features?: object, created_at?: string, project_id: string, experiment_set?: integer[], is_simple_flag?: boolean, usage_dashboard?: integer, performed_rollback?: boolean, rollout_percentage?: integer, rollback_conditions?: string, analytics_dashboards?: integer[], has_enriched_analytics?: boolean, ensure_experience_continuity?: boolean }
- `POST https://api.mcp.ai/api/posthog/create/feature/flag/dashboard` — Manage feature flags by creating, reading, updating, and deleting them. Utilize JavaScript library or endpoint for user-specific flag status. Refer to documentation for details.
  - body: { id: integer, key?: string, name?: string, tags?: string[], active?: boolean, deleted?: boolean, filters?: object, surveys?: object, can_edit?: boolean, features?: object, created_at?: string, project_id: string, experiment_set?: integer[], is_simple_flag?: boolean, usage_dashboard?: integer, performed_rollback?: boolean, rollout_percentage?: integer, rollback_conditions?: string, analytics_dashboards?: integer[], has_enriched_analytics?: boolean, ensure_experience_continuity?: boolean }
- `POST https://api.mcp.ai/api/posthog/create/file/system` — Tool to create a new file system resource in PostHog with specified metadata and hierarchy. Use when you need to create folders, files, or other organizational structures in a project.
  - body: { id: string, ref?: string, href?: string, meta?: object, path: string, type: string, depth?: integer, shortcut?: boolean, created_at: string, project_id: string, last_viewed_at?: string }
- `POST https://api.mcp.ai/api/posthog/create/file/system/shortcut` — Create a new file system shortcut in a PostHog project. Requires 'file_system_shortcut:write' permission. Returns the created shortcut with all its properties including UUID, path, type, and creation 
  - body: { id?: string, ref?: string, href?: string, path: string, type: string, created_at?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/create/group/type/metric` — Tool to create a new metric for a specific group type in a PostHog project. Use when you need to define custom metrics to track group-level analytics (e.g., company revenue, team activity). Requires p
  - body: { id: string, name: string, format?: string, display?: string, filters: object, interval?: integer, project_id: string, group_type_index: integer }
- `POST https://api.mcp.ai/api/posthog/create/hog/function` — Create a new hog function in PostHog. Hog functions are serverless functions that can be triggered by events, used for transformations, destinations, or site applications. Use when you need to set up 
  - body: { hog?: string, name: string, type: string, inputs: object, deleted?: boolean, enabled?: boolean, filters?: object, masking?: object, icon_url?: string, project_id: string, description?: string, template_id: string, execution_order?: integer }
- `POST https://api.mcp.ai/api/posthog/create/insight/variable` — Create a new insight variable for a PostHog project. Insight variables allow you to define reusable parameters that can be referenced across insights and queries. Use when you need to create configura
  - body: { name: string, type: string, values?: string|integer|number|boolean|string|integer|number|boolean[]|object, code_name: string, project_id: string, default_value?: string|integer|number|boolean|string|integer|number|boolean[]|object }
- `POST https://api.mcp.ai/api/posthog/create/live/debugger/breakpoint` — Tool to create a new live debugger breakpoint in a PostHog project. Use when you need to set up debugging instrumentation for a specific file and line number in your application code. Client applicati
  - body: { enabled?: boolean, filename: string, condition?: string, project_id: string, repository?: string, line_number: integer }
- `POST https://api.mcp.ai/api/posthog/create/llm/analytics/summarization` — Generate an AI-powered summary of an LLM trace or event. This endpoint analyzes the provided trace/event, generates a line-numbered text representation, and uses an LLM to create a concise summary wit
  - body: { data: object, mode?: string, model?: string, project_id: string, force_refresh?: boolean, summarize_type: string }
- `POST https://api.mcp.ai/api/posthog/create/llm/analytics/text/representation` — Tool to generate human-readable text representations of LLM trace events for display, logging, or analysis. Use when you need to convert LLM analytics events ($ai_generation, $ai_span, $ai_embedding, 
  - body: { data: object, options?: object, event_type: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/create/logs/export` — Tool to create a logs export job using HogQL queries in PostHog. Use when you need to export event logs or query results for analysis. The endpoint creates an asynchronous export job and returns metad
  - body: { query: object, project_id: string }
- `POST https://api.mcp.ai/api/posthog/create/organization` — Create a new PostHog organization with configurable security and notification settings. This action creates a new organization and automatically provisions a default project with an API token. The org
  - body: { name: string, enforce_2fa?: boolean, is_member_join_email_enabled?: boolean }
- `POST https://api.mcp.ai/api/posthog/create/organization/invite` — Create and send an organization invitation to a user via email. This allows you to invite people to join your PostHog organization with a specific role (member, admin, or owner). The action creates an
  - body: { level?: integer, message?: string, first_name?: string, send_email?: boolean, target_email: string, organization_id: string, private_project_access?: string }
- `POST https://api.mcp.ai/api/posthog/create/organization/proxy/record` — Create a managed reverse proxy record for an organization to enable custom domain routing for PostHog analytics events. This bypasses ad blockers by routing analytics through your own domain. After cr
  - body: { domain: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/create/organization/role` — Create a new custom role within a PostHog organization with optional feature flag access permissions. This action creates an organization role that can be assigned to members to control their access l
  - body: { name: string, organization_id: string, feature_flags_access_level?: integer }
- `POST https://api.mcp.ai/api/posthog/create/organization/saml/domain` — Create and configure an authentication domain with SAML SSO for a PostHog organization. Requires Enterprise plan. Adds an email domain (e.g., 'company.com') to your organization and configures SAML Si
  - body: { domain: string, saml_acs_url?: string, saml_entity_id?: string, saml_x509_cert?: string, organization_id: string, sso_enforcement?: string, jit_provisioning_enabled?: boolean }
- `POST https://api.mcp.ai/api/posthog/create/persisted/folder` — Tool to create a new persisted folder in a PostHog project. Use when you need to create a new folder for organizing data storage with a specific type and configuration.
  - body: { id: string, path?: string, type: string, protocol?: string, created_at: string, project_id: string, updated_at: string }
- `POST https://api.mcp.ai/api/posthog/create/person/path` — Retrieve path analytics for a specific person within a PostHog project. This endpoint returns the navigation paths and user journey data for a person. Note: This endpoint requires session-based authen
  - body: { id: integer, name: string, uuid: string, format?: string, created_at: string, project_id: string, properties?: string, distinct_ids: string[] }
- `POST https://api.mcp.ai/api/posthog/create/product/tour` — Tool to create a new product tour in a PostHog project. Use when you need to set up guided tours to onboard users or highlight features. Requires a project_id and a name for the tour.
  - body: { name: string, content?: object, archived?: boolean, end_date?: string, project_id: string, start_date?: string, auto_launch?: boolean, description?: string, linked_flag_id?: integer, targeting_flag_filters?: object }
- `POST https://api.mcp.ai/api/posthog/create/project/action` — This POST endpoint creates actions for a project, accepts various data types, requires project_id and action data, optionally outputs in CSV/JSON, and needs PersonalAPIKeyAuth, returning a 201 with ac
  - body: { id?: integer, name?: string, tags?: string[], steps?: object[], format?: string, deleted?: boolean, team_id?: integer, is_action?: boolean, created_at?: string, project_id: string, description?: string, post_to_slack?: boolean, bytecode_error?: string, is_calculating?: boolean, last_calculated_at?: string, slack_message_format?: string }
- `POST https://api.mcp.ai/api/posthog/create/project/cohort` — Create cohorts for a specified project by POSTing JSON-form data to "/api/projects/{project_id}/cohorts/". Provide project_id in URL and the necessary payload, adhering to JSON schema constraints. Aut
  - body: { name: string, query?: string, groups?: string, deleted?: boolean, filters?: string, is_static?: boolean, project_id: string, description?: string }
- `POST https://api.mcp.ai/api/posthog/create/project/dashboard` — The POST endpoint creates a dashboard within a project using a `project_id`, accepting details in JSON/form formats. It uses 'PersonalAPIKeyAuth' for security and returns HTTP 201 with dashboard detai
  - body: { name: string, tags?: string[], tiles?: object[], pinned?: boolean, deleted?: boolean, filters?: string, project_id: string, description?: string, use_template?: string, use_dashboard?: integer, delete_insights?: boolean, restriction_level?: integer }
- `POST https://api.mcp.ai/api/posthog/create/project/experiment` — Create a new experiment in a specific project using JSON, form, or multipart data. Requires project_id and experiment details, secured with PersonalAPIKeyAuth. Generates a 201 response with experiment
  - body: { name: string, filters?: string, archived?: boolean, end_date?: string, parameters?: string, project_id: string, start_date?: string, description?: string, feature_flag_key: string, secondary_metrics?: string }
- `POST https://api.mcp.ai/api/posthog/create/project/insights/with/format/option` — Create a new analytics insight in a PostHog project. Insights are saved queries that visualize data from your analytics events. Use this to create trends, funnels, retention, or other analytics visual
  - body: { name?: string, tags?: string[], order?: integer, query?: string, saved?: boolean, format?: string, deleted?: boolean, filters?: string, favorited?: boolean, dashboards?: integer[], project_id: string, description?: string, derived_name?: string }
- `POST https://api.mcp.ai/api/posthog/create/project/notebook` — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
  - body: { title?: string, content?: string, project_id: string, text_content?: string }
- `POST https://api.mcp.ai/api/posthog/create/project/pipeline/frontend/app/job` — Create a job for a pipeline frontend app config in a project. Requires `project_id` and config `id`, accepting JSON/form-data. Returns the created job's details.
  - body: { id: integer, job?: object, project_id: string }
- `POST https://api.mcp.ai/api/posthog/create/project/retention/insight` — Create and retrieve retention insights for a project using PostHog's Query API. Analyzes how users return over time based on specified events or actions. Uses the /api/projects/{project_id}/query/ end
  - body: { query?: object, refresh?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/create/project/subscription` — Create a subscription for a given project by providing required details such as delivery method, frequency, and starting date. Requires a project ID and supports various content types. Returns the new
  - body: { count?: integer, title?: string, deleted?: boolean, insight?: integer, bysetpos?: integer, interval?: integer, byweekday?: string[], dashboard?: integer, frequency: string, project_id: string, start_date: string, until_date?: string, target_type: string, target_value: string, invite_message?: string }
- `POST https://api.mcp.ai/api/posthog/create/project/survey` — Create surveys in a project by providing a project ID and details like type, questions, and targets in JSON, form-data, or urlencoded format. Use PersonalAPIKeyAuth for security. Get a survey object o
  - body: { id?: string, name: string, type: string, archived?: boolean, end_date?: string, questions?: string, appearance?: string, conditions?: string, created_at?: string, project_id: string, start_date?: string, description?: string, linked_flag_id?: integer, iteration_count?: integer, responses_limit?: integer, current_iteration?: integer, targeting_flag_id?: integer, iteration_start_dates?: string[], remove_targeting_flag?: boolean, targeting_flag_filters?: string, iteration_frequency_days?: integer, current_iteration_start_date?: string }
- `POST https://api.mcp.ai/api/posthog/create/query/in/project/by/id` — The `/api/projects/{project_id}/query/` POST endpoint allows users to submit queries for a specific project by providing the project ID in the URL and the query details in JSON or form data. Authentic
  - body: { async?: boolean, query: object, refresh?: string, project_id: string, client_query_id?: string }
- `POST https://api.mcp.ai/api/posthog/create/session/recording/playlist` — Create playlists of session recordings for a specified project. Requires 'project_id' path parameter and personal API key with write access. Supports JSON, form-encoded, or multipart data. Returns 201
  - body: { id?: integer, name: string, type: string, pinned?: boolean, deleted?: boolean, filters?: string, short_id?: string, created_at?: string, project_id: string, description?: string, derived_name?: string, last_modified_at?: string }
- `POST https://api.mcp.ai/api/posthog/create/session/recording/summary` — Generate an AI-powered summary for a session recording. Requires PostHog AI feature to be enabled. Provide the project_id and the session recording's UUID to get an AI-generated summary including key 
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/create/survey/summary/headline` — Tool to create or regenerate a summary headline for a survey. Use when you need to generate an AI-powered headline summary of survey responses for a specific project survey. The endpoint processes sur
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/create/warehouse/saved/query` — Create a new warehouse saved query in PostHog for data warehouse operations. Use this to define reusable HogQL queries that can be executed against your warehouse tables. The query name must contain o
  - body: { name: string, query: object, project_id: string }
- `POST https://api.mcp.ai/api/posthog/create/web/experiment` — Create a new web experiment in a PostHog project. Web experiments allow you to run A/B tests by dynamically transforming DOM elements on your website based on feature flag variants. Use when you want 
  - body: { id: integer, name: string, variants: object, project_id: string, feature_flag_key: string }
- `POST https://api.mcp.ai/api/posthog/delete/alert` — Delete an alert configuration by providing its UUID and the associated project ID. Requires 'alert:write' permission. Returns no content with a 204 status on success.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/customer/profile/config` — Tool to delete a customer profile configuration by ID in a PostHog project. Use when you need to remove a customer profile config that is no longer needed. Returns a 204 No Content status on successfu
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/desktop/recording` — Tool to delete a desktop meeting recording by its UUID and project ID. Use when you need to permanently remove a desktop recording from a PostHog project.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/endpoint` — Delete an endpoint and clean up materialized query. Returns no content with a 204 status on success. Use when you need to remove an endpoint configuration from a PostHog project.
  - body: { name: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/error/tracking/autocapture/control` — Delete an error tracking autocapture control configuration by UUID and project ID. Use when you need to remove autocapture settings for error tracking.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/error/tracking/grouping/rule` — Delete a specific error tracking grouping rule by ID. Use when you need to remove a custom grouping rule that is no longer needed or was created incorrectly.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/error/tracking/release` — Delete an error tracking release by its UUID and project ID. Use when you need to remove a specific release from error tracking. Requires 'error_tracking:write' scope. Returns 204 No Content on succes
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/error/tracking/suppression/rule` — Tool to delete an error tracking suppression rule by its UUID. Use when you need to remove a suppression rule that is no longer needed. Requires 'error_tracking:write' permission.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/experiment/holdout` — Delete an experiment holdout by providing its ID and the associated project ID. Requires 'experiment:write' permission. Returns no content with a 204 status on success.
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/experiment/saved/metric` — Tool to delete an experiment saved metric by ID from a PostHog project. Use when you need to remove a saved metric configuration from an experiment. Returns HTTP 204 No Content on success.
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/feature/flag/role/access` — DELETE /api/projects/{project_id}/feature_flags/{feature_flag_id}/role_access/{id}: Remove role access from a feature flag in a project by ID, requiring authorization. Expect no response body upon suc
  - body: { id: integer, project_id: string, feature_flag_id: integer }
- `POST https://api.mcp.ai/api/posthog/delete/file/system` — Tool to delete a file system resource in PostHog by UUID. Use when you need to permanently remove a file system. Returns deletion information including undo options if available.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/group/type/metric` — Tool to delete a group usage metric by its UUID within a specific project and group type. Use when you need to remove a metric that tracks group-level analytics. Requires 'group:write' permission.
  - body: { id: string, project_id: string, group_type_index: integer }
- `POST https://api.mcp.ai/api/posthog/delete/insight` — Attempt to delete an insight by its ID from a specific project. This action is irreversible — the insight cannot be recovered once removed. Use this action when you need to permanently remove an insig
  - body: { id: integer, format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/insight/variable` — Delete an insight variable by its UUID from a specified project. Requires 'insight_variable:write' permission. Returns no content with a 204 status on success.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/live/debugger/breakpoint` — Delete a live debugger breakpoint by providing its UUID and project ID. Requires 'live_debugger:write' permission. Returns no content with a 204 status on success.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/organization` — Delete an organization by its UUID. Requires a 'PersonalAPIKeyAuth' with 'organization:write' permission. On success, returns a 204 status code with no response body.
  - body: { id: string }
- `POST https://api.mcp.ai/api/posthog/delete/organization/batch/export` — Delete a specific batch export by its UUID in an organization. Requires PersonalAPIKeyAuth with batch_export:write permission. Returns 204 on success with no response body.
  - body: { id: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/organization/domain` — Delete a specific domain by its UUID within an organization, given valid organization and domain IDs. Requires 'organization:write' permission; no response body on success (204).
  - body: { id: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/organization/member` — Remove a member from a PostHog organization by their user UUID. This action is idempotent - calling it multiple times with the same parameters will always succeed without error, even if the member has
  - body: { user__uuid: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/organization/pipeline/destination` — Delete a specific pipeline destination in an organization by ID. Requires an integer 'id' of the destination, and the organization's 'uuid'. Auth: PersonalAPIKey with plugin:write. No return body on s
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/organization/pipeline/import/app` — Delete a specific pipeline import app plugin associated with an organization by ID. Requires a personal API key with write permissions for plugins. Responds with no content on success (204).
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/organization/pipeline/transformation` — Delete a specific pipeline transformation plugin for an organization by ID. Requires a UUID for the organization and an integer for the plugin. Auth: PersonalAPIKey with write access. No response body
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/organization/plugin` — Delete a specific plugin (by its integer ID) from the organization (identified by UUID) with no response body on success. Requires plugin:write authorization via PersonalAPIKeyAuth.
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/organization/project` — Projects for the current organization.
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/organization/proxy/record` — Delete a proxy record by ID for a specific organization. Requires an authenticated user with 'organization:write' permission. On success, it responds with a 204 status and no content.
  - body: { id: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/organization/role` — Delete a role with a specific UUID in an organization. Requires 'organization:write' permission. No response body on success (204). Path parameters include 'id' and 'organization_id'.
  - body: { id: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/persisted/folder` — Delete a persisted folder by providing its UUID and the associated project ID. Requires 'persisted_folder:write' permission. Returns no content with a 204 status on success.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/person` — This endpoint is used to read and delete user data. Use the capture API, `$set`/`$unset` commands, or SDKs for creating/updating persons.
  - body: { id: string, format?: string, project_id: string, delete_events?: boolean }
- `POST https://api.mcp.ai/api/posthog/delete/person/property` — Delete specific properties from a person record using the $unset operation. Use when you need to remove one or more properties from a person's profile.
  - body: { id: string, format?: string, project_id: string, dollar_unset: string[] }
- `POST https://api.mcp.ai/api/posthog/delete/product/tour` — Delete a product tour by providing its UUID and the associated project ID. Requires 'product_tour:write' permission. Returns no content with a 204 status on success.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/project/batch/export` — Delete a specific batch export by providing the UUID and project ID. Requires a personal API key with 'batch_export:write' permissions. Responds with no body upon successful deletion (HTTP 204).
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/project/dashboard/collaborator` — Remove a collaborator from a project dashboard. Provide the project_id, dashboard_id, and user's UUID. Requires 'dashboard:write' permissions. Expect no response body on success (204). Project ID guid
  - body: { project_id: string, user__uuid: string, dashboard_id: integer }
- `POST https://api.mcp.ai/api/posthog/delete/project/early/access/feature` — Delete an early access feature by ID from a specified project. Requires a UUID for the feature and the project's ID. Authentication via PersonalAPIKeyAuth is necessary. No response body upon success.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/project/event/definition` — Delete an event definition by providing its UUID and the associated project ID. Requires `event_definition:write` permission. Successful deletion returns no content (204 status).
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/project/experiment` — Soft-delete a specific experiment by its unique integer ID within a project. Uses PATCH to set the 'deleted' field to true since PostHog experiments do not support hard DELETE. Requires a Project ID a
  - body: { id: integer, deleted?: boolean, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/project/member` — Delete a specific user (by UUID) from the explicit members of a given project. Requires 'project_id' and member's 'parent_membership__user__uuid'. Returns 204 on success with no response body. Note: T
  - body: { project_id: string, parent__membership__user__uuid: string }
- `POST https://api.mcp.ai/api/posthog/delete/project/plugin/configuration` — DELETE /api/projects/{project_id}/plugin_configs/{id}/: Removes a specific plugin configuration by ID from a given project. Requires 'plugin:write' permissions and project ID. Returns 204 with no body
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/project/query` — (Experimental)
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/property/definition` — Delete a property definition by providing its UUID and the associated project ID. Requires 'property_definition:write' permission. On success, no response body is returned (204).
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/role/membership` — Remove a user from a custom organization role by deleting their role membership. This action permanently removes the specified user's membership in the role, revoking any permissions associated with t
  - body: { id: string, role_id: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/session/recording` — Delete a session recording by providing the session's UUID and the associated project ID. Requires `session_recording:write` permission. Returns no content on successful deletion.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/session/recording/from/playlist` — Remove a session recording from a playlist in a PostHog project. This action only removes the recording from the playlist - it does not delete the recording itself. The recording remains available in 
  - body: { short_id: string, project_id: string, session_recording_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/survey` — Delete a survey by providing its UUID and the associated project ID. Requires 'survey:write' permission. Returns no content with a 204 status on success.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/warehouse/saved/query` — Tool to delete a warehouse saved query from PostHog. Use when you need to remove a saved query from the data warehouse. The operation succeeds if the API returns 204 No Content status.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/delete/web/experiment` — Delete a web experiment by its ID from a specific project. Use when you need to permanently remove a web experiment. Requires 'experiment:write' scope.
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/duplicate/cohort/to/static` — This endpoint duplicates a specified cohort as a static one within a project. Path parameters include `project_id` (string) and cohort `id` (integer). Successful requests return cohort details.
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/duplicate/experiment` — Tool to duplicate an existing experiment in PostHog. Use when you need to create a copy of an experiment with the same configuration. The API automatically appends '(Copy)' to the duplicated experimen
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/duplicate/survey/to/projects` — Duplicate a survey to multiple projects in a single transaction. Accepts a list of target team IDs and creates a copy of the survey in each project. Uses an all-or-nothing approach - if any duplicatio
  - body: { id: string, project_id: string, target_team_ids: integer[] }
- `POST https://api.mcp.ai/api/posthog/enable/project/early/access/feature` — Enables a new early access feature for a project using project ID, payload with details, and PersonalAPIKeyAuth. Returns a 201 status on success.
  - body: { id: string, name: string, stage: string, created_at: string, project_id: string, description?: string, feature_flag_id?: integer, documentation_url?: string }
- `POST https://api.mcp.ai/api/posthog/finish/symbol/sets/bulk/upload` — Tool to finalize bulk upload of error tracking symbol sets for a PostHog project. Use when completing a multi-part symbol set upload process. This endpoint marks the upload as complete and makes the s
  - body: { id: string, ref: string, release: string, team_id: integer, last_used?: string, created_at: string, project_id: string, storage_ptr?: string, failure_reason?: string }
- `POST https://api.mcp.ai/api/posthog/flag/annotation/as/deleted` — Soft delete an annotation by setting 'deleted' to true via PATCH request. Hard delete of this model is not allowed by the API.
  - body: { id: integer, deleted?: boolean, project_id: string }
- `POST https://api.mcp.ai/api/posthog/generate/insight/name` — Tool to generate an AI-suggested name for a PostHog insight based on its query configuration. Use when you need to automatically name an insight instead of manually creating a descriptive title.
  - body: { query: object, format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/generate/project/funnel/correlation/insight` — The /api/projects/{project_id}/insights/funnel/correlation endpoint generates a correlation insight for funnel analysis in a project, accepting JSON/CSV and needing 'project_id' and insight details.
  - body: { events?: object[], format?: string, actions?: object[], date_to?: string, insight?: string, breakdown?: string, date_from?: string, exclusions?: object[], project_id: string, properties?: string, breakdown_type?: string, funnel_viz_type?: string, funnel_order_type?: string, filter_test_accounts?: boolean, funnel_window_interval?: integer, funnel_correlation_type?: string, funnel_correlation_names?: string[], funnel_window_interval_type?: string, aggregation_group_type_index?: integer, funnel_correlation_exclude_names?: string[], funnel_correlation_person_entity?: object, funnel_correlation_person_converted?: string }
- `POST https://api.mcp.ai/api/posthog/get/app/metrics` — Retrieve performance and error metrics for a specific plugin configuration (app) in a PostHog project. This action returns time-series data showing the success rate, failures, and retry statistics for
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/app/metrics/error/details` — Retrieves detailed error information for a specific app metric (plugin config) within a project. This endpoint provides error details for plugins/apps that have experienced failures. If the plugin con
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/batch/export/details` — Retrieve details of a specific batch export by its UUID in a project. Requires project_id and batch export ID. Supports PersonalAPIKeyAuth and responds with export details including destination, inter
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/batch/exports/backfills` — Tool to retrieve backfills for a specific batch export within a project. Use when you need to view historical backfill operations for batch exports. Supports pagination via cursor and custom ordering 
  - body: { cursor?: string, ordering?: string, project_id: string, batch_export_id: string }
- `POST https://api.mcp.ai/api/posthog/get/cohort/activity/details` — Retrieve activity details for a specific cohort within a project. Requires a project ID and cohort ID, returning status, filters, query, and creator data. Auth: PersonalAPIKeyAuth with 'activity_log:r
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/cohort/person/details` — Retrieve details of persons within a cohort by its unique ID in the specified project. The endpoint supports JSON and CSV formats and requires authorization. Project and cohort IDs must be provided.
  - body: { id: integer, limit?: integer, format?: string, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/cohorts/calculation/history` — Tool to retrieve the calculation history for a specific cohort. Use when you need to track cohort recalculations, monitor calculation performance, or debug calculation errors. Returns paginated list o
  - body: { id: integer, limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/conversation` — Tool to retrieve a specific conversation by UUID and project ID. Use when you need to access conversation details including messages, status, and associated user information.
  - body: { project_id: string, conversation: string }
- `POST https://api.mcp.ai/api/posthog/get/conversations` — Tool to retrieve conversations for a specific PostHog project with pagination support. Use when you need to fetch conversation data including messages, status, and user information.
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/customer/profile/config` — Retrieve a specific customer profile configuration by its ID for a given project. Use when you need to fetch details about how customer profiles are configured for persons or groups.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/customer/profile/configs` — Tool to retrieve customer profile configurations for a project with pagination support. Use when you need to list or access customer profile configuration settings for a specific PostHog project.
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/dashboard/template/details` — Fetch specific dashboard template details by UUID in a project with 'dashboard_template:read' rights using a PersonalAPIKeyAuth. Returns name, description, filters, and creation info.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/dashboard/template/schema` — Retrieve the JSON schema for dashboard templates of a specific project. Pass the project_id in the path and receive details such as template name, description, filters, and more. Supports GET requests
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/data/color/theme` — Tool to retrieve a specific data color theme by ID from a PostHog project. Use when you need to fetch theme configuration details for data visualization.
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/data/color/themes` — Tool to retrieve data color themes for a specific project. Use when you need to list available color themes for data visualization. Returns paginated results with theme details including colors, creat
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/dataset` — Retrieve detailed information about a specific dataset within a project. Use this to get dataset properties including name, description, creator info, and timestamps.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/dataset/item` — Tool to retrieve a specific dataset item by its ID from a PostHog project. Use when you need to fetch details about a particular dataset item including its input, output, metadata, and creation inform
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/dataset/items` — Tool to retrieve paginated dataset items for a specific project in PostHog. Use when you need to list or explore dataset items with optional filtering by dataset ID.
  - body: { limit?: integer, offset?: integer, dataset?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/datasets` — Tool to retrieve datasets for a PostHog project. Use when you need to list or search datasets within a specific project. Supports filtering by IDs, searching by name/description, and ordering results.
  - body: { limit?: integer, id__in?: string[], offset?: integer, search?: string, order_by?: string[], project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/desktop/recordings` — Tool to retrieve desktop meeting recordings for a specific project. Use when you need to access recorded meetings with transcripts, summaries, and extracted tasks. Returns paginated results with suppo
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/endpoint/openapi/specification` — Get OpenAPI 3.0 specification for a specific PostHog endpoint. Use this to generate typed SDK clients. Returns the complete OpenAPI schema including paths, components, and security definitions for the
  - body: { name: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/error/tracking/assignment/rules` — Tool to retrieve error tracking assignment rules for a project. Use when you need to list the configured rules that automatically assign error tracking issues to team members based on filters. Support
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/error/tracking/autocapture/control` — Retrieve a specific error tracking autocapture control configuration by its ID. Use this to view detailed settings for a particular autocapture control including sample rates, URL triggers, and event 
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/error/tracking/fingerprints` — Tool to retrieve error tracking fingerprints for a project. Use when you need to list tracked errors with their status, occurrence counts, and timing information. Returns paginated list of error finge
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/error/tracking/grouping/rules` — Tool to retrieve error tracking grouping rules for a project. Use when you need to list the configured rules that control how error tracking issues are grouped together based on filters. Supports pagi
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/error/tracking/release` — Retrieve details of a specific error tracking release by its UUID and project ID. Use when you need to fetch information about a particular release in error tracking.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/error/tracking/release/by/hash` — Tool to retrieve an error tracking release by its hash identifier. Use when you need to fetch release details using a hash ID instead of the UUID. Requires 'error_tracking:read' scope.
  - body: { hash_id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/error/tracking/releases` — Tool to retrieve paginated error tracking releases for a specific project in PostHog. Use when you need to list releases associated with error tracking to identify version-specific issues.
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/error/tracking/suppression/rules` — Tool to retrieve error tracking suppression rules for a project. Use when you need to list the configured rules that automatically suppress specific error tracking issues based on filters. Supports pa
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/error/tracking/symbol/sets` — Tool to retrieve error tracking symbol sets for a PostHog project. Use when you need to list symbol sets used for error stack trace symbolication. Returns paginated list of symbol sets including their
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/evaluation` — Retrieve details of a specific evaluation by its UUID and project ID. Use this to fetch evaluation configuration, type, conditions, and associated model settings.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/evaluations` — Tool to retrieve evaluations configured for a specific PostHog environment/project. Use when you need to list AI model evaluations, check their configurations, or filter evaluations by status or searc
  - body: { id_in?: string[], limit?: integer, offset?: integer, search?: string, enabled?: boolean, order_by?: string[], project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/event/definition` — Retrieve an event definition by its UUID within a specified project. Requires a project_id and an event definition ID, with access secured by PersonalAPIKeyAuth. (GET /api/projects/{project_id}/event_
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/event/definition/by/name` — Tool to retrieve an event definition by its exact name for a specific project. Use when you need to look up details about a specific event by name rather than UUID.
  - body: { name: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/event/definitions` — Retrieve definitions for events within a specified project by providing the unique project_id. Requires PersonalAPIKeyAuth privileges for event_definition:read. No response body provided upon a succes
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/event/definitions/golang` — Tool to retrieve event definitions in Golang format for a specific PostHog project. Use when you need Golang code generation or type definitions for events in the specified project.
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/event/definitions/python` — Tool to retrieve Python-formatted event definitions for a specific project. Use when you need to access event definitions in Python format for code generation or SDK integration.
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/event/definitions/typescript` — Tool to retrieve TypeScript event definitions for a specific project. Use when you need to generate type-safe event definitions for TypeScript applications.
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/experiment/details` — Access detailed experiment info within a project using unique `experiment ID` & `project ID`, with 'experiment:read' rights. Response includes dates, feature flag key, metrics, creator details.
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/experiment/holdout/details` — Retrieve details of a specific experiment holdout by ID within a project. Use this to get information about an experiment holdout including its name, description, filters, and creation details.
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/experiment/holdouts` — Tool to retrieve experiment holdouts for a specific PostHog project. Use when you need to view holdout groups for experiments. Returns paginated list of holdouts with their configurations and metadata
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/experiment/saved/metric` — Tool to retrieve a specific experiment saved metric by ID from a PostHog project. Use when you need to fetch details about a saved metric configuration for experiments.
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/experiments/eligible/feature/flags` — Tool to retrieve feature flags eligible for use in experiments. Use when you need to find multivariate feature flags that can be used to run A/B tests. Only returns flags with at least 2 variants wher
  - body: { limit?: integer, order?: string, active?: string, offset?: integer, search?: string, project_id: string, created_by_id?: integer, evaluation_runtime?: string }
- `POST https://api.mcp.ai/api/posthog/get/experiments/requiring/flag/implementation` — Retrieve details for experiments that require feature flag implementation in a specific project. Requires a valid 'project_id' and user must have 'experiment:read' permission. Returns information like
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/experiments/stats` — Tool to retrieve experimentation velocity statistics for a PostHog project. Use when you need to understand overall experiment activity and distribution. Returns high-level statistics including total,
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/export/unsubscribe/configs` — Retrieves export unsubscribe configurations for pipeline import apps in an organization. This endpoint returns a list of configurations that define how users can unsubscribe from various pipeline impo
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/get/export/unsubscribe/settings` — Retrieves export unsubscribe configurations for pipeline transformations in an organization. This endpoint returns a list of configurations that define how users can unsubscribe from various pipeline 
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/get/external/data/source` — Tool to retrieve details of a specific external data source by its UUID and project ID. Use when you need to access external data source configuration, status, and metadata.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/external/data/sources` — Tool to retrieve external data sources for a PostHog project with pagination support. Use when you need to list or search for configured external data connections like Stripe, Postgres, or Snowflake.
  - body: { limit?: integer, offset?: integer, search?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/feature/flag/activity/details` — Manage feature flags (creation, reading, updating, and deleting) using PostHog's guides or via JavaScript Library/endpoint for user-specific flag status. [Details](https://posthog.com/docs/user-guides
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/feature/flag/details` — Retrieve detailed information about a specific feature flag in a PostHog project. This action fetches comprehensive details including: - Basic information (id, name, key) - Filter configuration and ro
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/feature/flag/role/access/details` — Retrieve details for a specific role's access to a feature flag within a project. Requires 'feature_flag_id', 'id' for role access, and 'project_id'. Returns a JSON object with access details.
  - body: { id: integer, project_id: string, feature_flag_id: integer }
- `POST https://api.mcp.ai/api/posthog/get/feature/flag/status` — Tool to retrieve the status of a specific feature flag in a PostHog project. Use when you need to check the operational status or state of a feature flag beyond its basic configuration details.
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/feature/flags/activity/log` — Learn to manage feature flags by creating, reading, updating, and deleting them. Use PostHog's JavaScript Library or endpoint for application integration. Details in the [docs](https://posthog.com/doc
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/feature/flags/dependent/flags` — Retrieve all active feature flags that depend on a specified flag. Use when you need to understand flag dependencies before modifying or deleting a flag. Helps prevent breaking dependent flags by show
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/feature/flags/evaluation/reasons` — Manage feature flags—create, read, update, delete—using the PostHog JavaScript Library or endpoint for user-specific flag status. (More in docs).
  - body: { project_id: string, distinct_id: string }
- `POST https://api.mcp.ai/api/posthog/get/feature/flags/matching/ids` — Tool to get IDs of all feature flags matching the current filters. Uses the same filtering logic as the list endpoint and returns only IDs that the user has permission to edit.
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/file/system` — Tool to retrieve a specific file system resource by UUID and project ID. Use when you need to access details about a file system in PostHog, including metadata and path information.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/file/system/shortcut` — Retrieve a specific file system shortcut by UUID from a project. Requires 'file_system_shortcut:read' permission. Returns detailed information about the shortcut including path, type, and creation tim
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/filtered/project/property/definitions` — Get property definitions for a project using project_id, with filters for event names, property types, exclusions, and numerical or feature flags. Also, view properties relevant to specific events.
  - body: { type?: string, limit?: integer, offset?: integer, search?: string, project_id: string, properties?: string, event_names?: string, is_numerical?: boolean, is_feature_flag?: boolean, group_type_index?: integer, excluded_properties?: string, filter_by_event_names?: boolean }
- `POST https://api.mcp.ai/api/posthog/get/funnel/insights/in/project` — Execute a funnel analysis for a specific project. Requires specifying funnel steps via 'events' or 'actions' parameter (at least 2 steps). Returns conversion data showing how users progress through th
  - body: { events?: object[], format?: string, actions?: object[], date_to?: string, date_from?: string, project_id: string, filter_test_accounts?: boolean, funnel_window_interval?: integer, funnel_window_interval_type?: string }
- `POST https://api.mcp.ai/api/posthog/get/group/property/definitions` — Retrieve property definitions for a group within a project by providing the project ID. This endpoint returns details like group type index, key, and creation time in JSON format.
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/group/property/values` — Retrieve property values by 'group_type_index' and 'key' within a 'project_id'. Parameters must be provided. Output is a JSON with property details and creation timestamp.
  - body: { key: string, project_id: string, group_type_index: integer }
- `POST https://api.mcp.ai/api/posthog/get/groups/types/metric/by/id` — Tool to retrieve detailed information about a specific group usage metric by its ID. Use when you need to get the configuration, filters, display format, and calculation interval for a particular metr
  - body: { id: string, project_id: string, group_type_index: integer }
- `POST https://api.mcp.ai/api/posthog/get/groups/types/metrics` — Tool to retrieve metrics for a specific group type in a PostHog project. Use when you need to list all metrics associated with a particular group type index. Returns paginated results with metric conf
  - body: { limit?: integer, offset?: integer, project_id: string, group_type_index: integer }
- `POST https://api.mcp.ai/api/posthog/get/hedgehog/configuration` — Retrieve user's hedgehog configuration details by their UUID. This endpoint returns hedgehog-related settings (PostHog's mascot customization) for a user. Use '@me' as the uuid parameter to reference 
  - body: { uuid: string }
- `POST https://api.mcp.ai/api/posthog/get/historical/app/metrics/export` — Retrieve historical export data for app metrics by supplying the `project_id` and `plugin_config_id`. Requires `plugin:read` permission. No response body provided upon a successful request.
  - body: { project_id: string, plugin_config_id: string }
- `POST https://api.mcp.ai/api/posthog/get/hog/function` — Tool to retrieve a specific hog function by UUID and project ID. Use when you need to access details about a hog function including its configuration, code, filters, and status.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/hog/functions` — Tool to retrieve hog functions for a specific PostHog project. Use when you need to list, search, or filter hog functions with pagination support.
  - body: { id?: string, type?: string[], limit?: integer, offset?: integer, search?: string, enabled?: boolean, created_at?: string, created_by?: integer, project_id: string, updated_at?: string }
- `POST https://api.mcp.ai/api/posthog/get/important/project/activity/log` — Retrieve a log of important activities and changes for a specified project. This endpoint returns significant project events including creation, updates, and deletions of resources like dashboards, fe
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/insight/sharing/configurations` — Retrieve sharing configurations for a specific insight within a project, requiring project and insight IDs. Validates access via PersonalAPIKeyAuth. Returns data such as creation time and access token
  - body: { insight_id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/insight/threshold` — Tool to retrieve a specific insight threshold by ID for a PostHog project. Use when you need to view threshold configuration, bounds, and associated alerts for monitoring insights.
  - body: { id: string, insight_id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/insight/variable` — Tool to retrieve a specific insight variable by UUID and project ID. Use when you need to access details about an insight variable including its type, name, and values.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/insight/variables` — Tool to retrieve paginated list of insight variables for a project. Use when you need to discover available variables for insights or query their configurations. Returns variables with their types, de
  - body: { page?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/insights/thresholds` — Tool to retrieve thresholds configured for a specific insight within a project. Use when you need to view alert thresholds or monitoring criteria set up for an insight. Returns paginated list of thres
  - body: { limit?: integer, offset?: integer, insight_id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/live/debugger/breakpoint` — Tool to retrieve a specific live debugger breakpoint by UUID and project ID. Use when you need to fetch details about a breakpoint for live debugging.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/live/debugger/breakpoints` — Tool to retrieve live debugger breakpoints for a project. Returns a paginated list of breakpoints with their configuration including filename, line number, condition, and status. Use when you need to 
  - body: { limit?: integer, offset?: integer, filename?: string, project_id: string, repository?: string }
- `POST https://api.mcp.ai/api/posthog/get/llm/analytics/evaluation/config` — Tool to retrieve the LLM analytics evaluation configuration for a specific PostHog project. Use when you need to check evaluation settings, trial limits, or usage statistics for LLM analytics features
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/llm/analytics/models` — Tool to list available LLM models for a specific provider in PostHog LLM Analytics. Use when you need to discover which models are available for a given provider (e.g., openai, anthropic).
  - body: { provider: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/llm/analytics/provider/keys` — Tool to retrieve LLM analytics provider keys for a project. Use when you need to list API keys configured for LLM analytics providers. Returns paginated results with provider key details including mas
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/logs/attributes` — Tool to retrieve available log attributes for a PostHog project. Use when you need to discover what log attribute fields are available for querying or filtering logs. Requires the logs:read scope and 
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/logs/has/logs` — Tool to check if a project has logs available. Use when you need to verify log availability before querying logs. Returns a boolean indicator of log presence.
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/logs/values` — Tool to retrieve unique values for a specific log field key in a PostHog project. Use when you need to discover available values for log fields like level, message, source, or other log properties.
  - body: { key: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/organization` — Retrieve organization details by UUID. Endpoint requires 'organization:read' access. Response includes name, slug, timestamps, membership, plugins access level, and team structure.
  - body: { id: string }
- `POST https://api.mcp.ai/api/posthog/get/organization/pipeline/app/repositories` — Retrieve details of pipeline import app repositories for a specific organization by its UUID. Returns JSON with properties like plugin type, name, and URL. Supports 'local', 'custom', 'repository', 's
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/get/persisted/folder` — Tool to list persisted folders for a PostHog project with pagination support. Use when you need to retrieve or browse persisted folder configurations within a project.
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/pipeline/destination/details` — Retrieve activity logs and metadata for a specific pipeline destination configuration. Returns activity information including latest updates, version tags, and operational status. Use this to monitor 
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/pipeline/transformation/details` — Retrieve available pipeline transformation plugins from the organization's plugin repository. Returns a list of transformation templates that can be used to modify, enrich, or filter events in real-ti
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/get/product/tour` — Tool to retrieve a specific product tour by UUID from a PostHog project. Use when you need to fetch details about a product tour configuration, including targeting and content settings.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/project/person/trends` — This endpoint is for reading and deleting persons. Use the capture API, `$set`/`$unset` properties, or SDKs for creating/updating persons.
  - body: { format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/project/survey/activity/log` — Retrieve the activity log of surveys within a specific project by using the project ID. This endpoint requires a PersonalAPIKeyAuth with 'activity_log:read' permission and returns survey details inclu
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/role/membership` — Retrieve details of a specific role membership within an organization by its UUID. Use this to view information about a user's assignment to a particular role, including when they were assigned and th
  - body: { id: string, role_id: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/get/session/group/summaries` — Tool to retrieve stored group session summaries for a project. Use when you need to list or access session grouping summaries. Supports pagination via limit and offset parameters.
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/session/recording/playlist/details` — Retrieve session recording playlist details for a specific project by project_id and playlist short_id. Requires PersonalAPIKeyAuth with read access. Returns playlist metadata including creation and m
  - body: { short_id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/survey/response/statistics` — Get survey response statistics for a specific survey. Returns event counts, unique respondents, and conversion rates. Use when analyzing survey performance and engagement metrics.
  - body: { id: string, date_to?: string, date_from?: string, project_id: string, exclude_archived?: boolean }
- `POST https://api.mcp.ai/api/posthog/get/surveys/archived/response/uuids` — Tool to get list of archived response UUIDs for HogQL filtering. Returns list of UUIDs that the frontend can use to filter out archived responses in HogQL queries.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/surveys/stats` — Tool to get aggregated response statistics across all surveys for a project. Use when you need to analyze overall survey performance, response rates, and dismissal rates. Optionally filter statistics 
  - body: { date_to?: string, date_from?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/unused/org/pipeline/frontend/apps` — Retrieve a list of pipeline frontend apps that are available but not currently in use within a specific organization. This is useful for discovering apps that could be enabled or removed. Returns deta
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/get/user/home/settings` — Tool to retrieve user home settings including homepage and tab configurations. Use when you need to fetch the personalized home page and tab settings for a user.
  - body: { uuid: string }
- `POST https://api.mcp.ai/api/posthog/get/user/interviews` — Tool to retrieve paginated list of user interviews for a specific project. Use when you need to access interview recordings, transcripts, and summaries.
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/warehouse/saved/queries/activity` — Tool to retrieve activity details for a specific warehouse saved query in PostHog. Use when you need to check the execution history, status, and metadata of a data warehouse saved query.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/warehouse/saved/query` — Tool to retrieve a warehouse saved query from PostHog data warehouse. Use when you need to get details about a specific saved query including its status, execution history, and configuration. Returns 
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/warehouse/table` — Retrieve details of a specific data warehouse table by its UUID. Use this to inspect warehouse table configuration, credentials, schema, and format.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/warehouse/tables` — Tool to retrieve a paginated list of warehouse tables for a specific project. Use when you need to list, search, or discover warehouse tables. Supports pagination via limit/offset and filtering via se
  - body: { limit?: integer, offset?: integer, search?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/web/experiment` — Tool to retrieve a specific web experiment by ID from a PostHog project. Use when you need to fetch configuration details about a web experiment including variants and feature flag mapping.
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/get/web/vitals` — Tool to retrieve web vitals metrics for a specific pathname in a PostHog project. Returns Core Web Vitals data including INP (Interaction to Next Paint), LCP (Largest Contentful Paint), CLS (Cumulativ
  - body: { pathname: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/initiate/domain/verification/with/saml/config` — Initiates domain verification for SAML SSO authentication. This endpoint triggers the verification process for a previously created domain by checking if the required DNS TXT record has been added. **
  - body: { id: string, domain?: string, has_saml?: boolean, is_verified?: boolean, verified_at?: string, saml_acs_url?: string, saml_entity_id?: string, saml_x509_cert?: string, organization_id: string, sso_enforcement?: string, verification_challenge?: string, jit_provisioning_enabled?: boolean }
- `POST https://api.mcp.ai/api/posthog/list/alerts` — Tool to retrieve all alerts configured for a specific PostHog project. Use when you need to view alert configurations, check alert status, or monitor what alerts are set up. Returns paginated list of 
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/all/projects/across/organizations` — Tool to list all projects the authenticated user can access by enumerating organizations and aggregating each organization's projects. Use when you need to discover all available projects without know
- `POST https://api.mcp.ai/api/posthog/list/and/filter/project/events` — This endpoint for listing/filtering events is deprecated and maintained only for compatibility. Users are discouraged from using it and should use the Query endpoint for ad-hoc lists/aggregations or C
  - body: { after?: string, event?: string, limit?: integer, where?: string, before?: string, format?: string, offset?: integer, select?: string, person_id?: integer, project_id: string, properties?: string, distinct_id?: integer }
- `POST https://api.mcp.ai/api/posthog/list/and/manage/project/annotations` — Create, Read, Update and Delete annotations. [See docs](https://posthog.com/docs/user-guides/annotations) for more information on annotations.
  - body: { limit?: integer, offset?: integer, search?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/and/manage/project/feature/flags` — List all feature flags for a specific project with pagination support. Returns detailed information about each flag including its key, name, filters, rollout configuration, associated experiments/surv
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/batch/export/runs` — List runs for a batch export by `batch_export_id` within a project. Supports pagination & ordering of the results. Requires `batch_export:read` permission. Returns status, errors, counts, and timestam
  - body: { cursor?: string, ordering?: string, project_id: string, batch_export_id: string }
- `POST https://api.mcp.ai/api/posthog/list/conversations/tickets` — Tool to list tickets with person data attached for a project. Use when you need to retrieve all tickets in a project, with optional pagination support.
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/dashboard/sharing/configs` — Retrieve a list of dashboard sharing configurations for a specified project and dashboard. Requires dashboard ID, project ID, and sharing read permission via PersonalAPIKeyAuth. Returns JSON array of 
  - body: { project_id: string, dashboard_id: integer }
- `POST https://api.mcp.ai/api/posthog/list/endpoint/versions` — Tool to list all versions for a specific endpoint in PostHog. Use when you need to retrieve version history or check available versions for an endpoint. Requires both the project ID and the endpoint n
  - body: { name: string, limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/endpoints` — Tool to list all endpoints for the team. Use when you need to retrieve or discover available endpoints within a project.
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/error/tracking/autocapture/controls` — Tool to list error tracking autocapture controls for a PostHog project. Returns paginated list of autocapture configurations including library settings, URL triggers, and sampling rates. Use when you 
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/experiment/saved/metrics` — Tool to list experiment saved metrics for a project with pagination support. Use when you need to retrieve saved metric configurations for experiments in a PostHog project.
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/feature/flag/role/access/details` — This GET endpoint returns role access details for a feature flag in a project, needs 'project_id' & 'feature_flag_id', and offers optional 'limit' & 'offset' for pagination.
  - body: { limit?: integer, offset?: integer, project_id: string, feature_flag_id: integer }
- `POST https://api.mcp.ai/api/posthog/list/file/system` — Tool to list file system resources for a PostHog project with pagination support. Use when you need to browse or search through available file system resources in a project.
  - body: { limit?: integer, offset?: integer, search?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/groups/by/type` — List all groups of a specific group type. You must pass ?group_type_index= in the URL. To get a list of valid group types, call /api/:project_id/groups_types/
  - body: { cursor?: string, search: string, project_id: string, group_type_index: integer }
- `POST https://api.mcp.ai/api/posthog/list/live/debugger/breakpoint/hits` — Tool to retrieve breakpoint hit events from ClickHouse with optional filtering and pagination. Use when you need to view hit events containing stack traces, local variables, and execution context from
  - body: { limit?: integer, offset?: integer, project_id: string, breakpoint_ids?: string }
- `POST https://api.mcp.ai/api/posthog/list/live/debugger/breakpoints/active` — Tool to fetch active live debugger breakpoints for external client applications using Project API key. Returns a list of breakpoints that client applications can use to instrument their code according
  - body: { enabled?: boolean, filename?: string, project_id: string, repository?: string }
- `POST https://api.mcp.ai/api/posthog/list/notebooks` — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
  - body: { user?: string, limit?: integer, offset?: integer, date_to?: string, contains?: string, date_from?: string, created_by?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/or/delete/persons/with/optional/filters` — This endpoint is for reading/deleting persons. For creating/updating, use the capture API, set/unset properties, or SDKs.
  - body: { email?: string, limit?: integer, format?: string, offset?: integer, search?: string, project_id: string, properties?: string, distinct_id?: string }
- `POST https://api.mcp.ai/api/posthog/list/organization/batch/exports` — Retrieve paginated batch exports for an organization, with filters and optional limits. Includes team, interval, and status details. Access requires PersonalAPIKeyAuth with batch_export:read rights.
  - body: { limit?: integer, offset?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/list/organization/domains` — Fetch a list of an organization's domains with pagination using `limit` and `offset`. Access requires `organization_id` and a PersonalAPIKeyAuth. Optional parameters available. Provides domain info, v
  - body: { limit?: integer, offset?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/list/organization/integrations` — Tool to list organization-level integrations with read-only access. Use when you need to view integrations scoped to an entire organization (e.g., Vercel, AWS Marketplace). Creation is handled by inte
  - body: { limit?: integer, offset?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/list/organization/invites` — Retrieve a paginated list of all pending and active invites for an organization. This action lists all organization invites including: - Email address of invitees - Access level (1=member, 8=admin, 15
  - body: { limit?: integer, offset?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/list/organization/members` — List all members of a specific organization with pagination support. Returns detailed member information including user profiles, membership levels, authentication status, and join dates. Use this to 
  - body: { limit?: integer, offset?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/list/organization/pipeline/destinations` — Retrieve a paginated list of an organization's pipeline destinations by ID, with optional count and offset parameters. Requires PersonalAPIKeyAuth (plugin:read). Returns details like ID, type, and org
  - body: { limit?: integer, offset?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/list/organization/pipeline/frontend/apps` — Retrieve a paginated list of available pipeline frontend apps for a specific organization. Frontend apps are site apps that inject code into websites (e.g., notification bars, bug reporters, pineapple
  - body: { limit?: integer, offset?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/list/organization/pipeline/import/apps` — Retrieve a paginated list of pipeline import applications for a specified organization by ID. Supports optional 'limit' and 'offset' query parameters for result pagination. Requires an organization UU
  - body: { limit?: integer, offset?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/list/organization/pipeline/transformations` — Retrieve paginated pipeline transformation lists for an organization using `limit` and `offset`, requiring a UUID and PersonalAPIKeyAuth. Supports filtering and detailed views.
  - body: { limit?: integer, offset?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/list/organization/plugins` — Retrieve the list of plugins for a specified organization. Supports pagination through 'limit' and 'offset' query parameters. Requires a valid organization UUID and PersonalAPIKeyAuth for access. Retu
  - body: { limit?: integer, offset?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/list/organization/projects` — Projects for the current organization.
  - body: { limit?: integer, offset?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/list/organization/proxy/records` — Retrieve a paginated list of custom domain proxy records for an organization. Proxy records enable routing PostHog analytics through your own domain to bypass ad blockers. Each record includes the dom
  - body: { limit?: integer, offset?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/list/organization/roles` — List all roles in an organization with pagination support. Returns role details including ID, name, creation timestamp, creator information, assigned members, and default status. Use limit and offset 
  - body: { limit?: integer, offset?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/list/pipeline/destination/configs` — List pipeline destination configurations for a given project by ID, with optional pagination through 'limit' and 'offset' query parameters. Returns details such as plugin info and delivery rates. Auth
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/pipeline/frontend/app/configs` — List all pipeline frontend app configurations for a project. Pipeline frontend apps are plugins that add UI extensions to PostHog (e.g., custom visualizations, dashboards, etc.). Returns a paginated l
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/product/tours` — Tool to retrieve a paginated list of product tours for a specific project. Use when you need to view all product tours configured in a project. Supports pagination with limit and offset, and search fi
  - body: { limit?: integer, offset?: integer, search?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/actions` — Get paginated project actions with filters by format. Query params: limit, offset. Needs PersonalAPIKeyAuth for read. Includes ID, name, description, metadata.
  - body: { limit?: integer, format?: string, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/batch/exports` — Retrieve an indexed list of batch exports for a specified project with optional pagination. View export details, statuses, and pagination links. Requires project ID and supports PersonalAPIKeyAuth.
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/configuration/plugin/logs` — Retrieve logs for a specific plugin configuration within a project. Supports pagination with limit and offset query parameters. Requires project and plugin configuration IDs. Auth: PersonalAPIKeyAuth 
  - body: { limit?: integer, offset?: integer, project_id: string, plugin_config_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/dashboard/collaborators` — Retrieve the list of collaborators for a specific dashboard within a project. This endpoint returns all users who have been explicitly added as collaborators to the dashboard, along with their access 
  - body: { project_id: string, dashboard_id: integer }
- `POST https://api.mcp.ai/api/posthog/list/project/dashboard/templates` — Retrieve available dashboard templates for a PostHog project. Dashboard templates are pre-configured dashboards that help users quickly set up analytics for common use cases like user research, pirate
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/dashboards` — Get paginated dashboards for a project by ID, using 'limit' and 'offset'. Must authenticate with PersonalAPIKeyAuth. Includes count, pagination, and dashboard details.
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/early/access/features` — Retrieve a paginated list of a project's early access features by ID with 'limit' and 'offset' parameters. An API key is needed. Includes feature info like creation date, stage, and documentation link
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/experiments` — Get a paginated list of experiments within a project using 'limit' and 'offset' parameters. Need a valid project ID and 'experiment:read' permission. Returns details like features and metrics.
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/export/items` — Retrieve a paginated list of export items for a specific project by ID with optional 'limit' and 'offset' query parameters. Requires PersonalAPIKeyAuth for export:read permission. Supports multiple ex
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/group/types` — List all group types configured for a PostHog project. Group types are used to organize entities (like companies, organizations, or teams) in PostHog analytics. Each project can have up to 5 group typ
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/membership/details` — Retrieve a list of project membership details for a specified project by ID. Members and their roles, such as member or admin, are included along with their join and update timestamps. Note: This endp
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/pipeline/configurations` — List all pipeline transformation configurations for a specific project. Pipeline transformations enable you to modify, enrich, or filter events in realtime before they are ingested into PostHog. This 
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/pipeline/import/configs` — List pipeline import app configurations for a specified project, with pagination options 'limit' and 'offset'. Requires a project ID and supports PersonalAPIKeyAuth for security. Responds with JSON ob
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/plugin/configurations` — List all plugin configurations for a specific project. Plugin configurations define which plugins (apps) are installed and enabled for a project, along with their settings and execution order. This en
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/session/recordings` — Retrieve a paginated list of session recordings for a specific project, including viewing times and user interactions. Specify `project_id`, and use optional `limit` and `offset` query parameters to c
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/subscriptions` — Retrieve a paginated list of subscriptions for a given project by its ID. Optional query params include 'limit' for results per page and 'offset' for results starting index. Authentication is required
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/project/surveys` — Get paginated surveys for a project with its ID, using 'limit' and 'offset'. Needs PersonalAPIKeyAuth ('survey:read'). JSON output includes survey info, links, and metadata.
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/role/memberships` — List all users assigned to a specific role within an organization. Role memberships represent the assignment of users to custom roles in PostHog. This endpoint returns a paginated list of users who ha
  - body: { limit?: integer, offset?: integer, role_id: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/list/session/recording/playlists` — List all session recording playlists for a PostHog project, including both user-created playlists and system-generated synthetic playlists (like "Watch history", "Recordings with comments", etc.). Ses
  - body: { limit?: integer, offset?: integer, short_id?: string, created_by?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/session/recording/sharing/configs` — Retrieve a list of sharing configurations for a specific session recording in a project, including creation timestamps and access tokens. Requires project and recording IDs.
  - body: { project_id: string, recording_id: string }
- `POST https://api.mcp.ai/api/posthog/list/unused/organization/pipeline/transformations` — Retrieve a list of unused pipeline transformations for a specified organization, identified by UUID. Includes details like name, plugin type, and configuration. Supports JSON response format.
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/list/users/with/staff/filter/and/pagination` — API endpoint fetches a user list with staff filter, pagination (limit, offset), and requires a personal API key. Data includes UUIDs, emails, and organizational details.
  - body: { limit?: integer, offset?: integer, is_staff?: boolean }
- `POST https://api.mcp.ai/api/posthog/list/warehouse/saved/queries` — Tool to retrieve warehouse saved queries for a project. Use when you need to list or search saved queries from the data warehouse. Supports pagination via page parameter and filtering via search term.
  - body: { page?: integer, search?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/list/web/experiments` — Tool to retrieve a paginated list of web experiments for a specific project. Use when you need to discover available web experiments. Supports pagination via 'limit' and 'offset' parameters.
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/manage/feature/flag/enrichment/for/usage/dashboard` — Learn to manage feature flags (creation, access, modification, removal) using PostHog's docs, with options to use a JavaScript Library or a dedicated endpoint for user-specific flag status.
  - body: { id: integer, key?: string, name?: string, tags?: string[], active?: boolean, deleted?: boolean, filters?: object, surveys?: object, can_edit?: boolean, features?: object, created_at?: string, project_id: string, experiment_set?: integer[], is_simple_flag?: boolean, usage_dashboard?: integer, performed_rollback?: boolean, rollout_percentage?: integer, rollback_conditions?: string, analytics_dashboards?: integer[], has_enriched_analytics?: boolean, ensure_experience_continuity?: boolean }
- `POST https://api.mcp.ai/api/posthog/manage/project/annotations` — Create, Read, Update and Delete annotations. [See docs](https://posthog.com/docs/user-guides/annotations) for more information on annotations.
  - body: { id: integer, scope?: string, content?: string, deleted?: boolean, created_at: string, project_id: string, updated_at: string, date_marker?: string, dashboard_id: integer, insight_name: string, creation_type?: string, dashboard_item?: integer, dashboard_name: string, insight_short_id: string, insight_derived_name: string }
- `POST https://api.mcp.ai/api/posthog/manage/project/feature/flags/for/local/evaluation` — Retrieve all feature flag definitions for a project to enable local evaluation. This endpoint returns flag configurations, cohort definitions, and group type mappings that allow SDKs and applications 
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/mark/dashboard/template/as/deleted` — Hard delete of this model is not allowed. Use a patch API call to set "deleted" to true
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/mark/insight/as/viewed/with/configurable/format` — Marks one or more insights as viewed by the current user for a specified project. This endpoint records user engagement with insights and is idempotent. Requires `project_id` and `insight_ids` (a list
  - body: { format?: string, project_id: string, insight_ids: integer[] }
- `POST https://api.mcp.ai/api/posthog/mark/insights/as/viewed` — Record insights as viewed by updating their last_viewed_at timestamps. This endpoint tracks when a user views insights, which is useful for: - Activity tracking and analytics - Recently viewed insight
  - body: { format?: string, project_id: string, insight_ids: integer[] }
- `POST https://api.mcp.ai/api/posthog/mark/notebook/as/deleted` — Hard delete of this model is not allowed. Use a patch API call to set "deleted" to true
  - body: { short_id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/move/dashboard/tile` — Endpoint to move a tile from one dashboard to another. Requires `project_id` (in path), `id` (source dashboard ID in path), `tile` (object with `id` of the tile to move), and `toDashboard` (destinatio
  - body: { id: integer, tile: object, project_id: string, toDashboard: integer }
- `POST https://api.mcp.ai/api/posthog/patch/alert` — Tool to update an existing alert configuration in PostHog. Use when you need to modify alert settings such as name, enabled status, thresholds, or subscribed users. Performs a partial update (PATCH) -
  - body: { id: string, name?: string, config?: object, enabled?: boolean, insight?: integer, condition?: object, threshold?: object, project_id: string, skip_weekend?: boolean, snoozed_until?: string, subscribed_users?: integer[], calculation_interval?: string|object }
- `POST https://api.mcp.ai/api/posthog/patch/batch/export` — Update an existing batch export configuration in PostHog by partially modifying fields like name, paused status, destination, or schedule. Use when you need to modify batch export settings without rep
  - body: { id: string, name?: string, model?: string, end_at?: string, paused?: boolean, schema?: object, filters?: object, interval?: string, start_at?: string, offset_day?: integer, project_id: string, destination?: object, hogql_query?: string, offset_hour?: integer }
- `POST https://api.mcp.ai/api/posthog/patch/complete/product/onboarding` — Tool to mark a specific product onboarding as complete for a PostHog project. Use when a user has finished onboarding for features like product_analytics, session_replay, feature_flags, surveys, error
  - body: { id: integer, product_type: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/patch/customer/profile/config` — Update a customer profile configuration by partially modifying fields like content, scope, or sidebar. Use when you need to modify specific fields of an existing customer profile config without replac
  - body: { id: string, scope?: string, content?: object, sidebar?: object, project_id: string }
- `POST https://api.mcp.ai/api/posthog/patch/dataset` — Tool to partially update a dataset in a PostHog project. Use when you need to modify dataset properties like name or description. Only the fields provided in the request will be updated; other fields 
  - body: { id: string, name?: string, deleted?: boolean, project_id: string, description?: string }
- `POST https://api.mcp.ai/api/posthog/patch/dataset/item` — Tool to partially update a dataset item by its ID in a PostHog project. Use when you need to modify specific fields of a dataset item such as input, output, metadata, or reference fields.
  - body: { id: string, input?: object, output?: object, deleted?: boolean, metadata?: object, project_id: string, ref_trace_id?: string, ref_source_id?: string, ref_timestamp?: string }
- `POST https://api.mcp.ai/api/posthog/patch/endpoint` — Tool to partially update an endpoint for a project. Use when you need to modify specific fields of an existing endpoint without replacing the entire configuration.
  - body: { name: string, query?: object, is_active?: boolean, project_id: string, description?: string, is_materialized?: boolean, cache_age_seconds?: integer, derived_from_insight?: string }
- `POST https://api.mcp.ai/api/posthog/patch/error/tracking/autocapture/controls` — Partially update an error tracking autocapture control configuration. Use this to modify settings like sample rate, URL triggers, event triggers, and match type for a specific autocapture control.
  - body: { id: string, library?: string, match_type?: string, project_id: string, sample_rate?: string, url_triggers?: string[], url_blocklist?: string[], event_triggers?: string[], linked_feature_flag?: string|object }
- `POST https://api.mcp.ai/api/posthog/patch/evaluation` — Update an evaluation by patching specific fields. Use when you need to modify evaluation settings like description, enabled status, or configuration.
  - body: { id: string, name?: string, deleted?: boolean, enabled?: boolean, conditions?: object|object[], project_id: string, description?: string, output_type?: string, output_config?: object, evaluation_type?: string, evaluation_config?: object, model_configuration?: object }
- `POST https://api.mcp.ai/api/posthog/patch/experiment` — Endpoint enables partial updates to an experiment in a project using PATCH, needing `project_id`, `experiment_id`, and various payload types. Returns updated details. Authentication is mandatory.
  - body: { id: integer, name?: string, filters?: string, archived?: boolean, end_date?: string, created_at?: string, parameters?: string, project_id: string, start_date?: string, updated_at?: string, description?: string, exposure_cohort?: integer, feature_flag_key?: string, secondary_metrics?: string }
- `POST https://api.mcp.ai/api/posthog/patch/experiment/saved/metric` — Tool to partially update an experiment saved metric by ID in a PostHog project. Use when you need to modify specific fields of a saved metric configuration for experiments.
  - body: { id: integer, name?: string, tags?: string[], query?: object, project_id: string, description?: string }
- `POST https://api.mcp.ai/api/posthog/patch/external/data/source` — Tool to update an external data source in PostHog by patching specific fields like description or configuration. Use when you need to modify an existing data source without replacing all fields.
  - body: { id: string, prefix?: string, account_id?: string, project_id: string, description?: string, client_secret?: string, revenue_analytics_config?: object }
- `POST https://api.mcp.ai/api/posthog/patch/file/system` — Tool to partially update a file system resource by UUID and project ID. Use when you need to update specific fields like last_viewed_at, metadata, or other file system attributes without replacing the
  - body: { id: string, ref?: string, href?: string, meta?: object, path?: string, type?: string, depth?: integer, shortcut?: boolean, created_at?: string, project_id: string, last_viewed_at?: string }
- `POST https://api.mcp.ai/api/posthog/patch/file/system/shortcut` — Tool to partially update a file system shortcut in PostHog by its UUID. Use when you need to modify specific fields of an existing shortcut without replacing all data.
  - body: { id: string, ref?: string, href?: string, path?: string, type?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/patch/groups/types/metrics` — Tool to update a group usage metric configuration in PostHog. Use when you need to modify metric settings such as display format, filters, or interval. Performs a partial update (PATCH) - only fields 
  - body: { id: string, name?: string, format?: string, display?: string, filters?: object, interval?: integer, project_id: string, group_type_index: integer }
- `POST https://api.mcp.ai/api/posthog/patch/hog/function` — Tool to partially update a hog function by UUID and project ID. Use when you need to modify specific fields of a hog function such as description, enabled status, filters, or configuration without rep
  - body: { id: string, hog?: string, name?: string, type?: string|object, inputs?: object, deleted?: boolean, enabled?: boolean, filters?: object, masking?: object, icon_url?: string, mappings?: object[], project_id: string, description?: string, template_id?: string, inputs_schema?: object[], batch_export_id?: string, execution_order?: integer }
- `POST https://api.mcp.ai/api/posthog/patch/insight/variable` — Update an insight variable by partially modifying its properties (name, type, default value, etc.). Use when you need to modify specific fields of an existing insight variable without replacing the en
  - body: { id: string, name?: string, type?: string, values?: string|integer|number|boolean|string[]|object, code_name?: string, project_id: string, default_value?: string|integer|number|boolean|string[]|object }
- `POST https://api.mcp.ai/api/posthog/patch/live/debugger/breakpoint` — Tool to update a live debugger breakpoint by UUID and project ID. Use when you need to modify breakpoint properties like line number, enabled state, or condition without recreating it.
  - body: { id: string, enabled?: boolean, filename?: string, condition?: string, project_id: string, repository?: string, line_number?: integer }
- `POST https://api.mcp.ai/api/posthog/patch/organization/domain` — Updates selected properties of a domain in an organization via PATCH request, supports various data formats but SAML fields are immutable. Authentication needed.
  - body: { id: string, domain?: string, saml_acs_url?: string, saml_entity_id?: string, saml_x509_cert?: string, organization_id: string, sso_enforcement?: string, jit_provisioning_enabled?: boolean }
- `POST https://api.mcp.ai/api/posthog/patch/organization/role` — PATCH /api/organizations/{organization_id}/roles/{id}/: Update partial details of a role by ID within an organization, including name and feature flag access level. Requires UUIDs for both organizatio
  - body: { id: string, name?: string, members?: string, created_at?: string, organization_id: string, associated_flags?: string }
- `POST https://api.mcp.ai/api/posthog/patch/persisted/folder` — Tool to partially update a persisted folder by ID for a PostHog project. Use when you need to modify specific attributes of an existing persisted folder configuration.
  - body: { id: string, path?: string, type?: string, protocol?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/patch/person` — This endpoint allows reading and deleting individuals. For creation or updates, use the capture API, `$set`/`$unset` properties, or SDKs.
  - body: { id: string, name?: string, uuid?: string, format?: string, created_at?: string, project_id: string, properties?: string, distinct_ids?: string[] }
- `POST https://api.mcp.ai/api/posthog/patch/product/tour` — Tool to partially update a product tour in PostHog. Use when you need to modify specific fields of an existing tour like description, archived status, dates, or content.
  - body: { id: string, name?: string, content?: object, archived?: boolean, end_date?: string, project_id: string, start_date?: string, auto_launch?: boolean, description?: string, linked_flag_id?: integer, creation_context?: string, targeting_flag_filters?: object }
- `POST https://api.mcp.ai/api/posthog/patch/project/action` — Update an action within a project with a specified ID. Supports partial updates. Accepts JSON, form-data, and query parameters including 'project_id' and 'id'. Formats response in CSV or JSON. Require
  - body: { id: integer, name?: string, tags?: string[], steps?: object[], format?: string, deleted?: boolean, team_id?: integer, is_action?: boolean, created_at?: string, project_id: string, description?: string, post_to_slack?: boolean, bytecode_error?: string, is_calculating?: boolean, last_calculated_at?: string, slack_message_format?: string }
- `POST https://api.mcp.ai/api/posthog/patch/project/annotation` — Create, Read, Update and Delete annotations. [See docs](https://posthog.com/docs/user-guides/annotations) for more information on annotations.
  - body: { id: integer, scope?: string, content?: string, deleted?: boolean, created_at?: string, project_id: string, updated_at?: string, date_marker?: string, dashboard_id?: integer, insight_name?: string, creation_type?: string, dashboard_item?: integer, dashboard_name?: string, insight_short_id?: string, insight_derived_name?: string }
- `POST https://api.mcp.ai/api/posthog/patch/project/cohort` — Update partial cohort details for a specific project. Requires a cohort ID and project ID, supports JSON, form data, and accepts patch changes like name or description. Returns updated cohort data. Au
  - body: { id: integer, name?: string, count?: integer, query?: string, groups?: string, deleted?: boolean, filters?: string, is_static?: boolean, created_at?: string, project_id: string, description?: string, experiment_set?: integer[], is_calculating?: boolean, last_calculation?: string, errors_calculating?: integer }
- `POST https://api.mcp.ai/api/posthog/patch/project/dashboard` — Endpoint PATCH /api/projects/{project_id}/dashboards/{id}: Allows partial update of a project's dashboard with specified ID. Accepts JSON, form data, and provides a detailed response schema based on u
  - body: { id: integer, name?: string, tags?: string[], tiles?: object[], pinned?: boolean, deleted?: boolean, filters?: string, is_shared?: boolean, created_at?: string, project_id: string, description?: string, use_template?: string, use_dashboard?: integer, delete_insights?: boolean }
- `POST https://api.mcp.ai/api/posthog/patch/project/feature/flag` — Learn to manage feature flags (create, read, update, delete) using PostHog's docs, with options for JavaScript Library use or dedicated endpoints for user flag status.
  - body: { id: integer, key?: string, name?: string, tags?: string[], active?: boolean, deleted?: boolean, filters?: object, surveys?: object, can_edit?: boolean, features?: object, created_at?: string, project_id: string, experiment_set?: integer[], is_simple_flag?: boolean, usage_dashboard?: integer, performed_rollback?: boolean, rollout_percentage?: integer, rollback_conditions?: string, analytics_dashboards?: integer[], has_enriched_analytics?: boolean, ensure_experience_continuity?: boolean }
- `POST https://api.mcp.ai/api/posthog/patch/project/insight` — The PATCH endpoint supports partial insight updates in a project, allows format specification (CSV/JSON), and requires `PersonalAPIKeyAuth` and `insight:write` scope for access.
  - body: { id: integer, name?: string, tags?: string[], hogql?: string, order?: integer, query?: string, saved?: boolean, types?: string, format?: string, result?: string, columns?: string, deleted?: boolean, filters?: string, short_id?: string, timezone?: string, favorited?: boolean, is_cached?: string, is_sample?: boolean, created_at?: string, dashboards?: integer[], project_id: string, updated_at?: string, description?: string, derived_name?: string, last_refresh?: string, query_status?: string, dashboard_tiles?: object[], cache_target_age?: string, last_modified_at?: string, next_allowed_client_refresh?: string }
- `POST https://api.mcp.ai/api/posthog/patch/project/member` — Update a project member's role using their UUID in a specific project. Accepts partial data to modify membership details such as role level, provided the member's UUID and project ID. Note: This endpo
  - body: { id?: string, level?: integer, joined_at?: string, user_uuid?: string, project_id: string, updated_at?: string, parent_level?: integer, parent_membership_id?: string, parent__membership__user__uuid: string }
- `POST https://api.mcp.ai/api/posthog/patch/project/notebook` — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
  - body: { id?: string, title?: string, content?: string, deleted?: boolean, version?: integer, short_id: string, created_at?: string, project_id: string, text_content?: string, last_modified_at?: string }
- `POST https://api.mcp.ai/api/posthog/patch/project/property/definition` — PATCH /api/projects/{project_id}/property_definitions/{id}/: Partially update a specific property definition by UUID in a project. Requires property_definition:write auth. No response body.
  - body: { id: string, tags?: string[], project_id: string, property_type?: string }
- `POST https://api.mcp.ai/api/posthog/patch/project/subscription` — PATCH /api/projects/{project_id}/subscriptions/{id}/: Update partial details of a specific project subscription by ID. Modify target, frequency, and more. Requires subscription:write permission.
  - body: { id: integer, count?: integer, title?: string, deleted?: boolean, insight?: integer, summary?: string, bysetpos?: integer, interval?: integer, byweekday?: string[], dashboard?: integer, frequency?: string, created_at?: string, project_id: string, start_date?: string, until_date?: string, target_type?: string, target_value?: string, invite_message?: string, next_delivery_date?: string }
- `POST https://api.mcp.ai/api/posthog/patch/project/survey` — Update partial survey details by PATCH to /api/projects/{project_id}/surveys/{id}/ with UUID. Edit attributes like name, type, questions, targeting, and flags. Needs PersonalAPIKeyAuth for write acces
  - body: { id: string, name?: string, type?: string, archived?: boolean, end_date?: string, questions?: string, appearance?: string, conditions?: string, created_at?: string, project_id: string, start_date?: string, description?: string, linked_flag_id?: integer, iteration_count?: integer, responses_limit?: integer, current_iteration?: integer, targeting_flag_id?: integer, iteration_start_dates?: string[], remove_targeting_flag?: boolean, targeting_flag_filters?: string, iteration_frequency_days?: integer, current_iteration_start_date?: string }
- `POST https://api.mcp.ai/api/posthog/patch/session/recording/playlist` — Update session recording playlists using PATCH on the endpoint with `project_id` and `short_id`. Accepts JSON and forms data for detail amendments. Partial updates allowed. `PersonalAPIKeyAuth` needed
  - body: { id?: integer, name?: string, pinned?: boolean, deleted?: boolean, filters?: string, short_id: string, created_at?: string, project_id: string, description?: string, derived_name?: string, last_modified_at?: string }
- `POST https://api.mcp.ai/api/posthog/patch/user` — Tool to update user profile settings in PostHog. Use when you need to modify user information such as name, email, role, theme preferences, or notification settings. Performs a partial update (PATCH) 
  - body: { uuid: string, email?: string, last_name?: string, first_name?: string, theme_mode?: string, anonymize_data?: boolean, set_current_team?: string, allow_impersonation?: boolean, role_at_organization?: string, notification_settings?: object, passkeys_enabled_for_2fa?: boolean, set_current_organization?: string, allow_sidebar_suggestions?: boolean }
- `POST https://api.mcp.ai/api/posthog/patch/warehouse/saved/query` — Tool to partially update a warehouse saved query in PostHog. Use when you need to modify properties like name, query definition, or sync frequency. Only the fields provided in the request will be upda
  - body: { id: string, name?: string, query?: string|object, origin?: string|object, status?: string|object, columns?: string, deleted?: boolean, project_id: string, soft_update?: boolean, sync_frequency?: string, is_materialized?: boolean }
- `POST https://api.mcp.ai/api/posthog/patch/warehouse/tables` — Tool to partially update a warehouse table by patching specific fields like name, format, or schema. Use when you need to modify an existing warehouse table without replacing all fields.
  - body: { id: string, name?: string, format?: string, columns?: string, deleted?: boolean, project_id: string, url_pattern?: string, external_schema?: string }
- `POST https://api.mcp.ai/api/posthog/patch/web/experiment` — Tool to partially update a web experiment in PostHog. Use when you need to modify specific fields of an existing web experiment without replacing the entire configuration.
  - body: { id: integer, name?: string, variants?: object, project_id: string, feature_flag_key?: string }
- `POST https://api.mcp.ai/api/posthog/pause/batch/export` — Pause a batch export in PostHog to temporarily stop scheduled data exports. Use when you need to halt data exports without deleting the batch export configuration.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/pause/organization/batch/export` — Pause an organization-level batch export in PostHog. Use when you need to temporarily stop scheduled data exports at the organization level without deleting the batch export configuration.
  - body: { id: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/project/funnel/advanced/analytics` — Create comprehensive funnel analysis for a PostHog project with advanced configuration options. Analyze user conversion through multi-step funnels with customizable time windows, ordering rules, visua
  - body: { events?: object[], format?: string, actions?: object[], date_to?: string, breakdown?: string, date_from?: string, exclusions?: object[], project_id: string, properties?: object, breakdown_type?: string, breakdown_limit?: integer, funnel_viz_type?: string, funnel_order_type?: string, funnel_window_days?: integer, filter_test_accounts?: boolean, funnel_window_interval?: integer, funnel_window_interval_type?: string, aggregation_group_type_index?: integer }
- `POST https://api.mcp.ai/api/posthog/project/trend/analytics` — The `/api/projects/{project_id}/insights/trend/` endpoint provides project trends in CSV/JSON, requires `project_id` and optional parameters, and needs 'PersonalAPIKeyAuth'. It outputs event data and 
  - body: { events?: object[], format?: string, actions?: object[], compare?: boolean, date_to?: string, formula?: string, breakdown?: string, date_from?: string, compare_to?: string, project_id: string, filter_test_accounts?: boolean }
- `POST https://api.mcp.ai/api/posthog/rearrange/frontend/app/pipeline/configs` — Rearrange (reorder) the configuration of frontend apps in a project's data pipeline. Pipeline frontend apps are plugins that add UI extensions to PostHog such as custom visualizations, dashboards, and
  - body: { id?: integer, name?: string, error?: string, order?: integer, config?: string, plugin?: integer, deleted?: boolean, enabled?: boolean, filters?: string, team_id?: integer, created_at?: string, project_id: string, updated_at?: string, description?: string, plugin_info?: string, delivery_rate_24h?: string }
- `POST https://api.mcp.ai/api/posthog/rearrange/pipeline/transformation/configs` — Rearrange the execution order of pipeline transformation configurations for a project. This endpoint allows you to change the order in which transformation plugins are executed in the data pipeline. Y
  - body: { id?: integer, name?: string, error?: string, order?: integer, config?: string, plugin?: integer, deleted?: boolean, enabled?: boolean, filters?: string, team_id?: integer, created_at?: string, project_id: string, updated_at?: string, description?: string, plugin_info?: string, delivery_rate_24h?: string }
- `POST https://api.mcp.ai/api/posthog/rearrange/project/import/app/configurations` — Rearrange app import settings in a project using PATCH /api/projects/{project_id}/... by updating plug-in order and status. Requires `project_id` and a JSON with configurations.
  - body: { id?: integer, name?: string, error?: string, order?: integer, config?: string, plugin?: integer, deleted?: boolean, enabled?: boolean, filters?: string, team_id?: integer, created_at?: string, project_id: string, updated_at?: string, description?: string, plugin_info?: string, delivery_rate_24h?: string }
- `POST https://api.mcp.ai/api/posthog/rearrange/project/pipeline/destination/configs` — Rearrange the execution order of pipeline destination configurations for a project. This endpoint allows you to change the order in which destination plugins receive events in the data pipeline. You c
  - body: { id?: integer, name?: string, error?: string, order?: integer, config?: string, plugin?: integer, deleted?: boolean, enabled?: boolean, filters?: string, team_id?: integer, created_at?: string, project_id: string, updated_at?: string, description?: string, plugin_info?: string, delivery_rate_24h?: string }
- `POST https://api.mcp.ai/api/posthog/recalculate/experiment/timeseries` — Tool to create a recalculation request for experiment timeseries data. Use when you need to recalculate metrics for an experiment. The experiment must have a start_date set (must be started) for recal
  - body: { id: integer, metric: object, project_id: string, fingerprint: string }
- `POST https://api.mcp.ai/api/posthog/reconfigure/plugin/order/and/status/in/project` — Reconfigure the execution order and status of plugin configurations within a project. This endpoint allows you to update plugin configuration settings including: - Execution order (which plugins run f
  - body: { id?: integer, name?: string, error?: string, order?: integer, config?: string, plugin?: integer, deleted?: boolean, enabled?: boolean, filters?: string, team_id?: integer, created_at?: string, project_id: string, updated_at?: string, description?: string, plugin_info?: string, delivery_rate_24h?: string }
- `POST https://api.mcp.ai/api/posthog/replace/desktop/recording` — Replace a desktop meeting recording in PostHog using PUT. Use when you need to completely replace all recording data including metadata, transcript, participants, and status. Unlike PATCH, this requir
  - body: { id: string, team: integer, notes?: string, status?: string, summary?: string, platform: string, video_url?: string, created_by: integer, project_id: string, started_at?: string, meeting_url?: string, completed_at?: string, participants?: string[], error_message?: string, meeting_title?: string, sdk_upload_id: string, extracted_tasks?: object[], transcript_text: string, duration_seconds?: integer, video_size_bytes?: integer, tasks_generated_at?: string, recall_recording_id?: string, transcript_segments?: object[], summary_generated_at?: string }
- `POST https://api.mcp.ai/api/posthog/reset/person/distinct/id` — Reset a distinct_id for a deleted person. This allows the distinct_id to be used again. Use when you need to recycle a distinct_id from a previously deleted person for reuse.
  - body: { format?: string, project_id: string, distinct_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/async/query/status/by/id` — (Experimental)
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/last/viewed/insights/for/user` — Returns basic details about the last 5 insights viewed by this user. Most recently viewed first.
  - body: { format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/matching/events/for/session/recording` — Retrieves event IDs matching a filter with one session ID and at least one event/action criterion. Intended for internal use and may have sudden changes. IMPORTANT: This endpoint does NOT support Pers
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/notebook/activity/for/project` — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/notebook/activity/log` — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
  - body: { short_id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/notebook/details` — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
  - body: { short_id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/or/delete/person/retention/data` — This endpoint is for reading and deleting person data; use the capture API, `$set`/`$unset` properties, or SDKs for creation and updates.
  - body: { format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/or/delete/project/persons/funnel/data` — Retrieves persons who entered or progressed through a funnel in the specified project. Note: This endpoint requires that a funnel has been previously created and analyzed in PostHog. The endpoint retu
  - body: { format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/organization/pipeline/frontend/app` — Retrieve pipeline frontend app details for an organization using its 'organization_id' (UUID). Response includes ID, plugin type, name, URL in JSON format, covering various plugin types.
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/organization/pipeline/repository/details` — Retrieve details for repository pipeline destinations within a specific organization by its UUID. Returns objects like ID, name, and URLs with support for various plugin types (local, custom, etc.).
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/organization/pipeline/transformation/activi` — Retrieve org pipeline transformation activity
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/organization/pipeline/unsubscribe/configs` — Retrieve export unsubscribe configurations for an organization's pipeline frontend apps. Returns a list of unsubscribe configurations defining how users can opt out of frontend app exports (e.g., noti
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/organization/plugin/activity` — Retrieve activity details for plugins in a specified organization by ID. Supports various plugin types, including local, custom, and repository. Response includes plugin's id, name, type, and relevant
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/organization/plugin/details` — Retrieve a specific plugin's details for an organization. Requires the plugin's integer ID and the organization's UUID. Only returns plugin info if authenticated with 'plugin:read' permission. Respond
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/organization/plugin/repository/details` — Retrieve plugin repository details for a specific organization by its UUID, including plugin type, name, URL, and more. Accessible via GET request to '/api/organizations/{organization_id}/plugins/repo
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/organization/plugin/unsubscribe/configs` — Retrieve export unsubscribe configurations for plugins in an organization. Returns a list of unsubscribe configurations for various plugin types (local, custom, repository, source, inline) that define
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/organization/project/details` — Projects for the current organization.
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/organization/role/details` — Retrieve the details of a specific role within an organization using its UUID. Requires the organization's UUID and role's UUID in the path and is protected by PersonalAPIKeyAuth with 'organization:re
  - body: { id: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/organization/unused/pipeline/apps` — Retrieve unused pipeline import apps for a specified organization. Endpoint requires an organization_id (UUID) and returns details like plugin type, name, description, and more in JSON format.
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/paginated/organization/list` — Retrieve a paginated list of organizations with optional 'limit' and 'offset' query parameters. The response includes organization details like ID, name, and membership level, with secure access contr
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/posthog/retrieve/persisted/folder` — Tool to retrieve a specific persisted folder by its UUID and project ID. Use when you need to get details about a persisted folder including its type, path, and timestamps.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/person/activity/and/delete/options` — This endpoint is for reading and deleting persons; for creating/updating, use the capture API, `$set`/`$unset` properties, or SDKs.
  - body: { id: string, format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/person/details/by/id` — This endpoint is used to read and delete persons. For creating or updating, use the capture API, `$set` and `$unset` properties, or SDKs.
  - body: { id: string, format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/person/values/by/project` — Retrieve unique values for a specific person property across all persons in a project. Returns a list of distinct values for the specified property key, along with the count of persons who have that v
  - body: { key: string, format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/persons/funnel/correlation/data` — **Note**: This endpoint path appears to be incorrectly defined or deprecated in the PostHog API. The documented endpoint `/api/projects/{project_id}/persons/funnel/correlation/` returns 403 Forbidden,
  - body: { format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/pipeline/destination/activity` — Retrieve activity details for pipeline destinations within an organization. **Parameters:** - `organization_id` (required): UUID-formatted organization identifier **Returns:** JSON object with pipelin
  - body: { limit?: integer, offset?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/pipeline/destination/config/details` — Retrieve details of a specific pipeline destination config for a project by its ID. Requires project ID and destination config ID. Supports PersonalAPIKeyAuth for read access. Responds with config det
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/pipeline/destination/details` — Fetch a pipeline destination's details by ID and organization UUID, using a PersonalAPIKeyAuth with read access to plugins. Returns JSON with plugin info.
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/pipeline/destination/plugin/details` — Retrieve details of a specific pipeline destination plugin within an organization by its unique ID. The response includes various properties like name, description, URL, and plugin type for the given 
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/pipeline/frontend/app/activity` — Retrieve activity details for pipeline front-end apps within a specified organization by organization ID. Returns JSON object with app properties such as ID, type, name, and configuration. UUID path p
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/pipeline/frontend/app/details` — Retrieve detailed information about a specific pipeline frontend app within an organization. Pipeline frontend apps are site apps that inject code into websites to provide features like notification b
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/pipeline/frontend/app/source/details` — Retrieve details for a specific pipeline frontend app's source by its ID within an organization. Requires an integer ID of the app and UUID of the organization. Returns JSON object with app properties
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/pipeline/frontend/plugin/config` — Retrieve the frontend-specific configuration for a pipeline frontend app by its config ID and project ID. This endpoint returns only the client-side configuration that the frontend app needs to run in
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/pipeline/import/apps/activity` — Retrieve activity details of pipeline import apps for a given organization. Requires 'organization_id' (UUID). Returns app ID, type, name, URL, and other metadata. Supports 'local', 'custom', 'reposit
  - body: { limit?: integer, offset?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/pipeline/plugin/details/by/id` — Retrieve detailed information about a specific pipeline transformation plugin by ID. Returns comprehensive plugin details including: - Plugin type (inline/custom), name, and description - Configuratio
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/pipeline/plugin/source` — Retrieve the source details of a pipeline transformation for a specific plugin by ID within an organization. Access plugin metadata, like its type, URL, and config, relevant to organizing and managing
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/pipeline/transformation/frontend/config` — Retrieve the frontend configuration details for a specific pipeline transformation by ID within a given project. This endpoint requires the project ID and transformation config ID in the path.
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/plugin/source/details` — Retrieve plugin source details by organization and plugin ID. Requires integer 'id' for the plugin and 'organization_id' as UUID. Responds with plugin attributes including type, name, and URL.
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/plugin/update/info` — This endpoint retrieves update information for a specific plugin within an organization's pipeline frontend app by its integer ID and the organization's UUID. It returns details such as plugin type, n
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/plugin/update/status` — Retrieve the latest update status for a specific plugin, identified by its integer ID, within an organization specified by UUID. Check compatibility and change logs.
  - body: { id: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/action/details/by/id` — Get details on a project action by ID. Supports JSON/CSV format via query. Needs 'project_id' and 'id' path parameters. Secured by PersonalAPIKeyAuth.
  - body: { id: integer, format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/activity/details` — Retrieve the activity log for a specified project, showing recent changes and events. Returns a paginated list of activity entries including user actions, system events, and changes to resources like 
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/activity/insights` — Retrieve the activity log history for insights in a specific project. Returns a paginated list of all insight-related activities (created, updated, deleted) with details about who performed each actio
  - body: { page?: integer, limit?: integer, format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/activity/log/with/pagination` — Retrieve a project's activity log with cursor-based pagination. Returns activities like resource creation, updates, and deletions with details about the user who performed the action, timestamps, and 
  - body: { cursor?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/annotation/details` — Create, Read, Update and Delete annotations. [See docs](https://posthog.com/docs/user-guides/annotations) for more information on annotations.
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/cohort/details` — Retrieve detailed information about a specific cohort within a project using its ID. Requires project ID and cohort ID; returns cohort details including name, creator info, and status. Auth: PersonalA
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/cohorts/activity/log` — Retrieve activity log for a specific project's cohorts. Requires a project_id and PersonalAPIKeyAuth with activity_log:read permission. Response includes cohort details and creator info.
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/cohorts/with/pagination` — Retrieve a paginated list of cohorts for a specific project using `project_id`. Supports `limit` and `offset` query params to customize the response. Requires `PersonalAPIKeyAuth` with `cohort:read` p
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/early/access/feature/details` — Retrieve details of a specific early access feature in a project by ID. Requires project_id and feature UUID. Must have 'early_access_feature:read' permission. Returns feature details including status
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/event/details/by/id` — Retrieve details for a specific event by ID within a project. Supports CSV or JSON format. Requires project_id in path and adheres to PersonalAPIKeyAuth for security.
  - body: { id: string, format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/event/values` — Retrieve event values for a specific project by ID. Supports querying in CSV or JSON format. Requires a project_id and personal API key with query:read permission. Responds with event details such as 
  - body: { key: string, format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/experiment/results` — Retrieve experiment timeseries results within a project by project and experiment ID. Aggregates daily results into a timeseries format for frontend compatibility. Requires project_id and experiment i
  - body: { id: integer, project_id: string, fingerprint: string, metric_uuid: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/export/details` — Retrieve detailed info on a specific export of a project using its unique ID. Requires project ID and supports various export formats like PNG, PDF, CSV, and XLSX. Auth: PersonalAPIKeyAuth with export
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/funnel/correlation/insights` — Retrieve funnel correlation insights for a specific project. Analyzes which events or properties correlate with conversion success or failure in a funnel. Requires defining a funnel with at least 2 st
  - body: { events?: object[], format?: string, actions?: object[], date_to?: string, insight?: string, date_from?: string, project_id: string, filter_test_accounts?: boolean, funnel_window_interval?: integer, funnel_correlation_type?: string, funnel_window_interval_type?: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/group/details/by/key/and/type` — Retrieves specified group details within a project by group key and type index. Requires 'group_key', 'group_type_index', and 'project_id'. Responds with group details, including creation timestamp.
  - body: { group_key: string, project_id: string, group_type_index: integer }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/insight/activity/data` — Retrieve insights activity for a specific project and insight ID, offering data in JSON or CSV format. Requires project_id and insight id in the path, with optional data format query. Secure access vi
  - body: { id: integer, page?: integer, limit?: integer, format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/insight/details` — Retrieve details for a specific project insight by ID, with options to format as JSON/CSV, request refresh, and specify dashboard context. Supports PersonalAPIKeyAuth with insight read access. Respons
  - body: { id: integer, format?: string, refresh?: boolean, project_id: string, from_dashboard?: integer }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/insights/with/pagination` — The GET `/api/projects/{project_id}/insights/` endpoint retrieves a paginated list of insights for a specified project. Filter by creator, response format (CSV/JSON), and use limit/offset for result b
  - body: { limit?: integer, format?: string, offset?: integer, short_id?: string, created_by?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/member/details/by/uuid` — Retrieve detailed information about a specific user's membership level and status within a project by their UUID. Access project members' data, roles, and timestamps. (GET /api/projects/{project_id}/e
  - body: { project_id: string, parent__membership__user__uuid: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/person/activity` — This endpoint allows reading and deleting individuals. For creating or updating, use the capture API, `$set`/`$unset` properties, or SDKs.
  - body: { page?: integer, limit?: integer, format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/session/values` — Retrieve session values for a specified project. Pass the project_id in the URL path to obtain the information. Only the project's ID is required as a parameter. No response body for the 200 OK status
  - body: { key: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/subscription/details` — Retrieve a specific subscription for a project, identified by 'project_id' and 'id'. Requires valid API key with read access. Supports GET method, returns subscription details including frequency, typ
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/project/trend/insights` — Retrieves saved trend insights from a PostHog project. Returns a list of all trend insights or a specific insight by short_id. Supports pagination via limit/offset and CSV/JSON output formats. Use thi
  - body: { limit?: integer, format?: string, offset?: integer, short_id?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/properties/and/events/association` — Allows a caller to provide a list of event names and a single property name Returns a map of the event names to a boolean representing whether that property has ever been seen with that event_name
  - body: { project_id: string, event_names: string, property_name: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/property/definition/details` — Retrieve details of a specific property definition by UUID within a project. Requires project_id and property definition id. Security: PersonalAPIKeyAuth with read access. No response body provided.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/related/project/groups` — Retrieve related groups for a specific project and user. Requires 'project_id' (path), 'group_type_index', and user 'id' (query). Returns group details with type, key, and creation date.
  - body: { id: string, project_id: string, group_type_index: integer }
- `POST https://api.mcp.ai/api/posthog/retrieve/retention/insights` — DEPRECATED: Use POSTHOG_CREATE_RETRIEVE_RETENTION_INSIGHTS_FOR_PROJECT instead. Retrieve retention insights for a specified project using PostHog's Query API. Analyzes how users return over time based
  - body: { query?: object, refresh?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/session/property/definitions` — Retrieve property definitions for a specific project by providing the project's ID. Access this GET endpoint at `/api/projects/{project_id}/sessions/property_definitions/`. Project ID is mandatory. No
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/session/recording/details` — Retrieve detailed information about a specific session recording by providing the session's UUID and associated project ID. The response includes metrics such as duration, activity, timestamps, and us
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/session/recording/error/clusters` — Retrieve error clusters from session recordings for a specified project. This endpoint provides details on user interactions, console logs, and activity times in JSON format, requiring the project ID 
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/session/recording/playlist/details` — Retrieve the list of session recordings within a playlist. Returns paginated results containing recording details like duration, activity counts, and timestamps. Use this to access recordings that hav
  - body: { short_id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/session/recording/properties/by/project/id` — Retrieve properties of session recordings for a given project by ID, including activity metrics, timestamps, and participant details. Requires project_id in the path. Returns JSON data with recording 
  - body: { limit?: integer, offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/session/recording/snapshots` — Snapshots for a session can be loaded from S3 (if old) or Redis (if recent). Clients call the API without a source to get supported sources, then per source for snapshots. API v1 is deprecated; ClickH
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/specific/batch/export/details` — Retrieve details of a specific batch export for an organization by its UUID. Requires a PersonalAPIKeyAuth with 'batch_export:read' permission. Responses include export details like name, model, desti
  - body: { id: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/specific/batch/export/run/details` — Retrieve details for a specific batch export run within a project by ID. Requires a UUID for batch_export_id and run ID. Provides run status, record count, timestamps, latest error, and intervals. Sec
  - body: { id: string, project_id: string, batch_export_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/specific/domain/details` — Retrieve complete details of a specific authentication domain within an organization by its UUID. Returns domain verification status, SAML SSO configuration, JIT provisioning settings, and SSO enforce
  - body: { id: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/specific/exported/asset/content` — Retrieve the content of a specific exported asset by ID within a project. Requires 'export:read' permission. Supports fetching details like creation time, format (PNG, PDF, CSV, Excel), etc.
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/specific/historical/plugin/export` — Retrieve historical export data for a specific plugin configuration within a project. Requires project, plugin config, and export item IDs. Auth via PersonalAPIKeyAuth. No body in 200 response.
  - body: { id: string, project_id: string, plugin_config_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/specific/pipeline/frontend/app/config` — Retrieve the configuration details of a specific pipeline frontend app by providing its unique ID and the associated project ID. Pipeline frontend apps are plugins that extend PostHog's UI with custom
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/specific/project/dashboard/details` — Retrieve details of a specific dashboard within a project. Requires a dashboard ID & project ID, and returns information such as dashboard properties, owner, and access levels. Auth: PersonalAPIKeyAut
  - body: { id: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/survey/activity/logs` — Retrieve activity logs for specific survey in a project, identified by UUIDs. Requires valid API key with 'activity_log:read' permissions. Supports JSON response detailing survey's properties, types, 
  - body: { id: string, page?: integer, limit?: integer, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/survey/details/with/uuid/and/project/id` — Retrieve survey details using survey UUID and associated project ID. Supports secure access with 'PersonalAPIKeyAuth'. Returns survey name, type, linking, targeting flags, creator info, and questions 
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/survey/responses/count/by/project/id` — Retrieve the count of survey responses for a specific project by its ID. It requires the project_id parameter and returns details like the survey type, linked flags, and creator info.
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/unsubscribed/pipeline/configs` — Retrieve export unsubscribe configurations for an organization's pipeline destinations. Returns a list of unsubscribe configurations defining how users can opt out of data exports to destinations (e.g
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/posthog/retrieve/user/profile/and/team/details` — Fetch user profile info including team, organization, and notifications. Non-staff users can only retrieve their own profile using '@me' as the uuid parameter. Staff users can retrieve any user's prof
  - body: { uuid: string }
- `POST https://api.mcp.ai/api/posthog/retry/batch/export/run` — Tool to retry a failed or incomplete batch export run. Uses the same backfill mechanism as batch export backfills. Use when you need to re-execute a specific batch export run that failed or needs to b
  - body: { id: string, project_id: string, batch_export_id: string }
- `POST https://api.mcp.ai/api/posthog/revoke/organization/invite` — Delete an organization invite by its UUID. Requires a valid PersonalAPIKeyAuth with organization member write permission. No response body returned on success (HTTP 204).
  - body: { id: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/run/endpoint` — Tool to execute a PostHog endpoint with optional materialization and filtering. Endpoints can be HogQL queries, insights (Trends, Funnels, etc.), or other query types. Use this when you need to run a 
  - body: { name: string, debug?: boolean, limit?: integer, refresh?: string, version?: integer, variables?: object, project_id: string, client_query_id?: string, filters_override?: object }
- `POST https://api.mcp.ai/api/posthog/split/person/entities/in/project` — This endpoint allows reading and deleting persons; for creation or updates, use the capture API, `$set`/`$unset` properties, or SDKs.
  - body: { id: string, format?: string, project_id: string, distinct_ids?: string[] }
- `POST https://api.mcp.ai/api/posthog/start/error/tracking/symbol/set/upload` — Tool to initiate symbol set upload session for error tracking in PostHog. Use when you need to upload symbol files for stack trace symbolication. Returns a presigned S3 URL where the symbol file chunk
  - body: { id: string, ref: string, release: string, team_id: integer, chunk_id: string, last_used?: string, created_at: string, project_id: string, storage_ptr?: string, failure_reason?: string }
- `POST https://api.mcp.ai/api/posthog/start/error/tracking/symbol/sets/bulk/upload` — Tool to initiate bulk upload of error tracking symbol sets for a PostHog project. Use when you need to start uploading debug symbols for error tracking and source map resolution. This endpoint initial
  - body: { id: string, ref: string, release: string, team_id: integer, last_used?: string, created_at: string, project_id: string, storage_ptr?: string, failure_reason?: string }
- `POST https://api.mcp.ai/api/posthog/summarize/survey/responses` — Tool to generate an AI-powered summary of survey responses for a specific question. Use when you need to analyze and summarize feedback from survey respondents for a particular question.
  - body: { id: string, project_id: string, question_index: integer }
- `POST https://api.mcp.ai/api/posthog/translate/text` — Tool to translate text to a target language using PostHog's LLM analytics translation endpoint. Use when you need to translate content for analytics or internationalization purposes.
  - body: { text: string, project_id: string, target_language: string }
- `POST https://api.mcp.ai/api/posthog/trigger/project/export/with/format/option` — The `/api/projects/{project_id}/exports/` endpoint triggers a project export, requiring `project_id` and `export_format`. It accepts JSON, form-encoded, and multipart data, responding with a 201 code 
  - body: { insight?: integer, dashboard?: integer, project_id: string, export_format: string, export_context?: object }
- `POST https://api.mcp.ai/api/posthog/unarchive/survey/response` — Tool to unarchive a single survey response. Use when you need to restore a previously archived survey response to make it visible again in survey analytics.
  - body: { id: string, project_id: string, response_uuid: string }
- `POST https://api.mcp.ai/api/posthog/unpause/batch/export` — Tool to unpause a paused batch export in PostHog. Use when you need to resume a previously paused batch export to restart data exports.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/unpause/organization/batch/export` — Tool to unpause a paused batch export at the organization level. Use when you need to resume a previously paused organization-level batch export to restart data exports.
  - body: { id: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/update/alert` — Tool to fully update an existing alert configuration in PostHog using PUT method. Use when you need to completely replace alert settings including name, enabled status, insight, thresholds, and subscr
  - body: { id: string, name: string, config?: object, enabled: boolean, insight: integer, condition?: object, threshold: object, project_id: string, skip_weekend?: boolean, snoozed_until?: string, subscribed_users: integer[], calculation_interval?: string|object }
- `POST https://api.mcp.ai/api/posthog/update/annotation/details` — Create, Read, Update and Delete annotations. [See docs](https://posthog.com/docs/user-guides/annotations) for more information on annotations.
  - body: { id: integer, scope?: string, content?: string, deleted?: boolean, created_at?: string, project_id: string, updated_at?: string, date_marker?: string, dashboard_id?: integer, insight_name?: string, creation_type?: string, dashboard_item?: integer, dashboard_name?: string, insight_short_id?: string, insight_derived_name?: string }
- `POST https://api.mcp.ai/api/posthog/update/batch/export` — Tool to update an existing batch export configuration in PostHog. Use when you need to modify batch export settings like name, schedule, destination, or filtering options.
  - body: { id: string, name?: string, model?: string, end_at?: string, paused?: boolean, schema?: object, filters?: object, interval?: string, start_at?: string, timezone?: string, offset_day?: integer, destination?: object, hogql_query?: string, offset_hour?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/update/customer/profile/config` — Update a customer profile configuration by completely replacing it with new data via PUT request. Use when you need to update the entire customer profile config object including all fields.
  - body: { id: string, scope: string, content?: object, sidebar?: object, created_at: string, project_id: string, updated_at?: string }
- `POST https://api.mcp.ai/api/posthog/update/dataset` — Tool to update a dataset in PostHog by its ID and project ID. Use when you need to modify the name or description of an existing dataset.
  - body: { id: string, name?: string, project_id: string, description?: string }
- `POST https://api.mcp.ai/api/posthog/update/dataset/items` — Tool to fully update a dataset item by its ID in a PostHog project using PUT method. Use when you need to replace all fields of a dataset item including dataset, input, output, and metadata.
  - body: { id: string, input?: object, output?: object, dataset: string, deleted?: boolean, metadata?: object, project_id: string, ref_trace_id?: string, ref_source_id?: string, ref_timestamp?: string }
- `POST https://api.mcp.ai/api/posthog/update/desktop/recording` — Update desktop meeting recording details via PATCH. Use to modify meeting title, notes, status, transcripts, or AI-extracted tasks and summaries. Requires desktop_recording:write scope.
  - body: { id: string, notes?: string, status?: string, summary?: string, platform?: string, video_url?: string, project_id: string, started_at?: string, meeting_url?: string, completed_at?: string, participants?: string[], error_message?: string, meeting_title?: string, extracted_tasks?: object[], transcript_text?: string, duration_seconds?: integer, video_size_bytes?: integer, tasks_generated_at?: string, recall_recording_id?: string, transcript_segments?: object[], summary_generated_at?: string }
- `POST https://api.mcp.ai/api/posthog/update/early/access/project/feature` — This PATCH endpoint updates a specific early access project feature. It requires `project_id` and `id` (UUID) as path parameters. The body can include feature details like `name`, `description`, and `
  - body: { id: string, name?: string, stage?: string, created_at?: string, project_id: string, description?: string, documentation_url?: string }
- `POST https://api.mcp.ai/api/posthog/update/endpoint` — Tool to update an existing endpoint for a PostHog project. Use when you need to replace endpoint configuration with new values. All parameters are optional. Pass version in body or ?version=N query pa
  - body: { name: string, query?: object, version?: integer, is_active?: boolean, project_id: string, description?: string, sync_frequency?: string, is_materialized?: boolean, cache_age_seconds?: number, derived_from_insight?: string }
- `POST https://api.mcp.ai/api/posthog/update/error/tracking/autocapture/control` — Tool to fully update an error tracking autocapture control configuration for a PostHog project. Use when you need to replace all settings of an existing autocapture control, including library, sample 
  - body: { id: string, library: string, match_type?: string, project_id: string, sample_rate?: string, url_triggers?: string[], url_blocklist?: string[], event_triggers?: string[], linked_feature_flag?: string|object }
- `POST https://api.mcp.ai/api/posthog/update/evaluation` — Tool to update an existing evaluation in PostHog using PUT request. Use when you need to fully replace an evaluation configuration. For partial updates, consider using the patch_evaluation action inst
  - body: { id: string, name: string, deleted?: boolean, enabled?: boolean, conditions?: object, project_id: string, description?: string, output_type: string, output_config?: object, evaluation_type: string, evaluation_config?: object, model_configuration?: object }
- `POST https://api.mcp.ai/api/posthog/update/event/definition` — Update an event definition by sending a PUT request to '/api/projects/{project_id}/event_definitions/{id}/' using the UUID and project ID, provided you have 'event_definition:write' authorization.
  - body: { id: string, name: string, tags?: string[], project_id: string, post_to_slack?: boolean }
- `POST https://api.mcp.ai/api/posthog/update/experiment` — Update an experiment by sending a PUT request with `project_id` and `id`, including new details as JSON/form data. Changes to name, description, dates, etc., allowed. `experiment:write` permission nee
  - body: { id: integer, name?: string, filters?: string, archived?: boolean, end_date?: string, created_at?: string, parameters?: string, project_id: string, start_date?: string, updated_at?: string, description?: string, exposure_cohort?: integer, feature_flag_key: string, secondary_metrics?: string }
- `POST https://api.mcp.ai/api/posthog/update/experiment/holdout` — Tool to partially update an experiment holdout in a PostHog project. Use when you need to modify a holdout's name, description, or filter configuration. Updates only the fields provided in the request
  - body: { id: integer, name?: string, filters?: object[], project_id: string, description?: string }
- `POST https://api.mcp.ai/api/posthog/update/experiment/holdout/complete` — Tool to fully update an experiment holdout in PostHog using PUT method. Use when you need to replace all holdout configuration including name, description, and filters. All required fields must be pro
  - body: { id: integer, name: string, filters: object[], project_id: string, description?: string }
- `POST https://api.mcp.ai/api/posthog/update/experiment/saved/metric` — Tool to update an existing experiment saved metric in PostHog. Use when you need to modify the name, description, query, or tags of a saved experiment metric. Requires the experiment saved metric ID a
  - body: { id: integer, name: string, tags?: string|integer|object[], query: object, project_id: string, description?: string }
- `POST https://api.mcp.ai/api/posthog/update/external/data/source` — Tool to update an existing external data source in PostHog (e.g., Stripe, Salesforce). Use when you need to modify the description, credentials, or configuration of an external data source. Requires b
  - body: { id: string, account_id: string, job_inputs?: object, project_id: string, description?: string, client_secret: string, revenue_analytics_config?: object }
- `POST https://api.mcp.ai/api/posthog/update/feature/flag` — Manage feature flags for your app with creation, reading, updating, and deletion options. Utilize PostHog's JS library or endpoint for flag status. More info in docs.
  - body: { id: integer, key: string, name?: string, tags?: string[], active?: boolean, deleted?: boolean, filters?: object, surveys?: object, can_edit?: boolean, features?: object, created_at?: string, project_id: string, experiment_set?: integer[], is_simple_flag?: boolean, usage_dashboard?: integer, performed_rollback?: boolean, rollout_percentage?: integer, rollback_conditions?: string, analytics_dashboards?: integer[], has_enriched_analytics?: boolean, ensure_experience_continuity?: boolean }
- `POST https://api.mcp.ai/api/posthog/update/file/system` — Tool to update a file system resource in PostHog by UUID and project ID. Use when you need to modify details of an existing file system resource such as path, type, depth, or metadata.
  - body: { id: string, ref?: string, href?: string, meta?: object, path: string, type?: string, depth?: integer, shortcut?: boolean, created_at: string, project_id: string, last_viewed_at?: string }
- `POST https://api.mcp.ai/api/posthog/update/groups/types/metric` — Tool to update a specific group usage metric by its ID. Use when you need to modify the configuration, filters, display format, name, or calculation interval for a particular metric within a group typ
  - body: { id: string, name: string, format?: string, display?: string, filters: object, interval?: integer, project_id: string, group_type_index: integer }
- `POST https://api.mcp.ai/api/posthog/update/hog/function` — Tool to update a hog function by UUID and project ID using PUT method. Use when you need to modify a hog function with full replacement semantics.
  - body: { id: string, hog?: string, name?: string, type?: string|object, inputs?: object, deleted?: boolean, enabled?: boolean, filters?: object, masking?: object, icon_url?: string, mappings?: object[], project_id: string, description?: string, template_id?: string, inputs_schema?: object[], batch_export_id?: string, execution_order?: integer }
- `POST https://api.mcp.ai/api/posthog/update/insight/variable` — Update an insight variable by replacing all its properties. Use when you need to completely update all fields of an existing insight variable.
  - body: { id: string, name: string, type: string, values?: string|integer|number|boolean|string[]|object, code_name: string, created_at?: string, created_by?: integer, project_id: string, default_value?: string|integer|number|boolean|string[]|object }
- `POST https://api.mcp.ai/api/posthog/update/live/debugger/breakpoint` — Tool to update a live debugger breakpoint for a project. Use when you need to modify breakpoint configuration such as filename, line number, enabled status, or condition.
  - body: { id: string, enabled?: boolean, filename: string, condition?: string, project_id: string, repository?: string, line_number: integer }
- `POST https://api.mcp.ai/api/posthog/update/organization` — Update specific details of an organization using its UUID. Allows PATCH requests with JSON, form data, or multipart. Requires `organization:write` permission. Returns updated organization info.
  - body: { id: string, name?: string, slug?: string, teams?: object[], metadata?: string, created_at?: string, updated_at?: string, customer_id?: string, enforce_2fa?: boolean, member_count?: string, available_product_features?: string[], is_member_join_email_enabled?: boolean }
- `POST https://api.mcp.ai/api/posthog/update/organization/batch/export` — Tool to update an existing organization-level batch export configuration in PostHog. Use when you need to modify batch export settings like name, schedule, destination, or filtering options at the org
  - body: { id: string, name: string, model?: string, end_at?: string, paused?: boolean, schema?: object, filters?: object, interval: string, start_at?: string, timezone?: string, offset_day?: integer, destination: object, hogql_query?: string, offset_hour?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/update/organization/by/uuid` — PUT /api/organizations/{id}/: Update organization details by providing a UUID as 'id'. Supports JSON, form-urlencoded, multipart/form-data. Requires 'organization:write' permission. Returns updated or
  - body: { id: string, name: string, slug?: string, enforce_2fa?: boolean, is_member_join_email_enabled?: boolean }
- `POST https://api.mcp.ai/api/posthog/update/organization/domain` — Update an organization's authentication domain settings, including SAML SSO configuration and user provisioning policies. This action allows you to modify: - Domain name for authentication - Just-in-t
  - body: { id: string, domain: string, saml_acs_url?: string, saml_entity_id?: string, saml_x509_cert?: string, organization_id: string, sso_enforcement?: string, jit_provisioning_enabled?: boolean }
- `POST https://api.mcp.ai/api/posthog/update/organization/member` — Update an organization member's access level and permissions. Use this to promote members to admin/owner or demote them to basic member access. Supports partial updates - only send the fields you want
  - body: { level?: integer, user__uuid: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/update/organization/member/complete` — Update member details in an organization by ID and user UUID. Requires org member write permission. Accepts JSON, form, or multipart. Responses reflect member info, including roles and security settin
  - body: { id: string, joined_at: string, updated_at: string, user__uuid: string, is_2fa_enabled: boolean, has_social_auth: boolean, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/update/organization/proxy/record` — Update an organization's proxy record configuration. Proxy records enable custom domain routing for PostHog analytics to bypass ad blockers. **WARNING**: This endpoint may have server-side issues and 
  - body: { id: string, domain?: string, status?: string, message?: string, created_at?: string, created_by?: integer, updated_at?: string, target_cname?: string, organization_id: string }
- `POST https://api.mcp.ai/api/posthog/update/organization/role` — Update an organization role by submitting its UUID and organization_id in UUID format. Role details must be in JSON or form-data. Only users with 'organization:write' can do this. Returns updated role
  - body: { id: string, name: string, organization_id: string, feature_flags_access_level?: integer }
- `POST https://api.mcp.ai/api/posthog/update/persisted/folder` — Tool to update an existing persisted folder in PostHog. Use when you need to modify folder properties like path, protocol, or type.
  - body: { id: string, path?: string, type: string, protocol?: string, created_at: string, project_id: string, updated_at: string }
- `POST https://api.mcp.ai/api/posthog/update/person/properties` — Request data's "properties" will be updated on a person using "$set" event, affecting only listed properties without deletion or other changes. For property removal, use 'delete_property' endpoint.
  - body: { id: string, name?: string, uuid?: string, format?: string, created_at?: string, project_id: string, properties?: string, distinct_ids?: string[] }
- `POST https://api.mcp.ai/api/posthog/update/person/property` — This endpoint allows for reading and deleting individuals. Use the capture API, `$set` and `$unset` properties, or SDKs for creating or updating persons.
  - body: { id: string, key: string, value: string, format?: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/update/product/tour` — Update an existing product tour in PostHog. Use this to modify tour name, description, targeting, content, and scheduling. Requires project_id and product tour id (UUID).
  - body: { id: string, name: string, content?: object, archived?: boolean, end_date?: string, project_id: string, start_date?: string, auto_launch?: boolean, description?: string, targeting_flag_filters?: object }
- `POST https://api.mcp.ai/api/posthog/update/project/action` — PUT endpoint '/api/projects/{project_id}/actions/{id}/' updates actions in a project by ID, accepts JSON/form data, supports 'format' query, and needs 'action:write' authentication.
  - body: { id: integer, name?: string, tags?: string[], steps?: object[], format?: string, deleted?: boolean, team_id?: integer, is_action?: boolean, created_at?: string, project_id: string, description?: string, post_to_slack?: boolean, bytecode_error?: string, is_calculating?: boolean, last_calculated_at?: string, slack_message_format?: string }
- `POST https://api.mcp.ai/api/posthog/update/project/batch/export` — Tool to update a batch export configuration within a project using PUT method. Use when you need to modify batch export settings like name, destination, interval, or pause status.
  - body: { id: string, name: string, model?: string, end_at?: string, paused: boolean, schema?: object, filters?: object, interval: string, start_at?: string, timezone?: string, offset_day?: integer, project_id: string, destination: object, hogql_query?: string, offset_hour?: integer }
- `POST https://api.mcp.ai/api/posthog/update/project/cohort` — Update cohort details of a specific project by ID. Requires project and cohort ID in the path and a JSON, form-encoded, or multipart form body. Permissions: cohort:write. Returns updated cohort data.
  - body: { id: integer, name?: string, query?: string, groups?: string, deleted?: boolean, filters?: string, is_static?: boolean, project_id: string, description?: string }
- `POST https://api.mcp.ai/api/posthog/update/project/dashboard` — Endpoint to update an existing dashboard within a project. Provide `project_id` and `dashboard_id` in path, send JSON or form data with dashboard details. Requires `dashboard:write` permission; respon
  - body: { id: integer, name?: string, tags?: string[], tiles?: object[], pinned?: boolean, deleted?: boolean, filters?: string, is_shared?: boolean, created_at?: string, project_id: string, description?: string, use_template?: string, use_dashboard?: integer, delete_insights?: boolean }
- `POST https://api.mcp.ai/api/posthog/update/project/early/access/feature` — Update a specific early access feature of a project by providing the `project_id` and feature `id` (UUID). Requires a JSON body with feature details and responds with the updated status. Authenticatio
  - body: { id: string, name: string, stage?: string, project_id: string, description?: string, documentation_url?: string }
- `POST https://api.mcp.ai/api/posthog/update/project/event/definition` — Update an existing event definition for a specified project using its UUID. Requires a project ID and event definition write permissions. Responds without a body on success.
  - body: { id: string, name?: string, tags?: string[], project_id: string, post_to_slack?: boolean }
- `POST https://api.mcp.ai/api/posthog/update/project/group/type` — PATCH /api/projects/{project_id}/groups_types/update_metadata: Update group type metadata for a specific project using its project_id. Can modify name_singular and name_plural fields up to 400 charact
  - body: { group_type?: string, project_id: string, name_plural?: string, name_singular?: string, group_type_index?: integer }
- `POST https://api.mcp.ai/api/posthog/update/project/insight` — Endpoint "/api/projects/{project_id}/insights/{id}/" allows for updating an insight's details for a given project and insight ID, supporting JSON and CSV formats, with fields like name, query, and var
  - body: { id: integer, name?: string, tags?: string[], hogql?: string, order?: integer, query?: string, saved?: boolean, types?: string, format?: string, result?: string, columns?: string, deleted?: boolean, filters?: string, short_id?: string, timezone?: string, favorited?: boolean, is_cached?: string, is_sample?: boolean, created_at?: string, dashboards?: integer[], project_id: string, updated_at?: string, description?: string, derived_name?: string, last_refresh?: string, query_status?: string, dashboard_tiles?: object[], cache_target_age?: string, last_modified_at?: string, next_allowed_client_refresh?: string }
- `POST https://api.mcp.ai/api/posthog/update/project/member` — Update explicit project membership using UUIDs. This PUT endpoint modifies a project member's role, where '1' stands for member and '8' for administrator. Requires `project_id` and `parent_membership_
  - body: { level?: integer, project_id: string, effective_level?: integer, parent__membership__user__uuid: string }
- `POST https://api.mcp.ai/api/posthog/update/project/notebook` — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
  - body: { title?: string, content?: string, deleted?: boolean, version?: integer, short_id: string, project_id: string, text_content?: string }
- `POST https://api.mcp.ai/api/posthog/update/project/property/definition` — Update a property definition in a project by its UUID. Requires a project_id and definition id, both as path parameters. Security: PersonalAPIKeyAuth with write access. No body in the response.
  - body: { id: string, name: string, tags?: string[], project_id: string, property_type?: string }
- `POST https://api.mcp.ai/api/posthog/update/project/session/recording/playlist` — Update an existing session recording playlist for a project with the specified project_id and playlist short_id. Requires JSON or form data input to modify the playlist's properties like name, descrip
  - body: { id: integer, name?: string, pinned?: boolean, deleted?: boolean, filters?: string, short_id: string, created_at: string, project_id: string, description?: string, derived_name?: string, last_modified_at: string }
- `POST https://api.mcp.ai/api/posthog/update/project/settings` — Tool to update project settings and configuration within a PostHog organization. Use when you need to modify project properties such as timezone, feature toggles, or recording settings.
  - body: { id: integer, name?: string, app_urls?: string[], timezone?: string, anonymize_ips?: boolean, surveys_opt_in?: boolean, heatmaps_opt_in?: boolean, inject_web_apps?: boolean, organization_id: string, primary_dashboard?: integer, recording_domains?: string[], autocapture_opt_out?: boolean, product_description?: string, slack_incoming_webhook?: string, session_recording_opt_in?: boolean, capture_console_log_opt_in?: boolean, capture_performance_opt_in?: boolean, completed_snippet_onboarding?: boolean, autocapture_exceptions_opt_in?: boolean, autocapture_web_vitals_opt_in?: boolean, session_recording_sample_rate?: string, person_display_name_properties?: string[], test_account_filters_default_checked?: boolean, session_recording_minimum_duration_milliseconds?: integer }
- `POST https://api.mcp.ai/api/posthog/update/project/subscription` — Update a subscription for a specific project. Provide project_id and subscription id in the path and use MIME types like application/json with fields like frequency, target_type, etc. Requires `subscr
  - body: { id: integer, count?: integer, title?: string, deleted?: boolean, insight?: integer, bysetpos?: integer, interval?: integer, byweekday?: string[], dashboard?: integer, frequency: string, project_id: string, start_date: string, until_date?: string, target_type: string, target_value: string, invite_message?: string }
- `POST https://api.mcp.ai/api/posthog/update/project/survey` — The `/api/projects/{project_id}/surveys/{id}/` PUT endpoint updates survey details in a project using survey UUID and project ID, accepts JSON/form/multipart data, needs `survey:write` permission, and
  - body: { id: string, name: string, type: string, archived?: boolean, end_date?: string, questions?: string, appearance?: string, conditions?: string, created_at?: string, project_id: string, start_date?: string, description?: string, linked_flag_id?: integer, iteration_count?: integer, responses_limit?: integer, current_iteration?: integer, iteration_start_dates?: string[], iteration_frequency_days?: integer, current_iteration_start_date?: string }
- `POST https://api.mcp.ai/api/posthog/update/user/home/settings` — Tool to update user home settings including homepage and tab configurations. Use when you need to modify the personalized home page and tab settings for a user.
  - body: { tabs?: object[], uuid: string, homepage?: object }
- `POST https://api.mcp.ai/api/posthog/update/warehouse/saved/query` — Update a warehouse saved query in PostHog by completely replacing it with new data. Use when you need to update the name, query definition, or edit history of an existing saved query. This performs a 
  - body: { id: string, name: string, query: object, project_id: string, edited_history_id: string }
- `POST https://api.mcp.ai/api/posthog/update/web/experiment` — Tool to completely update a web experiment in PostHog using PUT method. Use when you need to replace the entire web experiment configuration with new values. Unlike PATCH, this requires all fields to 
  - body: { id: integer, name: string, variants: object, project_id: string, feature_flag_key: string }
- `POST https://api.mcp.ai/api/posthog/validate/llm/provider/key` — Tool to validate LLM provider API keys without persisting them to PostHog. Use when you need to verify if an API key for an LLM provider is valid before saving it.
  - body: { api_key: string, provider: string, project_id: string }
- `POST https://api.mcp.ai/api/posthog/whoami` — DEPRECATED: Use POSTHOG_LIST_ALL_PROJECTS_ACROSS_ORGANIZATIONS instead. Diagnostic tool to validate PostHog credentials and retrieve current user information. Returns the authenticated user's profile 

## Example prompts
- "What can I do in PostHog?"
- "Show me a summary of my PostHog account"

## More
- Page: https://mcp.ai/posthog
- Agent spec (llms.txt): https://mcp.ai/posthog/llms.txt
- Postman collection: https://mcp.ai/posthog/postman.json
