Files
zeekay bc4ddf332b chore: rebase the tree onto upstream master fa1a9a60
Mechanically re-derived: bin/debrand runs over a fresh import of
posthog/posthog@fa1a9a60d4 (2026-08-06).
The pipeline (.hanzo/workflows), the Dockerfiles and bin/docker*
entrypoints, compose files, LLM.md and the squashed initial migration
are restored from the shipped tree, same as the previous import.

The prune's import-closure guard kept 21 products the new core now
imports; dropping them is a refactor now, recorded rather than forced.
2026-08-06 01:25:36 -07:00

599 lines
22 KiB
YAML

# MCP tool definition — tool entries are scaffolded from the OpenAPI schema.
# The tool list and operation IDs are kept in sync automatically:
# pnpm --filter=@hanzo/mcp run scaffold-yaml -- --sync-all
#
# To enable a tool, set enabled: true and add required scopes + annotations.
# All other fields (title, description, enrich_url, etc.) are yours to configure.
category: Core
feature: core
url_prefix: /
ui_apps:
debug:
type: custom
app_name: MCP Apps Debug
description: Debug app for testing MCP Apps SDK integration
query-results:
type: custom
app_name: Query Results
description: Interactive visualization for Insights query results
render_ui:
component_import: ../components/Component
view_component: Component
view_prop: data
render-ui:
type: custom
app_name: Insights Render UI
description: Renders the visualization for a Insights MCP tool result
tools:
activity-retrieve:
operation: organizations_projects_activity_retrieve
enabled: false
add-product-intent-partial-update:
operation: organizations_projects_add_product_intent_partial_update
enabled: false
change-organization-create:
operation: organizations_projects_change_organization_create
enabled: false
cimd-verification-tokens-create:
operation: cimd_verification_tokens_create
enabled: false
cimd-verification-tokens-destroy:
operation: cimd_verification_tokens_destroy
enabled: false
cimd-verification-tokens-list:
operation: cimd_verification_tokens_list
enabled: false
cimd-verification-tokens-retrieve:
operation: cimd_verification_tokens_retrieve
enabled: false
complete-product-onboarding-partial-update:
operation: organizations_projects_complete_product_onboarding_partial_update
enabled: false
dashboards-sharing-list:
operation: dashboards_sharing_list
enabled: false
dashboards-sharing-passwords-create:
operation: dashboards_sharing_passwords_create
enabled: false
dashboards-sharing-passwords-destroy:
operation: dashboards_sharing_passwords_destroy
enabled: false
dashboards-sharing-refresh-create:
operation: dashboards_sharing_refresh_create
enabled: false
delete-secret-token-backup-partial-update:
operation: organizations_projects_delete_secret_token_backup_partial_update
enabled: false
domains-create:
operation: domains_create
enabled: false
domains-destroy:
operation: domains_destroy
enabled: false
domains-list:
operation: domains_list
enabled: false
domains-partial-update:
operation: domains_partial_update
enabled: false
domains-retrieve:
operation: domains_retrieve
enabled: false
domains-scim-logs-retrieve:
operation: domains_scim_logs_retrieve
enabled: false
domains-update:
operation: domains_update
enabled: false
domains-verify-create:
operation: domains_verify_create
enabled: false
exports-content-retrieve:
operation: exports_content_retrieve
enabled: false
exports-create:
operation: exports_create
enabled: false
exports-list:
operation: exports_list
enabled: false
exports-retrieve:
operation: exports_retrieve
enabled: false
file-system-count-by-path-create:
operation: file_system_count_by_path_create
enabled: false
file-system-count-create:
operation: file_system_count_create
enabled: false
file-system-create:
operation: file_system_create
enabled: false
file-system-destroy:
operation: file_system_destroy
enabled: false
file-system-link-create:
operation: file_system_link_create
enabled: false
file-system-list:
operation: file_system_list
enabled: false
file-system-log-view-create:
operation: file_system_log_view_create
enabled: false
file-system-log-view-retrieve:
operation: file_system_log_view_retrieve
enabled: false
file-system-move-create:
operation: file_system_move_create
enabled: false
file-system-partial-update:
operation: file_system_partial_update
enabled: false
file-system-retrieve:
operation: file_system_retrieve
enabled: false
file-system-shortcut-create:
operation: file_system_shortcut_create
enabled: false
file-system-shortcut-destroy:
operation: file_system_shortcut_destroy
enabled: false
file-system-shortcut-list:
operation: file_system_shortcut_list
enabled: false
file-system-shortcut-partial-update:
operation: file_system_shortcut_partial_update
enabled: false
file-system-shortcut-reorder-create:
operation: file_system_shortcut_reorder_create
enabled: false
file-system-shortcut-retrieve:
operation: file_system_shortcut_retrieve
enabled: false
file-system-shortcut-update:
operation: file_system_shortcut_update
enabled: false
file-system-undo-delete-create:
operation: file_system_undo_delete_create
enabled: false
file-system-unfiled-retrieve:
operation: file_system_unfiled_retrieve
enabled: false
file-system-update:
operation: file_system_update
enabled: false
generate-conversations-public-token-create:
operation: organizations_projects_generate_conversations_public_token_create
enabled: false
identity-provider-configs-create:
operation: identity_provider_configs_create
enabled: false
identity-provider-configs-destroy:
operation: identity_provider_configs_destroy
enabled: false
identity-provider-configs-list:
operation: identity_provider_configs_list
enabled: false
identity-provider-configs-partial-update:
operation: identity_provider_configs_partial_update
enabled: false
identity-provider-configs-retrieve:
operation: identity_provider_configs_retrieve
enabled: false
identity-provider-configs-scim-token-create:
operation: identity_provider_configs_scim_token_create
enabled: false
identity-provider-configs-update:
operation: identity_provider_configs_update
enabled: false
insights-sharing-list:
operation: insights_sharing_list
enabled: false
insights-sharing-passwords-create:
operation: insights_sharing_passwords_create
enabled: false
insights-sharing-passwords-destroy:
operation: insights_sharing_passwords_destroy
enabled: false
insights-sharing-refresh-create:
operation: insights_sharing_refresh_create
enabled: false
invites-bulk-create:
operation: invites_bulk_create
enabled: false
invites-create:
operation: invites_create
enabled: false
invites-delegate-create:
operation: invites_delegate_create
enabled: false
invites-destroy:
operation: invites_destroy
enabled: false
invites-list:
operation: invites_list
enabled: false
is-generating-demo-data-retrieve:
operation: organizations_projects_is_generating_demo_data_retrieve
enabled: false
notebooks-sharing-list:
operation: notebooks_sharing_list
enabled: false
notebooks-sharing-passwords-create:
operation: notebooks_sharing_passwords_create
enabled: false
notebooks-sharing-passwords-destroy:
operation: notebooks_sharing_passwords_destroy
enabled: false
notebooks-sharing-refresh-create:
operation: notebooks_sharing_refresh_create
enabled: false
oauth-applications-list:
operation: oauth_applications_list
enabled: false
organizations-projects-default-evaluation-contexts-create:
operation: organizations_projects_default_evaluation_contexts_create
enabled: false
organizations-projects-default-evaluation-contexts-destroy:
operation: organizations_projects_default_evaluation_contexts_destroy
enabled: false
organizations-projects-default-evaluation-contexts-retrieve:
operation: organizations_projects_default_evaluation_contexts_retrieve
enabled: false
organizations-projects-default-release-conditions-retrieve:
operation: organizations_projects_default_release_conditions_retrieve
enabled: false
organizations-projects-default-release-conditions-update:
operation: organizations_projects_default_release_conditions_update
enabled: false
organizations-projects-event-ingestion-restrictions-retrieve:
operation: organizations_projects_event_ingestion_restrictions_retrieve
enabled: false
organizations-projects-experiments-config-partial-update:
operation: organizations_projects_experiments_config_partial_update
enabled: false
organizations-projects-experiments-config-retrieve:
operation: organizations_projects_experiments_config_retrieve
enabled: false
organizations-projects-logs-config-partial-update:
operation: organizations_projects_logs_config_partial_update
enabled: false
organizations-projects-logs-config-retrieve:
operation: organizations_projects_logs_config_retrieve
enabled: false
organizations-projects-settings-as-of-retrieve:
operation: organizations_projects_settings_as_of_retrieve
enabled: false
product-enablement-create:
operation: product_enablement_create
enabled: false
project-get:
operation: organizations_projects_retrieve
enabled: true
scopes:
- project:read
annotations:
readOnly: true
destructive: false
idempotent: true
title: Get project
description: |
Retrieve a project and its settings. Omit the ID to get the caller's active project.
param_overrides:
id:
description: Project ID. If omitted, returns the caller's active project.
optional: true
fallback: projectId
cast: string-int
response:
exclude:
- secret_api_token
- secret_api_token_backup
- live_events_token
- default_modifiers
project-secret-api-keys-create:
operation: project_secret_api_keys_create
enabled: false
project-secret-api-keys-destroy:
operation: project_secret_api_keys_destroy
enabled: false
project-secret-api-keys-list:
operation: project_secret_api_keys_list
enabled: false
project-secret-api-keys-partial-update:
operation: project_secret_api_keys_partial_update
enabled: false
project-secret-api-keys-retrieve:
operation: project_secret_api_keys_retrieve
enabled: false
project-secret-api-keys-roll-create:
operation: project_secret_api_keys_roll_create
enabled: false
project-secret-api-keys-update:
operation: project_secret_api_keys_update
enabled: false
project-settings-update:
operation: organizations_projects_partial_update
enabled: true
scopes:
- project:write
annotations:
readOnly: false
destructive: true
idempotent: true
title: Update project settings
description: >
Update a project's settings using PATCH semantics — only the fields included in the request body are
changed. Use `project-get` first to inspect current settings. Always confirm changes with the user before
applying.
exclude_params:
- uuid
- created_at
- updated_at
- api_token
- secret_api_token
- secret_api_token_backup
- ingested_event
- effective_membership_level
- has_group_types
- group_types
- live_events_token
- product_intents
- available_setup_task_ids
- default_modifiers
- person_on_events_querying_enabled
- organization
param_overrides:
id:
description: Project ID, or `@current` to target the caller's active project.
cast: string-int
projects-create:
operation: organizations_projects_create
enabled: false
projects-destroy:
operation: organizations_projects_destroy
enabled: false
projects-list:
operation: organizations_projects_list
enabled: false
projects-update:
operation: organizations_projects_update
enabled: false
property-definitions-bulk-update-tags-create:
operation: property_definitions_bulk_update_tags_create
enabled: false
property-definitions-destroy:
operation: property_definitions_destroy
enabled: false
property-definitions-list:
operation: property_definitions_list
enabled: false
property-definitions-partial-update:
operation: property_definitions_partial_update
enabled: false
property-definitions-retrieve:
operation: property_definitions_retrieve
enabled: false
property-definitions-seen-together-retrieve:
operation: property_definitions_seen_together_retrieve
enabled: false
property-definitions-update:
operation: property_definitions_update
enabled: false
reset-token-partial-update:
operation: organizations_projects_reset_token_partial_update
enabled: false
rotate-secret-token-partial-update:
operation: organizations_projects_rotate_secret_token_partial_update
enabled: false
session-recordings-sharing-list:
operation: session_recordings_sharing_list
enabled: false
session-recordings-sharing-passwords-create:
operation: session_recordings_sharing_passwords_create
enabled: false
session-recordings-sharing-passwords-destroy:
operation: session_recordings_sharing_passwords_destroy
enabled: false
session-recordings-sharing-refresh-create:
operation: session_recordings_sharing_refresh_create
enabled: false
user-get:
operation: users_retrieve
enabled: true
scopes:
- user:read
annotations:
readOnly: true
destructive: false
idempotent: true
title: Get user
description: >
Retrieve the authenticated user's own profile and settings — identity (id, uuid, distinct_id, email, name),
security/auth state, preferences, and notification settings. Pass `@me` as the UUID to fetch the
authenticated user; non-staff callers may only access their own account. This tool deliberately does NOT
return organization or project configuration: the nested `organization`, `team`, and `organizations` objects
are trimmed to just `id` and `name` (no API tokens, members, available features, or project settings). Use
`project-get` for full project details, and the organization-scoped tools for organization details.
param_overrides:
uuid:
description: User UUID, or `@me` to target the authenticated user.
response:
include:
- id
- uuid
- distinct_id
- email
- pending_email
- is_email_verified
- first_name
- last_name
- date_joined
- is_staff
- has_password
- is_2fa_enabled
- has_social_auth
- has_sso_enforcement
- passkeys_enabled_for_2fa
- allow_impersonation
- notification_settings
- anonymize_data
- toolbar_mode
- events_column_config
- theme_mode
- mascot_config
- allow_sidebar_suggestions
- shortcut_position
- role_at_organization
- hide_mcp_hints
- scene_personalisation
- pending_invites
- organization.id
- organization.name
- team.id
- team.name
- organizations.*.id
- organizations.*.name
user-settings-update:
operation: users_partial_update
enabled: true
scopes:
- user:write
annotations:
readOnly: false
destructive: true
idempotent: true
title: Update user settings
description: >
Update the authenticated user's profile and settings using PATCH semantics — only the fields included in the
request body are changed. Pass `@me` as the UUID; non-staff callers may only update their own account. Use
`user-get` first to inspect current settings. `notification_settings` merges key-by-key; changing `email`
triggers a verification flow; changing `password` also requires `current_password`. Always confirm changes
with the user before applying.
exclude_params:
- date_joined
- uuid
- distinct_id
- pending_email
- is_email_verified
- has_password
- id
- is_staff
- is_impersonated
- is_impersonated_until
- is_impersonated_read_only
- sensitive_session_expires_at
- team
- organization
- organizations
- has_social_auth
- has_sso_enforcement
- is_2fa_enabled
- scene_personalisation
param_overrides:
uuid:
description: User UUID, or `@me` to target the authenticated user.
users-cancel-email-change-request-partial-update:
operation: users_cancel_email_change_request_partial_update
enabled: false
users-credentials-review-complete-create:
operation: users_credentials_review_complete_create
enabled: false
users-destroy:
operation: users_destroy
enabled: false
users-github-login-retrieve:
operation: users_github_login_retrieve
enabled: false
users-mascot-config-partial-update:
operation: users_mascot_config_partial_update
enabled: false
users-mascot-config-retrieve:
operation: users_mascot_config_retrieve
enabled: false
users-integrations-github-branches-retrieve:
operation: users_integrations_github_branches_retrieve
enabled: false
users-integrations-github-destroy:
operation: users_integrations_github_destroy
enabled: false
users-integrations-github-prepare-callback-create:
operation: users_integrations_github_prepare_callback_create
enabled: false
users-integrations-github-repos-refresh-create:
operation: users_integrations_github_repos_refresh_create
enabled: false
users-integrations-github-repos-retrieve:
operation: users_integrations_github_repos_retrieve
enabled: false
users-integrations-github-start-create:
operation: users_integrations_github_start_create
enabled: false
users-integrations-list:
operation: users_integrations_list
enabled: false
users-integrations-slack-destroy:
operation: users_integrations_slack_destroy
enabled: false
users-integrations-slack-linkable-workspaces-retrieve:
operation: users_integrations_slack_linkable_workspaces_retrieve
enabled: false
users-integrations-slack-start-create:
operation: users_integrations_slack_start_create
enabled: false
users-list:
operation: users_list
enabled: false
users-login-sessions-destroy:
operation: users_login_sessions_destroy
enabled: false
users-login-sessions-list:
operation: users_login_sessions_list
enabled: false
users-login-sessions-revoke-others-create:
operation: users_login_sessions_revoke_others_create
enabled: false
users-onboarding-skip-create:
operation: users_onboarding_skip_create
enabled: false
users-push-tokens-create:
operation: users_push_tokens_create
enabled: false
users-push-tokens-unregister-create:
operation: users_push_tokens_unregister_create
enabled: false
users-request-email-verification-create:
operation: users_request_email_verification_create
enabled: false
users-scene-personalisation-create:
operation: users_scene_personalisation_create
enabled: false
users-start-2fa-setup-retrieve:
operation: users_start_2fa_setup_retrieve
enabled: false
users-two-factor-backup-codes-create:
operation: users_two_factor_backup_codes_create
enabled: false
users-two-factor-disable-create:
operation: users_two_factor_disable_create
enabled: false
users-two-factor-start-setup-retrieve:
operation: users_two_factor_start_setup_retrieve
enabled: false
users-two-factor-status-retrieve:
operation: users_two_factor_status_retrieve
enabled: false
users-two-factor-validate-create:
operation: users_two_factor_validate_create
enabled: false
users-update:
operation: users_update
enabled: false
users-validate-2fa-create:
operation: users_validate_2fa_create
enabled: false
users-verify-email-create:
operation: users_verify_email_create
enabled: false