MCP server for TrueNAS — manage ZFS pools, datasets, snapshots, SMB/NFS shares, VMs and replication from Claude Desktop, Claude Code or Cursor. 278 actions behind one hierarchical tool.
nasbridge exposes 15 tools with mixed quality. The primary 'truenas' tool has a reasonable description and schema, but 14 secondary tools (alert_*, alertservice_*, certificate_*) are defined with minimal descriptions and incomplete parameter documentation. Most parameter descriptions are terse (10-30 chars), falling below the 72-char baseline. No output schemas are documented. Error handling is generic. The server redacts secrets but does not guide recovery. Overall: functional but well below production baseline.
List all available alert categories. Useful for understanding the types of alerts the system can generate.
Dismiss an alert by its UUID. Dismissed alerts no longer appear as active but can be restored.
List all active alerts on the TrueNAS system. Shows alert level, message, source, and dismissal status.
List all available alert policies. Policies define how alerts are escalated and delivered.
Restore a previously dismissed alert by its UUID, making it active again.
Create a new alert notification service. Configures how and where alerts are delivered.
14 of 15 tools lack documented output schemas. LLMs cannot plan downstream calls or extract required fields without knowing response structure.
Parameter descriptions are uniformly terse (10-30 chars), well below the 72-char baseline. E.g., 'UUID of the alert to dismiss' lacks context on format, source, or how to obtain it.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 51 | 2025-06-18+ | v2 |
Delete an alert notification service by its ID. Use alertservice_list to find the ID.
List all configured alert notification services (e.g. email, Slack, PagerDuty). Shows their type, enabled status, and alert level.
Send a test notification through an alert service to verify it is configured correctly.
Update an existing alert notification service by its ID. All fields are optional — only provide the ones to change.
Create a new certificate. Supports internal (self-signed), CSR, imported, and ACME certificate types. Only name and create_type are required; other fields depend on the create_type.
Delete a certificate by its ID. This is a DESTRUCTIVE operation — the 'confirm' parameter must be true to proceed. Optionally force deletion even if the certificate is in use.
Get a specific certificate by its numeric ID. Returns full certificate details including the PEM content.
List all certificates on the system, including self-signed, imported, CSR, and ACME certificates.
Manage your TrueNAS system. 278 actions organized in categories. Usage: - No args or category="help" → list all categories - category only → list available actions in that category with parameters - category + action → execute (pass action-specific params in 'params') Categories: system, storage, sharing, network, account, disk, vm, app, update, certificate, alert, data_protection, filesystem, reporting, directory, service_config, audit, api Secret values in responses (keys, passwords, tokens, private keys, password hashes) are replaced with "[redacted]" and cannot be read through this tool.
Discovery tools (alert_categories, alert_policies, certificate_list) lack guidance on when to call them or what structure they reveal. LLMs cannot determine if a discovery call is necessary.
Destructive tools (alertservice_delete, certificate_delete) lack confirmation or dry-run support. certificate_delete requires a 'confirm' boolean, but no guidance on consequences or recovery.
Error handling is generic. runTool() catches all errors and returns 'Error: <message>' with redaction, but does not classify errors as retryable, user-fixable, or fatal, nor suggest recovery steps.