TrueNAS MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| system_infoA | Get TrueNAS system information (version, hostname, uptime, CPU, memory). Returns: JSON string with system.info fields. |
| list_poolsB | List storage pools and their ZFS status (health, capacity, topology). |
| list_disksA | List disks and their health fields (model, serial, size, SMART status). |
| list_datasetsB | List ZFS datasets (name, mountpoint, used/available, quotas). |
| list_appsA | List installed applications (k3s apps) with state and version. |
| list_vmsB | List virtual machines with their current status. |
| list_snapshotsC | List ZFS snapshots. |
| list_sharesB | List SMB or NFS shares. |
| list_alertsB | List TrueNAS system alerts. |
| get_scrub_statusB | Get ZFS pool scrub status/schedules. |
| list_boot_environmentsA | List boot environments (active, activated, kernel/initramfs). |
| list_jobsB | List middleware jobs (long-running operations). |
| install_appC | Install an app from the TrueNAS catalog. |
| start_appB | Start an installed app. Long-running (may take seconds). |
| stop_appA | Stop an installed app. Long-running (may take seconds). |
| update_appC | Update an installed app's configuration. |
| upgrade_appC | Upgrade an installed app to the latest version. |
| delete_appC | Delete an installed app. |
| search_app_catalogC | Search the TrueNAS app catalog for available apps. |
| create_datasetC | Create a ZFS dataset. |
| delete_datasetC | Delete a ZFS dataset. |
| create_snapshotC | Create a ZFS snapshot. |
| delete_snapshotC | Delete a ZFS snapshot. |
| create_shareC | Create an SMB or NFS share. |
| delete_shareC | Delete an SMB or NFS share. |
| run_scrubC | Run a ZFS scrub on a pool. |
| dismiss_alertC | Dismiss a TrueNAS alert. |
| restore_alertB | Restore a dismissed TrueNAS alert. |
| truenas_callC | Call any TrueNAS middleware endpoint directly. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 29 tools
Most tools target clearly distinct resources and actions, especially the list/create/delete families for datasets, snapshots, and shares. Minor ambiguity exists between update_app and upgrade_app, and truenas_call overlaps with every specific tool as a generic escape hatch.
Almost all tools use consistent snake_case verb_noun naming, such as list_pools, create_dataset, and delete_share. The few deviations are system_info (noun-first) and truenas_call (noun_verb), but the overall pattern remains predictable.
TrueNAS is a broad administration domain, so many tools are justified, but 29 tools is on the heavy side and includes both granular wrappers and a generic truenas_call fallback. The set is useful but close to feeling over-expanded.
Core areas like datasets, snapshots, shares, apps, alerts, and scrubs are well covered, but VM support is list-only and there are no update operations for datasets or shares. The generic truenas_call endpoint can fill gaps, though not as cleanly as dedicated tools.