en.yaml

---
configuration:
  backup_hint:
    name: Backup hint
    description: Controls when backup reminders are shown before risky operations.
  secret_path:
    name: Secret path override
    description: |
      Optional custom HTTP path for the MCP server. Leave empty to use the auto-generated secure path.
  enable_skills:
    name: Enable skills
    description: >-
      Serve bundled Home Assistant best-practice skills as MCP resources.
      Skills provide automation patterns, helper selection guides, and device
      control best practices. Clients must explicitly request them.
  enable_skills_as_tools:
    name: Enable skills as tools
    description: >-
      Expose skills via list_resources/read_resource tools for MCP clients
      that don't support resources natively. Adds 3 extra tools.
  enable_tool_search:
    name: Enable tool search
    description: >-
      Replace the full tool catalog with search-based discovery. Reduces
      idle context from ~46K to ~5K tokens. Use this if using an LLM without
      deferred tools or with smaller context windows. Tools are found via
      ha_search_tools and executed via categorized proxies (read/write/delete).
      Requires restart to take effect.
  enable_yaml_config_editing:
    name: Enable YAML config editing (beta)
    description: >-
      Beta feature — disabled by default. Allows AI assistants to add,
      replace, or remove top-level keys in configuration.yaml and
      packages/*.yaml. Only whitelisted keys are allowed (e.g., template,
      sensor, command_line, mqtt); core keys like homeassistant, http,
      and recorder are blocked. Each edit validates YAML syntax, runs a
      config check, and creates an automatic backup. Changes to most keys
      require a full HA restart to take effect. See docs/beta.md for known
      limitations. Dedicated tools (automations, scripts, scenes, helpers,
      template sensors) should be preferred when available.
  enable_filesystem_tools:
    name: Enable filesystem tools (beta)
    description: >-
      Sets HAMCP_ENABLE_FILESYSTEM_TOOLS=true. Enables direct file read/write
      access to your Home Assistant filesystem. WARNING: This gives the MCP
      server sensitive direct file access to your system. Only enable if you
      trust the AI assistant with file operations. Requires restart to take
      effect.
  enable_custom_component_integration:
    name: Enable custom component integration (beta)
    description: >-
      Sets HAMCP_ENABLE_CUSTOM_COMPONENT_INTEGRATION=true. Enables the
      ha_install_mcp_tools installer tool, which can help install the
      ha_mcp_tools custom component. This setting does not control whether the
      MCP server loads or interacts with the custom component, and it is not
      required for filesystem tools to function. Only enable if you want to
      allow the AI assistant to use the installer tool. Requires restart to
      take effect.
  tool_search_max_results:
    name: Tool search max results
    description: >-
      Maximum number of tools returned by ha_search_tools when tool
      search is enabled. Lower values (2-3) save context tokens but
      may miss relevant tools. Range: 2-10. Requires restart.
  disabled_tools:
    name: Disabled tools (text fallback)
    description: >-
      Comma-separated tool names to disable. For a visual interface,
      click "Open Web UI" on the addon info page. This field seeds the initial config
      when the web UI hasn't been used yet. Requires restart.
  pinned_tools:
    name: Pinned tools (text fallback)
    description: >-
      Comma-separated tool names to pin (always visible in tool search).
      For a visual interface, click "Open Web UI" on the addon info page. This field
      seeds the initial config when the web UI hasn't been used yet.
      Requires restart.