Helm — 109 Operations for AI Agents

This page is the canonical reference an AI coding agent uses to refactor, query, and analyze Helm code through the act MCP server. 109 operations available: 35 refactor, 18 query, 42 analysis, 14 verification. Each operation is callable from Claude Code, Cursor, Codex, OpenCode, or any MCP-compatible agent host. Click any operation for a stable anchor link suitable for citation.

18Query
35Refactor
42Analysis
14Verify

Query

18 query tools, the same on every supported language. Descriptions live in the shared reference: /docs/query-tools.

callers control_flow data_flow definition diagnostics effect_closure effect_summary fix_auto get_type graph import_organize interface mutations references repo_outline skeleton symbols symbols_batch

Refactor

Operation Description
add-if-condition wrap a block in {{- if .Values.enabled }} guard
add-value-default wrap a .Values reference with | default <value>
convert-from-named-template inline a named template at its include site and remove the define block
convert-if-to-with convert {{- if .Values.x }}{{ .Values.x }}{{- end }} to with block
convert-to-named-template wrap inline template content into a define/include pair
convert-with-to-if convert {{- with .Values.x }}{{ . }}{{- end }} to explicit if block
extract-helper extract an inline expression into a named define helper template
extract-partial extract a repeated block into a named partial template
extract-values-reference replace a hardcoded literal with a .Values reference
extract_function Extract a code selection into a new function — automatically infers parameters, return types, and inserts the call site. Use instead of manually cutting/pasting code. Works without LSP; LSP improves type inference. Params: file (string), new_name (string), start_line (u32), start_column (u32), end_line (u32), end_column (u32) [, preview (bool), receipt (bool)]
extract_variable Extract an expression into a named variable — inserts the declaration and replaces the expression with the variable name. Works without LSP. Params: file (string), new_name (string), start_line (u32), start_column (u32), end_line (u32), end_column (u32) [, preview (bool)]
gen-chart-scaffold generate Chart.yaml, values.yaml, and templates/_helpers.tpl skeleton
gen-configmap-template generate a ConfigMap template from a values section
gen-deployment-template generate a Deployment template with standard Helm conventions
gen-helper-template generate a named helper template with documented interface
gen-helpers-file generate templates/_helpers.tpl with standard naming and label helpers
gen-ingress-template generate an Ingress template with host/TLS bindings
gen-secret-template generate a Secret template with b64enc data references
gen-service-template generate a Service template with .Values.service bindings
gen-values-file generate values.yaml with sensible defaults
inline Inline a variable, function, or method — replace every usage with its definition body, then remove the original. The inverse of extract. Works without LSP (single-file); LSP enables cross-file inlining. Params: file (string), symbol (string) [, line (u32), preview (bool), receipt (bool)]
inline-template inline a single-use include call with the referenced template body
inline-values-reference replace a .Values reference with its hardcoded literal value
insert_body Replace a function's implementation body with new code. AST-validated — rejects if the result has parse errors, so you can't accidentally break syntax. Use instead of manual text editing for function rewrites. Params: file (string), symbol (string), code (string) [, commit (bool)]
move-helper-to-template move a define block from _helpers.tpl to a chart template file
move-template-to-helpers move a define block from a chart template to _helpers.tpl
move_symbol Move a function, class, or type to a different file and automatically update all imports across the codebase. Use instead of manually cut/paste + fixing imports. Works without LSP (single-file); LSP enables cross-file import updates. Params: file (string), symbol (string), destination (string) [, preview (bool), receipt (bool)]
organize-helpers sort and group define blocks in _helpers.tpl alphabetically
recipe_run Run a codemod recipe: declarative match → transform → optional verify across modeled grammars. Preview lists matches; apply writes with optional E7 receipts and all-or-nothing rollback. Returns a per-site report.
remove-if-condition remove an if block keeping only the then-branch
remove-value-default remove | default filter from a .Values reference
rename Rename a symbol and automatically update ALL references across the codebase. Safer and faster than find-and-replace — AST-aware, won't rename strings or comments. Works without LSP (single-file); LSP enables cross-file renames. Params: file (string), old_name (string), new_name (string) [, line (u32), column (u32), preview (bool), receipt (bool)]
rename-named-template rename a named template across all template files in the chart
rename-template rename a named template and update all include/template call sites
rename-value rename a .Values key and update all template references

Analysis

42 analysis tools, the same on every supported language. Descriptions live in the shared reference: /docs/analysis-tools.

analyze_api_diff analyze_chokepoints analyze_clones analyze_clusters analyze_cohesion analyze_conformance analyze_coupling analyze_cycle_risk analyze_cycles analyze_dead_code analyze_depth analyze_entry_points analyze_export analyze_extraction analyze_fan_balance analyze_features analyze_hotspots analyze_impact analyze_inconsistencies analyze_inheritance analyze_interface_bloat analyze_interfaces analyze_layers analyze_orphan_types analyze_patterns analyze_platform_deps analyze_readiness analyze_roles analyze_seams analyze_stability analyze_surface analyze_test_gaps analyze_thickness analyze_type_completeness churn_hotspots co_change_clusters coverage_overlay ownership_map profile_overlay simulate split_module trace_overlay

Verify

14 verify tools, the same on every supported language. Descriptions live in the shared reference: /docs/verification.

bisect_regression gate generate_test_harness scan secret_surface summarize_pr taint_flow unsafe_surface verify_behavioral_equivalence verify_contract_preserved verify_diff_semantics verify_port_parity verify_side_effects verify_test_impact

← HEExHLSL →