TrueNAS AIops

Governed TrueNAS SCALE storage ops — 25 MCP tools with audit, budget, undo guards.

Connector by AIops-tools · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/aiops-tools-truenas-aiops

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Governed TrueNAS SCALE storage ops — 25 MCP tools with audit, budget, undo guards.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools: 19 read · 4 write · 0 delete · 2 not yet classified
Secrets: None asked for
Install scripts: None found
Runs as: Python package

Tools by what they do 25

Read from the source code; the running server may list different tools.

Read 19 · Look things up without changing anything.

alert_and_capacity_rca
alert_list
cloudsync_list
dataset_get
dataset_list
disk_list
overview
pool_capacity
pool_get
pool_health_rca
pool_list
pool_status

Show 7 more tools

replication_list
scrub_status
service_list
smart_test_results
snapshot_list
system_info
undo_list

Write 4 · Create, change, send or run things.

dataset_create
pool_scrub_start
service_restart
undo_apply

Not yet classified 2 · We could not tell from the name and description.

snapshot_create
snapshot_delete

Network hosts it talks to 3

anthropic.com · found in code
github.com · found in code
glama.ai · found in code

Files it touches

~/.truenas-aiops
~/.truenas-aiops/audit.db
~/.truenas-aiops/secrets.enc
~/.truenas-aiops/undo.db

Tools (25)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

alert_and_capacity_rca
[READ] Surface active TrueNAS alerts by level and datasets near full. Collects the active alert list and the /pool/dataset listing, then reports worst-first findings: one per active (non-dismissed) alert at WARNING+ and one per dataset whose usage is near its quota/available ceiling (80%/90%), each citing the measured level/percent. Args: target: TrueNAS target name from config; omit to use the default.
alert_list
[READ] List active TrueNAS alerts with level, message, class, dismissed. Args: target: TrueNAS target name from config; omit to use the default.
cloudsync_list
[READ] List cloud-sync tasks with description, direction, path, state. ``state`` here is the last run's job state (SUCCESS / FAILED / RUNNING) and is null until the task has run — cloud-sync records, unlike replication ones, carry no state of their own. Args: target: TrueNAS target name from config.
dataset_create
[WRITE] Create a ZFS dataset. Non-destructive (creates new storage). Pass dry_run=True to preview. No undo descriptor — dataset deletion is intentionally out of scope. Args: name: Full dataset path including the pool, e.g. 'tank/projects'. pool: Optional pool name for context/labelling. dry_run: If True, preview without creating. target: TrueNAS target name from config.
dataset_get
[READ] Return detail for a single dataset by id (e.g. 'tank/data'). Args: dataset_id: TrueNAS dataset id (see dataset_list). target: TrueNAS target name from config.
dataset_list
[READ] List ZFS datasets with id, name, type, pool, used/available. Args: target: TrueNAS target name from config; omit to use the default.
disk_list
[READ] List physical disks with name, serial, model, size, pool. Args: target: TrueNAS target name from config; omit to use the default.
overview
[READ] One-shot health summary: pools (capacity/health), alerts, services. Call this first to triage a TrueNAS system before drilling into a specific pool, dataset, or service. Args: target: TrueNAS target name from config; omit to use the default.
pool_capacity
[READ] Capacity summary per pool: size/allocated/free and used percent. Args: target: TrueNAS target name from config.
pool_get
[READ] Return detail for a single pool by id. Args: pool_id: TrueNAS pool id (see pool_list). target: TrueNAS target name from config.
pool_health_rca
[READ] Flag ZFS pools by state, error counters, and capacity. Pulls the /pool listing (with topology + scan) and flags pools that are DEGRADED/FAULTED/OFFLINE, pools with non-zero read/write/checksum/scan error counters, and pools over the 80%/90% capacity thresholds — worst-first, each finding citing the measured status/counts/percent and a concrete action. Args: target: TrueNAS target name from config; omit to use the default.
pool_list
[READ] List ZFS pools with id, name, status, health, capacity. Args: target: TrueNAS target name from config; omit to use the default.
pool_scrub_start
[WRITE] Start a scrub (integrity check) on a pool. Non-destructive. Pass dry_run=True to preview. No undo descriptor (a scrub has no clean inverse beyond cancellation). Poll progress with scrub_status; do not re-issue. Args: pool_name: ZFS pool name (e.g. 'tank'). dry_run: If True, preview without starting the scrub. target: TrueNAS target name from config.
pool_status
[READ] Health and scan/topology status of a single pool. Args: pool_id: TrueNAS pool id. target: TrueNAS target name from config.
replication_list
[READ] List replication tasks with name, direction, transport, state. ``state`` is the replication task's own state — PENDING / RUNNING / FINISHED / ERROR / HOLD, matching what the appliance UI shows — and is never absent, PENDING being what a task reports before its first run. An ERROR row carries the appliance's ``error`` sentence naming what to fix. Also returns ``lastSnapshot`` and ``lastRun`` (epoch milliseconds). Args: target: TrueNAS target name from config; omit to use the default.

Show 10 more tools

scrub_status
[READ] Current scrub scan state (function/state/percentage) for a pool. Args: pool_id: TrueNAS pool id. target: TrueNAS target name from config.
service_list
[READ] List system services with name, state (RUNNING/STOPPED), enable. Args: target: TrueNAS target name from config; omit to use the default.
service_restart
[WRITE] Restart a system service (e.g. 'smb', 'nfs'). Pass dry_run=True to preview. Captures the prior service state for the audit record; declares no undo (a restart is not cleanly reversible). Refuses a service name that is not present in service_list, and refuses 'ssh' unless confirm=True — SSH is the out-of-band recovery path, and bouncing it can strand whoever is working over it. Both refusals apply under dry_run too, which must report a refusal rather than preview a call that will be refused. Args: service: TrueNAS service name (see service_list). confirm: Required (True) only…
smart_test_results
[READ] Recent S.M.A.R.T. self-test results per disk (status/description). Args: target: TrueNAS target name from config.
snapshot_create
[WRITE] Create a ZFS snapshot 'dataset@name'. Inverse: snapshot_delete. Pass dry_run=True to preview. Args: dataset: Dataset path to snapshot (e.g. 'tank/data'). name: Snapshot name (e.g. 'manual-2026-06-28'). dry_run: If True, preview without creating (and without an undo token). target: TrueNAS target name from config.
snapshot_delete
[WRITE] Delete a ZFS snapshot by id ('dataset@name'). IRREVERSIBLE. Pass dry_run=True to preview. Captures the snapshot's prior state for the audit record; declares no undo. Args: snapshot_id: Full snapshot id 'dataset@name' (see snapshot_list). dry_run: If True, preview without deleting. target: TrueNAS target name from config.
snapshot_list
[READ] List ZFS snapshots, optionally filtered to one dataset. Returns {"snapshots": [...], "returned": N, "limit": L, "truncated": bool}. When "truncated" is true there are more snapshots than were returned — re-run with a higher limit or filter to one dataset. Args: dataset: Optional dataset path to filter (e.g. 'tank/data'). limit: Max snapshot rows to return (default 200). target: TrueNAS target name from config.
system_info
[READ] TrueNAS system summary: version, hostname, memory, cores, uptime. Args: target: TrueNAS target name from config; omit to use the default.
undo_apply
[WRITE][risk=medium] Apply a recorded undo by dispatching its inverse tool. The inverse runs through its own governed tool, so it is audited under its own risk tier. Pass dry_run=True to preview the inverse call without executing it. A token can only be applied once. Args: undo_id: The undoId from undo_list (or an ``_undo_id`` in a write result). dry_run: If True, preview the inverse tool + params without running it. target: Passed through to the inverse tool when it accepts a target.
undo_list
[READ] List recorded, not-yet-applied undo tokens (most recent first). Each entry names the original tool, the inverse tool that ``undo_apply`` would run, and a human note. Use the ``undoId`` with ``undo_apply``. Returns {"undos": [...], "returned": N, "limit": L, "truncated": bool}. When "truncated" is true there are more recorded tokens than were shown — re-run with a higher limit rather than treating the list as complete. One extra row is fetched so "truncated" is measured, not guessed from a length coincidence. Each entry carries ``effectVerified``. False means the original write lost i…

Signals

Stars: 0
Forks: 0
Open issues: 0
Weekly downloads: 240
Last commit: Oct 15, 2026 (15 days ago)
Last release: Oct 15, 2026 (15 days ago)
Last package publish: Oct 15, 2026 (15 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name: io.github.AIops-tools/truenas-aiops
Version: 0.13.0
Auth: No auth
Packages: pypi truenas-aiops
License: MIT
Repository: github.com/AIops-tools/TrueNAS-AIops
First seen: Oct 24, 2026
Last checked: Oct 25, 2026
Source: Official MCP Registry github-graphql

More from AIops-tools

Cite this page

TrueNAS AIops MCP server. Agent Mart. https://agentmart.dev/connectors/aiops-tools-truenas-aiops (last updated 2026-10-25)