@utdk/posthog 1.0.0-20260712.5-dev.e2949a6

package/docs/mcp_server_installations.md

@@ -0,0 +1,970 @@
+# Mcp Server Installations
+
+## Operations
+
+### `posthog.environmentsMcpServerInstallationsList`
+
+- **HTTP**: `GET /api/environments/{environment_id}/mcp_server_installations/`
+- **OpenAPI operationId**: `environments_mcp_server_installations_list`
+- **Path params**: None
+- **Query params**: `limit`, `offset`
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ count: number; next?: string | null; previous?: string | null; results: ({ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?:...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsMcpServerInstallationsListInput = Parameters<typeof posthog.environmentsMcpServerInstallationsList> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsMcpServerInstallationsListOutput = Awaited<ReturnType<typeof posthog.environmentsMcpServerInstallationsList>>;
+
+const result: EnvironmentsMcpServerInstallationsListOutput = await posthog.environmentsMcpServerInstallationsList();
+
+// Result shape (from schema): { count: number; next?: string | null; previous?: string | null; results: ({ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?:...
+```
+
+### `posthog.environmentsMcpServerInstallationsCreate`
+
+- **HTTP**: `POST /api/environments/{environment_id}/mcp_server_installations/`
+- **OpenAPI operationId**: `environments_mcp_server_installations_create`
+- **Path params**: None
+- **Query params**: None
+- **Response codes**: `201`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...`
+- OpenAPI response codes: `201`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsMcpServerInstallationsCreateInput = Parameters<typeof posthog.environmentsMcpServerInstallationsCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsMcpServerInstallationsCreateOutput = Awaited<ReturnType<typeof posthog.environmentsMcpServerInstallationsCreate>>;
+
+const result: EnvironmentsMcpServerInstallationsCreateOutput = await posthog.environmentsMcpServerInstallationsCreate();
+
+// Result shape (from schema): { id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...
+```
+
+### `posthog.environmentsMcpServerInstallationsDestroy`
+
+- **HTTP**: `DELETE /api/environments/{environment_id}/mcp_server_installations/{id}/`
+- **OpenAPI operationId**: `environments_mcp_server_installations_destroy`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `204`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `unknown`
+- OpenAPI response codes: `204`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsMcpServerInstallationsDestroyInput = Parameters<typeof posthog.environmentsMcpServerInstallationsDestroy> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsMcpServerInstallationsDestroyOutput = Awaited<ReturnType<typeof posthog.environmentsMcpServerInstallationsDestroy>>;
+
+const result: EnvironmentsMcpServerInstallationsDestroyOutput = await posthog.environmentsMcpServerInstallationsDestroy();
+
+// Result shape (from schema): unknown
+```
+
+### `posthog.environmentsMcpServerInstallationsRetrieve`
+
+- **HTTP**: `GET /api/environments/{environment_id}/mcp_server_installations/{id}/`
+- **OpenAPI operationId**: `environments_mcp_server_installations_retrieve`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsMcpServerInstallationsRetrieveInput = Parameters<typeof posthog.environmentsMcpServerInstallationsRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsMcpServerInstallationsRetrieveOutput = Awaited<ReturnType<typeof posthog.environmentsMcpServerInstallationsRetrieve>>;
+
+const result: EnvironmentsMcpServerInstallationsRetrieveOutput = await posthog.environmentsMcpServerInstallationsRetrieve();
+
+// Result shape (from schema): { id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...
+```
+
+### `posthog.environmentsMcpServerInstallationsPartialUpdate`
+
+- **HTTP**: `PATCH /api/environments/{environment_id}/mcp_server_installations/{id}/`
+- **OpenAPI operationId**: `environments_mcp_server_installations_partial_update`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsMcpServerInstallationsPartialUpdateInput = Parameters<typeof posthog.environmentsMcpServerInstallationsPartialUpdate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsMcpServerInstallationsPartialUpdateOutput = Awaited<ReturnType<typeof posthog.environmentsMcpServerInstallationsPartialUpdate>>;
+
+const result: EnvironmentsMcpServerInstallationsPartialUpdateOutput = await posthog.environmentsMcpServerInstallationsPartialUpdate();
+
+// Result shape (from schema): { id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...
+```
+
+### `posthog.environmentsMcpServerInstallationsUpdate`
+
+- **HTTP**: `PUT /api/environments/{environment_id}/mcp_server_installations/{id}/`
+- **OpenAPI operationId**: `environments_mcp_server_installations_update`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsMcpServerInstallationsUpdateInput = Parameters<typeof posthog.environmentsMcpServerInstallationsUpdate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsMcpServerInstallationsUpdateOutput = Awaited<ReturnType<typeof posthog.environmentsMcpServerInstallationsUpdate>>;
+
+const result: EnvironmentsMcpServerInstallationsUpdateOutput = await posthog.environmentsMcpServerInstallationsUpdate();
+
+// Result shape (from schema): { id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...
+```
+
+### `posthog.environmentsMcpServerInstallationsProxyCreate`
+
+- **HTTP**: `POST /api/environments/{environment_id}/mcp_server_installations/{id}/proxy/`
+- **OpenAPI operationId**: `environments_mcp_server_installations_proxy_create`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsMcpServerInstallationsProxyCreateInput = Parameters<typeof posthog.environmentsMcpServerInstallationsProxyCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsMcpServerInstallationsProxyCreateOutput = Awaited<ReturnType<typeof posthog.environmentsMcpServerInstallationsProxyCreate>>;
+
+const result: EnvironmentsMcpServerInstallationsProxyCreateOutput = await posthog.environmentsMcpServerInstallationsProxyCreate();
+
+// Result shape (from schema): { id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...
+```
+
+### `posthog.environmentsMcpServerInstallationsShareCreate`
+
+- **HTTP**: `POST /api/environments/{environment_id}/mcp_server_installations/{id}/share/`
+- **What it does**: Escalate a personal installation to a team-wide shared one.
+
+Owner-only AND admin-only: sharing exposes the owner's credential to
+every project member and all autonomous agents, so it carries the same
+gate as creating a shared install outright.
+- **OpenAPI operationId**: `environments_mcp_server_installations_share_create`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsMcpServerInstallationsShareCreateInput = Parameters<typeof posthog.environmentsMcpServerInstallationsShareCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsMcpServerInstallationsShareCreateOutput = Awaited<ReturnType<typeof posthog.environmentsMcpServerInstallationsShareCreate>>;
+
+const result: EnvironmentsMcpServerInstallationsShareCreateOutput = await posthog.environmentsMcpServerInstallationsShareCreate();
+
+// Result shape (from schema): { id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...
+```
+
+### `posthog.environmentsMcpServerInstallationsToolsRetrieve`
+
+- **HTTP**: `GET /api/environments/{environment_id}/mcp_server_installations/{id}/tools/`
+- **OpenAPI operationId**: `environments_mcp_server_installations_tools_retrieve`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ count: number; next?: string | null; previous?: string | null; results: ({ id: string; tool_name: string; display_name: string; description: string; input_schema: unknown; approval_state?: "approved" | "needs_approval...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsMcpServerInstallationsToolsRetrieveInput = Parameters<typeof posthog.environmentsMcpServerInstallationsToolsRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsMcpServerInstallationsToolsRetrieveOutput = Awaited<ReturnType<typeof posthog.environmentsMcpServerInstallationsToolsRetrieve>>;
+
+const result: EnvironmentsMcpServerInstallationsToolsRetrieveOutput = await posthog.environmentsMcpServerInstallationsToolsRetrieve();
+
+// Result shape (from schema): { count: number; next?: string | null; previous?: string | null; results: ({ id: string; tool_name: string; display_name: string; description: string; input_schema: unknown; approval_state?: "approved" | "needs_approval...
+```
+
+### `posthog.environmentsMcpServerInstallationsToolsPartialUpdate`
+
+- **HTTP**: `PATCH /api/environments/{environment_id}/mcp_server_installations/{id}/tools/{tool_name}/`
+- **OpenAPI operationId**: `environments_mcp_server_installations_tools_partial_update`
+- **Path params**: `id`, `tool_name`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; tool_name: string; display_name: string; description: string; input_schema: unknown; approval_state?: "approved" | "needs_approval" | "do_not_use"; last_seen_at: string; removed_at: string | null; created_...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsMcpServerInstallationsToolsPartialUpdateInput = Parameters<typeof posthog.environmentsMcpServerInstallationsToolsPartialUpdate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsMcpServerInstallationsToolsPartialUpdateOutput = Awaited<ReturnType<typeof posthog.environmentsMcpServerInstallationsToolsPartialUpdate>>;
+
+const result: EnvironmentsMcpServerInstallationsToolsPartialUpdateOutput = await posthog.environmentsMcpServerInstallationsToolsPartialUpdate();
+
+// Result shape (from schema): { id: string; tool_name: string; display_name: string; description: string; input_schema: unknown; approval_state?: "approved" | "needs_approval" | "do_not_use"; last_seen_at: string; removed_at: string | null; created_...
+```
+
+### `posthog.environmentsMcpServerInstallationsToolsRefreshCreate`
+
+- **HTTP**: `POST /api/environments/{environment_id}/mcp_server_installations/{id}/tools/refresh/`
+- **OpenAPI operationId**: `environments_mcp_server_installations_tools_refresh_create`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ count: number; next?: string | null; previous?: string | null; results: ({ id: string; tool_name: string; display_name: string; description: string; input_schema: unknown; approval_state?: "approved" | "needs_approval...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsMcpServerInstallationsToolsRefreshCreateInput = Parameters<typeof posthog.environmentsMcpServerInstallationsToolsRefreshCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsMcpServerInstallationsToolsRefreshCreateOutput = Awaited<ReturnType<typeof posthog.environmentsMcpServerInstallationsToolsRefreshCreate>>;
+
+const result: EnvironmentsMcpServerInstallationsToolsRefreshCreateOutput = await posthog.environmentsMcpServerInstallationsToolsRefreshCreate();
+
+// Result shape (from schema): { count: number; next?: string | null; previous?: string | null; results: ({ id: string; tool_name: string; display_name: string; description: string; input_schema: unknown; approval_state?: "approved" | "needs_approval...
+```
+
+### `posthog.environmentsMcpServerInstallationsUnshareCreate`
+
+- **HTTP**: `POST /api/environments/{environment_id}/mcp_server_installations/{id}/unshare/`
+- **What it does**: De-escalate a shared installation back to personal.
+
+Allowed for the credential owner OR a project admin (the reclaim path
+for shared credentials). The row always stays owned by the ORIGINAL
+owner — an admin unsharing someone else's install must not capture
+their credential.
+- **OpenAPI operationId**: `environments_mcp_server_installations_unshare_create`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsMcpServerInstallationsUnshareCreateInput = Parameters<typeof posthog.environmentsMcpServerInstallationsUnshareCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsMcpServerInstallationsUnshareCreateOutput = Awaited<ReturnType<typeof posthog.environmentsMcpServerInstallationsUnshareCreate>>;
+
+const result: EnvironmentsMcpServerInstallationsUnshareCreateOutput = await posthog.environmentsMcpServerInstallationsUnshareCreate();
+
+// Result shape (from schema): { id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...
+```
+
+### `posthog.environmentsMcpServerInstallationsAuthorizeRetrieve`
+
+- **HTTP**: `GET /api/environments/{environment_id}/mcp_server_installations/authorize/`
+- **What it does**: Start (or re-start) an OAuth flow.
+
+Pass ``template_id`` to (re)connect a catalog template, or
+``installation_id`` to reconnect an existing custom install using its
+cached metadata and per-user DCR creds.
+- **OpenAPI operationId**: `environments_mcp_server_installations_authorize_retrieve`
+- **Path params**: None
+- **Query params**: `install_source`, `installation_id`, `posthog_code_callback_url`, `template_id`
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `unknown`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsMcpServerInstallationsAuthorizeRetrieveInput = Parameters<typeof posthog.environmentsMcpServerInstallationsAuthorizeRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsMcpServerInstallationsAuthorizeRetrieveOutput = Awaited<ReturnType<typeof posthog.environmentsMcpServerInstallationsAuthorizeRetrieve>>;
+
+const result: EnvironmentsMcpServerInstallationsAuthorizeRetrieveOutput = await posthog.environmentsMcpServerInstallationsAuthorizeRetrieve();
+
+// Result shape (from schema): unknown
+```
+
+### `posthog.environmentsMcpServerInstallationsInstallCustomCreate`
+
+- **HTTP**: `POST /api/environments/{environment_id}/mcp_server_installations/install_custom/`
+- **OpenAPI operationId**: `environments_mcp_server_installations_install_custom_create`
+- **Path params**: None
+- **Query params**: None
+- **Response codes**: `200`, `201`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ redirect_url: string }`
+- OpenAPI response codes: `200`, `201`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsMcpServerInstallationsInstallCustomCreateInput = Parameters<typeof posthog.environmentsMcpServerInstallationsInstallCustomCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsMcpServerInstallationsInstallCustomCreateOutput = Awaited<ReturnType<typeof posthog.environmentsMcpServerInstallationsInstallCustomCreate>>;
+
+const result: EnvironmentsMcpServerInstallationsInstallCustomCreateOutput = await posthog.environmentsMcpServerInstallationsInstallCustomCreate();
+
+// Result shape (from schema): { redirect_url: string }
+```
+
+### `posthog.environmentsMcpServerInstallationsInstallTemplateCreate`
+
+- **HTTP**: `POST /api/environments/{environment_id}/mcp_server_installations/install_template/`
+- **OpenAPI operationId**: `environments_mcp_server_installations_install_template_create`
+- **Path params**: None
+- **Query params**: None
+- **Response codes**: `200`, `201`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ redirect_url: string }`
+- OpenAPI response codes: `200`, `201`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type EnvironmentsMcpServerInstallationsInstallTemplateCreateInput = Parameters<typeof posthog.environmentsMcpServerInstallationsInstallTemplateCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type EnvironmentsMcpServerInstallationsInstallTemplateCreateOutput = Awaited<ReturnType<typeof posthog.environmentsMcpServerInstallationsInstallTemplateCreate>>;
+
+const result: EnvironmentsMcpServerInstallationsInstallTemplateCreateOutput = await posthog.environmentsMcpServerInstallationsInstallTemplateCreate();
+
+// Result shape (from schema): { redirect_url: string }
+```
+
+### `posthog.mcpServerInstallationsList`
+
+- **HTTP**: `GET /api/projects/{project_id}/mcp_server_installations/`
+- **OpenAPI operationId**: `mcp_server_installations_list`
+- **Path params**: None
+- **Query params**: `limit`, `offset`
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ count: number; next?: string | null; previous?: string | null; results: ({ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?:...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type McpServerInstallationsListInput = Parameters<typeof posthog.mcpServerInstallationsList> extends [infer T, ...unknown[]] ? T : undefined;
+type McpServerInstallationsListOutput = Awaited<ReturnType<typeof posthog.mcpServerInstallationsList>>;
+
+const result: McpServerInstallationsListOutput = await posthog.mcpServerInstallationsList();
+
+// Result shape (from schema): { count: number; next?: string | null; previous?: string | null; results: ({ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?:...
+```
+
+### `posthog.mcpServerInstallationsCreate`
+
+- **HTTP**: `POST /api/projects/{project_id}/mcp_server_installations/`
+- **OpenAPI operationId**: `mcp_server_installations_create`
+- **Path params**: None
+- **Query params**: None
+- **Response codes**: `201`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...`
+- OpenAPI response codes: `201`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type McpServerInstallationsCreateInput = Parameters<typeof posthog.mcpServerInstallationsCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type McpServerInstallationsCreateOutput = Awaited<ReturnType<typeof posthog.mcpServerInstallationsCreate>>;
+
+const result: McpServerInstallationsCreateOutput = await posthog.mcpServerInstallationsCreate();
+
+// Result shape (from schema): { id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...
+```
+
+### `posthog.mcpServerInstallationsDestroy`
+
+- **HTTP**: `DELETE /api/projects/{project_id}/mcp_server_installations/{id}/`
+- **OpenAPI operationId**: `mcp_server_installations_destroy`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `204`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `unknown`
+- OpenAPI response codes: `204`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type McpServerInstallationsDestroyInput = Parameters<typeof posthog.mcpServerInstallationsDestroy> extends [infer T, ...unknown[]] ? T : undefined;
+type McpServerInstallationsDestroyOutput = Awaited<ReturnType<typeof posthog.mcpServerInstallationsDestroy>>;
+
+const result: McpServerInstallationsDestroyOutput = await posthog.mcpServerInstallationsDestroy();
+
+// Result shape (from schema): unknown
+```
+
+### `posthog.mcpServerInstallationsRetrieve`
+
+- **HTTP**: `GET /api/projects/{project_id}/mcp_server_installations/{id}/`
+- **OpenAPI operationId**: `mcp_server_installations_retrieve`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type McpServerInstallationsRetrieveInput = Parameters<typeof posthog.mcpServerInstallationsRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type McpServerInstallationsRetrieveOutput = Awaited<ReturnType<typeof posthog.mcpServerInstallationsRetrieve>>;
+
+const result: McpServerInstallationsRetrieveOutput = await posthog.mcpServerInstallationsRetrieve();
+
+// Result shape (from schema): { id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...
+```
+
+### `posthog.mcpServerInstallationsPartialUpdate`
+
+- **HTTP**: `PATCH /api/projects/{project_id}/mcp_server_installations/{id}/`
+- **OpenAPI operationId**: `mcp_server_installations_partial_update`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type McpServerInstallationsPartialUpdateInput = Parameters<typeof posthog.mcpServerInstallationsPartialUpdate> extends [infer T, ...unknown[]] ? T : undefined;
+type McpServerInstallationsPartialUpdateOutput = Awaited<ReturnType<typeof posthog.mcpServerInstallationsPartialUpdate>>;
+
+const result: McpServerInstallationsPartialUpdateOutput = await posthog.mcpServerInstallationsPartialUpdate();
+
+// Result shape (from schema): { id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...
+```
+
+### `posthog.mcpServerInstallationsUpdate`
+
+- **HTTP**: `PUT /api/projects/{project_id}/mcp_server_installations/{id}/`
+- **OpenAPI operationId**: `mcp_server_installations_update`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type McpServerInstallationsUpdateInput = Parameters<typeof posthog.mcpServerInstallationsUpdate> extends [infer T, ...unknown[]] ? T : undefined;
+type McpServerInstallationsUpdateOutput = Awaited<ReturnType<typeof posthog.mcpServerInstallationsUpdate>>;
+
+const result: McpServerInstallationsUpdateOutput = await posthog.mcpServerInstallationsUpdate();
+
+// Result shape (from schema): { id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...
+```
+
+### `posthog.mcpServerInstallationsProxyCreate`
+
+- **HTTP**: `POST /api/projects/{project_id}/mcp_server_installations/{id}/proxy/`
+- **OpenAPI operationId**: `mcp_server_installations_proxy_create`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type McpServerInstallationsProxyCreateInput = Parameters<typeof posthog.mcpServerInstallationsProxyCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type McpServerInstallationsProxyCreateOutput = Awaited<ReturnType<typeof posthog.mcpServerInstallationsProxyCreate>>;
+
+const result: McpServerInstallationsProxyCreateOutput = await posthog.mcpServerInstallationsProxyCreate();
+
+// Result shape (from schema): { id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...
+```
+
+### `posthog.mcpServerInstallationsShareCreate`
+
+- **HTTP**: `POST /api/projects/{project_id}/mcp_server_installations/{id}/share/`
+- **What it does**: Escalate a personal installation to a team-wide shared one.
+
+Owner-only AND admin-only: sharing exposes the owner's credential to
+every project member and all autonomous agents, so it carries the same
+gate as creating a shared install outright.
+- **OpenAPI operationId**: `mcp_server_installations_share_create`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type McpServerInstallationsShareCreateInput = Parameters<typeof posthog.mcpServerInstallationsShareCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type McpServerInstallationsShareCreateOutput = Awaited<ReturnType<typeof posthog.mcpServerInstallationsShareCreate>>;
+
+const result: McpServerInstallationsShareCreateOutput = await posthog.mcpServerInstallationsShareCreate();
+
+// Result shape (from schema): { id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...
+```
+
+### `posthog.mcpServerInstallationsToolsRetrieve`
+
+- **HTTP**: `GET /api/projects/{project_id}/mcp_server_installations/{id}/tools/`
+- **OpenAPI operationId**: `mcp_server_installations_tools_retrieve`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ count: number; next?: string | null; previous?: string | null; results: ({ id: string; tool_name: string; display_name: string; description: string; input_schema: unknown; approval_state?: "approved" | "needs_approval...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type McpServerInstallationsToolsRetrieveInput = Parameters<typeof posthog.mcpServerInstallationsToolsRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type McpServerInstallationsToolsRetrieveOutput = Awaited<ReturnType<typeof posthog.mcpServerInstallationsToolsRetrieve>>;
+
+const result: McpServerInstallationsToolsRetrieveOutput = await posthog.mcpServerInstallationsToolsRetrieve();
+
+// Result shape (from schema): { count: number; next?: string | null; previous?: string | null; results: ({ id: string; tool_name: string; display_name: string; description: string; input_schema: unknown; approval_state?: "approved" | "needs_approval...
+```
+
+### `posthog.mcpServerInstallationsToolsPartialUpdate`
+
+- **HTTP**: `PATCH /api/projects/{project_id}/mcp_server_installations/{id}/tools/{tool_name}/`
+- **OpenAPI operationId**: `mcp_server_installations_tools_partial_update`
+- **Path params**: `id`, `tool_name`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; tool_name: string; display_name: string; description: string; input_schema: unknown; approval_state?: "approved" | "needs_approval" | "do_not_use"; last_seen_at: string; removed_at: string | null; created_...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type McpServerInstallationsToolsPartialUpdateInput = Parameters<typeof posthog.mcpServerInstallationsToolsPartialUpdate> extends [infer T, ...unknown[]] ? T : undefined;
+type McpServerInstallationsToolsPartialUpdateOutput = Awaited<ReturnType<typeof posthog.mcpServerInstallationsToolsPartialUpdate>>;
+
+const result: McpServerInstallationsToolsPartialUpdateOutput = await posthog.mcpServerInstallationsToolsPartialUpdate();
+
+// Result shape (from schema): { id: string; tool_name: string; display_name: string; description: string; input_schema: unknown; approval_state?: "approved" | "needs_approval" | "do_not_use"; last_seen_at: string; removed_at: string | null; created_...
+```
+
+### `posthog.mcpServerInstallationsToolsRefreshCreate`
+
+- **HTTP**: `POST /api/projects/{project_id}/mcp_server_installations/{id}/tools/refresh/`
+- **OpenAPI operationId**: `mcp_server_installations_tools_refresh_create`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ count: number; next?: string | null; previous?: string | null; results: ({ id: string; tool_name: string; display_name: string; description: string; input_schema: unknown; approval_state?: "approved" | "needs_approval...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type McpServerInstallationsToolsRefreshCreateInput = Parameters<typeof posthog.mcpServerInstallationsToolsRefreshCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type McpServerInstallationsToolsRefreshCreateOutput = Awaited<ReturnType<typeof posthog.mcpServerInstallationsToolsRefreshCreate>>;
+
+const result: McpServerInstallationsToolsRefreshCreateOutput = await posthog.mcpServerInstallationsToolsRefreshCreate();
+
+// Result shape (from schema): { count: number; next?: string | null; previous?: string | null; results: ({ id: string; tool_name: string; display_name: string; description: string; input_schema: unknown; approval_state?: "approved" | "needs_approval...
+```
+
+### `posthog.mcpServerInstallationsUnshareCreate`
+
+- **HTTP**: `POST /api/projects/{project_id}/mcp_server_installations/{id}/unshare/`
+- **What it does**: De-escalate a shared installation back to personal.
+
+Allowed for the credential owner OR a project admin (the reclaim path
+for shared credentials). The row always stays owned by the ORIGINAL
+owner — an admin unsharing someone else's install must not capture
+their credential.
+- **OpenAPI operationId**: `mcp_server_installations_unshare_create`
+- **Path params**: `id`
+- **Query params**: None
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type McpServerInstallationsUnshareCreateInput = Parameters<typeof posthog.mcpServerInstallationsUnshareCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type McpServerInstallationsUnshareCreateOutput = Awaited<ReturnType<typeof posthog.mcpServerInstallationsUnshareCreate>>;
+
+const result: McpServerInstallationsUnshareCreateOutput = await posthog.mcpServerInstallationsUnshareCreate();
+
+// Result shape (from schema): { id: string; template_id: string | null; name: string; icon_key: string; display_name?: string; url?: string; description?: string; auth_type?: "api_key" | "oauth"; is_enabled?: boolean; scope: "personal" | "shared"; i...
+```
+
+### `posthog.mcpServerInstallationsAuthorizeRetrieve`
+
+- **HTTP**: `GET /api/projects/{project_id}/mcp_server_installations/authorize/`
+- **What it does**: Start (or re-start) an OAuth flow.
+
+Pass ``template_id`` to (re)connect a catalog template, or
+``installation_id`` to reconnect an existing custom install using its
+cached metadata and per-user DCR creds.
+- **OpenAPI operationId**: `mcp_server_installations_authorize_retrieve`
+- **Path params**: None
+- **Query params**: `install_source`, `installation_id`, `posthog_code_callback_url`, `template_id`
+- **Response codes**: `200`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `unknown`
+- OpenAPI response codes: `200`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type McpServerInstallationsAuthorizeRetrieveInput = Parameters<typeof posthog.mcpServerInstallationsAuthorizeRetrieve> extends [infer T, ...unknown[]] ? T : undefined;
+type McpServerInstallationsAuthorizeRetrieveOutput = Awaited<ReturnType<typeof posthog.mcpServerInstallationsAuthorizeRetrieve>>;
+
+const result: McpServerInstallationsAuthorizeRetrieveOutput = await posthog.mcpServerInstallationsAuthorizeRetrieve();
+
+// Result shape (from schema): unknown
+```
+
+### `posthog.mcpServerInstallationsInstallCustomCreate`
+
+- **HTTP**: `POST /api/projects/{project_id}/mcp_server_installations/install_custom/`
+- **OpenAPI operationId**: `mcp_server_installations_install_custom_create`
+- **Path params**: None
+- **Query params**: None
+- **Response codes**: `200`, `201`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ redirect_url: string }`
+- OpenAPI response codes: `200`, `201`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type McpServerInstallationsInstallCustomCreateInput = Parameters<typeof posthog.mcpServerInstallationsInstallCustomCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type McpServerInstallationsInstallCustomCreateOutput = Awaited<ReturnType<typeof posthog.mcpServerInstallationsInstallCustomCreate>>;
+
+const result: McpServerInstallationsInstallCustomCreateOutput = await posthog.mcpServerInstallationsInstallCustomCreate();
+
+// Result shape (from schema): { redirect_url: string }
+```
+
+### `posthog.mcpServerInstallationsInstallTemplateCreate`
+
+- **HTTP**: `POST /api/projects/{project_id}/mcp_server_installations/install_template/`
+- **OpenAPI operationId**: `mcp_server_installations_install_template_create`
+- **Path params**: None
+- **Query params**: None
+- **Response codes**: `200`, `201`
+- **Transport options**: None
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ [key: string]: unknown }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ redirect_url: string }`
+- OpenAPI response codes: `200`, `201`
+
+```ts
+import posthog from "@utdk/posthog";
+
+type McpServerInstallationsInstallTemplateCreateInput = Parameters<typeof posthog.mcpServerInstallationsInstallTemplateCreate> extends [infer T, ...unknown[]] ? T : undefined;
+type McpServerInstallationsInstallTemplateCreateOutput = Awaited<ReturnType<typeof posthog.mcpServerInstallationsInstallTemplateCreate>>;
+
+const result: McpServerInstallationsInstallTemplateCreateOutput = await posthog.mcpServerInstallationsInstallTemplateCreate();
+
+// Result shape (from schema): { redirect_url: string }
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->