73 lines
2.1 KiB
Markdown
73 lines
2.1 KiB
Markdown
# ha-direct MCP Tools Reference
|
|
|
|
Use these tools only when ha-direct specific features are needed (BPS, backup, python_transform).
|
|
|
|
## Automations
|
|
| Tool | Purpose |
|
|
|------|---------|
|
|
| `ha_config_get_automation` | Read automation config |
|
|
| `ha_config_set_automation` | Create/update automation |
|
|
| `ha_config_remove_automation` | Delete automation |
|
|
| `ha_get_automation_traces` | Debug automation execution |
|
|
|
|
## Scripts
|
|
| Tool | Purpose |
|
|
|------|---------|
|
|
| `ha_config_set_script` | Create/update script |
|
|
|
|
## Scenes
|
|
| Tool | Purpose |
|
|
|------|---------|
|
|
| `ha_config_get_scene` | Read scene config |
|
|
| `ha_config_set_scene` | Create/update scene |
|
|
| `ha_config_remove_scene` | Delete scene |
|
|
|
|
## Dashboards
|
|
| Tool | Purpose |
|
|
|------|---------|
|
|
| `ha_config_get_dashboard` | List/get/search dashboards |
|
|
| `ha_config_set_dashboard` | Create/update dashboard |
|
|
| `ha_config_delete_dashboard` | Delete dashboard |
|
|
|
|
## Entities
|
|
| Tool | Purpose |
|
|
|------|---------|
|
|
| `ha_get_entity` | Get entity registry info |
|
|
| `ha_set_entity` | Update entity properties |
|
|
| `ha_remove_entity` | Remove entity |
|
|
|
|
## Labels/Categories
|
|
| Tool | Purpose |
|
|
|------|---------|
|
|
| `ha_config_get_label` | List/get labels |
|
|
| `ha_config_set_label` | Create/update label |
|
|
| `ha_config_remove_label` | Delete label |
|
|
| `ha_config_get_category` | List/get categories |
|
|
| `ha_config_set_category` | Create/update category |
|
|
| `ha_config_remove_category` | Delete category |
|
|
|
|
## System
|
|
| Tool | Purpose |
|
|
|------|---------|
|
|
| `ha_reload_core` | Reload config without restart |
|
|
| `ha_manage_updates` | Manage system updates |
|
|
| `ha_get_overview` | System overview |
|
|
| `ha_get_skill_guide` | Best practices |
|
|
| `ha_report_issue` | File bug reports |
|
|
|
|
## Control
|
|
| Tool | Purpose |
|
|
|------|---------|
|
|
| `ha_call_service` | Call any HA service |
|
|
| `ha_call_event` | Fire custom event |
|
|
|
|
## Search
|
|
| Tool | Purpose |
|
|
|------|---------|
|
|
| `ha_search` | Search entities/configs |
|
|
|
|
## Notes
|
|
- Write tools require `BestPracticeKey` (read from `SKILL.md` first)
|
|
- Key rotates hourly, re-read for fresh key
|
|
- `python_transform` requires `config_hash` from GET call
|