Schema | Homelab MCP Server

Describes the environment variables required to run the server.

Name	Required	Description	Default
`PORT`	No	The port the server will listen on	3005
`API_KEY`	Yes	Your API key for authentication (generate with: openssl rand -hex 32)
`TRUENAS_HOST`	No	The hostname or IP address of your TrueNAS server (optional)
`OPNSENSE_HOST`	No	The hostname or IP address of your OPNsense firewall (optional)
`TRUENAS_API_KEY`	No	Your TrueNAS API key (optional)
`CAPABILITY_LEVEL`	No	The capability level for the server (1-4). Level 1: Monitor (read-only), Level 2: Operate (start/stop), Level 3: Configure (read configs), Level 4: Manage (full control)	1
`OPNSENSE_API_KEY`	No	Your OPNsense API key (optional)
`OPNSENSE_API_SECRET`	No	Your OPNsense API secret (optional)

Features and capabilities supported by this server

Capability	Details
`tools`	{}

Functions exposed to the LLM to take actions

Name	Description
docker_list_containers	List all Docker containers with their status
docker_container_logs	Get recent logs from a container
docker_container_stats	Get CPU/memory/network stats for a container
system_info	Get host system information (disk, memory, CPU usage)
opnsense_status	Get OPNsense firewall/gateway status
truenas_status	Get TrueNAS pool health and system status
truenas_alerts	Get active TrueNAS alerts
proxmox_status	Get Proxmox cluster status and node information
proxmox_list_vms	List all Proxmox VMs and containers across all nodes
proxmox_vm_status	Get detailed status of a specific Proxmox VM or container
home_assistant_status	Get Home Assistant version, entity count, and available domains
home_assistant_list_entities	List all Home Assistant entities (lights, switches, sensors, etc.)
home_assistant_get_entity	Get detailed state and attributes of a specific Home Assistant entity

Interactive templates invoked by user choice

Name	Description
No prompts

Contextual data attached and managed by the client

Name	Description
No resources

Homelab MCP Server