:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
// AUTO-GENERATED from products/actions/mcp/tools.yaml + OpenAPI — do not edit
import { z } from 'zod'
import type { Schemas } from '@/api/generated'
import * as orvalSchemas from '@/generated/actions/api'
import { withUiApp } from '@/resources/ui-apps'
import { castStringToInt } from '@/tools/cast-helpers'
import { withPostHogUrl, type WithPostHogUrl } from '@/tools/tool-utils'
import type { Context, ToolBase, ZodObjectAny } from '@/tools/types'
const ActionCreateSchema = () => {
const ActionsCreateBody = orvalSchemas.ActionsCreateBody()
return ActionsCreateBody.omit({ _create_in_folder: true }).extend({
name: ActionsCreateBody.shape['name'].describe('Name of the action (must be unique within the project)'),
})
}
const actionCreate = (): ToolBase<ReturnType<typeof ActionCreateSchema>, WithPostHogUrl<Schemas.Action>> =>
withUiApp('action', {
name: 'action-create',
schema: ActionCreateSchema(),
handler: async (context: Context, params: z.infer<ReturnType<typeof ActionCreateSchema>>) => {
const projectId = await context.stateManager.getProjectId()
const body: Record<string, unknown> = {}
if (params.name !== undefined) {
body['name'] = params.name
}
if (params.description !== undefined) {
body['description'] = params.description
}
if (params.tags !== undefined) {
body['tags'] = params.tags
}
if (params.post_to_slack !== undefined) {
body['post_to_slack'] = params.post_to_slack
}
if (params.slack_message_format !== undefined) {
body['slack_message_format'] = params.slack_message_format
}
if (params.steps !== undefined) {
body['steps'] = params.steps
}
if (params.pinned_at !== undefined) {
body['pinned_at'] = params.pinned_at
}
const result = await context.api.request<Schemas.Action>({
method: 'POST',
path: `/api/projects/${encodeURIComponent(String(projectId))}/actions/`,
body,
})
return await withPostHogUrl(context, result, `/data-management/actions/${result.id}`)
},
})
const ActionDeleteSchema = () => {
const ActionsDestroyParams = orvalSchemas.ActionsDestroyParams()
return ActionsDestroyParams.omit({ project_id: true })
}
const actionDelete = (): ToolBase<ReturnType<typeof ActionDeleteSchema>, Schemas.Action> => ({
name: 'action-delete',
schema: ActionDeleteSchema(),
handler: async (context: Context, params: z.infer<ReturnType<typeof ActionDeleteSchema>>) => {
const projectId = await context.stateManager.getProjectId()
const result = await context.api.request<Schemas.Action>({
method: 'PATCH',
path: `/api/projects/${encodeURIComponent(String(projectId))}/actions/${encodeURIComponent(String(params.id))}/`,
body: { deleted: true },
})
return result
},
})
const ActionGetSchema = () => {
const ActionsRetrieveParams = orvalSchemas.ActionsRetrieveParams()
return ActionsRetrieveParams.omit({ project_id: true }).extend({
id: z.preprocess(castStringToInt, ActionsRetrieveParams.shape['id']),
})
}
const actionGet = (): ToolBase<ReturnType<typeof ActionGetSchema>, WithPostHogUrl<Schemas.Action>> =>
withUiApp('action', {
name: 'action-get',
schema: ActionGetSchema(),
handler: async (context: Context, params: z.infer<ReturnType<typeof ActionGetSchema>>) => {
const projectId = await context.stateManager.getProjectId()
const result = await context.api.request<Schemas.Action>({
method: 'GET',
path: `/api/projects/${encodeURIComponent(String(projectId))}/actions/${encodeURIComponent(String(params.id))}/`,
})
return await withPostHogUrl(context, result, `/data-management/actions/${result.id}`)
},
})
const ActionUpdateSchema = () => {
const ActionsPartialUpdateBody = orvalSchemas.ActionsPartialUpdateBody()
const ActionsPartialUpdateParams = orvalSchemas.ActionsPartialUpdateParams()
return ActionsPartialUpdateParams.omit({ project_id: true }).extend(
ActionsPartialUpdateBody.omit({ _create_in_folder: true }).shape
)
}
const actionUpdate = (): ToolBase<ReturnType<typeof ActionUpdateSchema>, WithPostHogUrl<Schemas.Action>> =>
withUiApp('action', {
name: 'action-update',
schema: ActionUpdateSchema(),
handler: async (context: Context, params: z.infer<ReturnType<typeof ActionUpdateSchema>>) => {
const projectId = await context.stateManager.getProjectId()
const body: Record<string, unknown> = {}
if (params.name !== undefined) {
body['name'] = params.name
}
if (params.description !== undefined) {
body['description'] = params.description
}
if (params.tags !== undefined) {
body['tags'] = params.tags
}
if (params.post_to_slack !== undefined) {
body['post_to_slack'] = params.post_to_slack
}
if (params.slack_message_format !== undefined) {
body['slack_message_format'] = params.slack_message_format
}
if (params.steps !== undefined) {
body['steps'] = params.steps
}
if (params.pinned_at !== undefined) {
body['pinned_at'] = params.pinned_at
}
const result = await context.api.request<Schemas.Action>({
method: 'PATCH',
path: `/api/projects/${encodeURIComponent(String(projectId))}/actions/${encodeURIComponent(String(params.id))}/`,
body,
})
return await withPostHogUrl(context, result, `/data-management/actions/${result.id}`)
},
})
const ActionsGetAllSchema = () => {
const ActionsListQueryParams = orvalSchemas.ActionsListQueryParams()
return ActionsListQueryParams.omit({ format: true })
}
const actionsGetAll = (): ToolBase<
ReturnType<typeof ActionsGetAllSchema>,
WithPostHogUrl<Schemas.ActionListResponse>
> =>
withUiApp('action-list', {
name: 'actions-get-all',
schema: ActionsGetAllSchema(),
handler: async (context: Context, params: z.infer<ReturnType<typeof ActionsGetAllSchema>>) => {
const projectId = await context.stateManager.getProjectId()
const result = await context.api.request<Schemas.ActionListResponse>({
method: 'GET',
path: `/api/projects/${encodeURIComponent(String(projectId))}/actions/`,
query: {
created_by: params.created_by,
limit: params.limit,
offset: params.offset,
ordering: params.ordering,
search: params.search,
tags: params.tags,
},
})
return await withPostHogUrl(
context,
{
...result,
results: await Promise.all(
(result.results ?? []).map((item) =>
withPostHogUrl(context, item, `/data-management/actions/${item.id}`)
)
),
},
'/data-management/actions'
)
},
})
export const GENERATED_TOOLS: Record<string, () => ToolBase<ZodObjectAny>> = {
'action-create': actionCreate,
'action-delete': actionDelete,
'action-get': actionGet,
'action-update': actionUpdate,
'actions-get-all': actionsGetAll,
}