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
    description: >-
      WARNING, dangerous tool, use at your own risk. 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. A backup is created before every edit.
      Intended as a last resort for YAML-only features with no UI or API
      alternative — dedicated tools exist for automations, scripts,
      scenes, template sensors, and helpers and should be preferred.
      Requires restart to take effect.