TrueNAS SCALE

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-08-11T21:00:49.889067Z",
      "publishedAt": "2026-08-11T21:00:49.889067Z",
      "statusChangedAt": "2026-08-11T21:00:49.889067Z"
    }
  },
  "server": {
    "name": "io.github.cedricziel/truenas-mcp",
    "title": "TrueNAS SCALE",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "0.4.2",
    "packages": [
      {
        "transport": {
          "url": "http://localhost:8080/mcp",
          "type": "streamable-http",
          "headers": [
            {
              "name": "Authorization",
              "isSecret": true,
              "isRequired": true,
              "description": "Your own TrueNAS API key as `Bearer <key>`. Create it under Credentials -> API Keys. The server stores no credential; the session reaches exactly what this key permits."
            }
          ]
        },
        "identifier": "ghcr.io/cedricziel/truenas-mcp:0.4.2",
        "runtimeHint": "docker",
        "registryType": "oci",
        "runtimeArguments": [
          {
            "name": "--publish",
            "type": "named",
            "value": "127.0.0.1:8080:8080",
            "description": "Bind the MCP listener to loopback only. Plaintext is enabled below on the assumption that nothing off-host can reach it."
          }
        ],
        "environmentVariables": [
          {
            "name": "TRUENAS_MCP_TARGET",
            "isRequired": true,
            "description": "TrueNAS host to manage, optionally `host:port`. Requires TrueNAS SCALE 25.04 or later.",
            "placeholder": "nas.local"
          },
          {
            "name": "TRUENAS_MCP_ALLOW_PLAINTEXT",
            "value": "true",
            "format": "boolean",
            "description": "Serve MCP without TLS. Set here because the listener is published on loopback only; drop it and supply TRUENAS_MCP_TLS_CERT/KEY if the port is reachable from elsewhere."
          },
          {
            "name": "TRUENAS_MCP_TARGET_INSECURE",
            "format": "boolean",
            "default": "false",
            "description": "Accept the TrueNAS certificate unverified while keeping the connection encrypted. TrueNAS ships a self-signed certificate for `CN=localhost`, so no address you can reach it by will validate."
          },
          {
            "name": "TRUENAS_MCP_ENABLE_WRITES",
            "format": "boolean",
            "default": "false",
            "description": "Expose the mutating tools. Read-only by default; unrecoverable operations stay unreachable either way."
          }
        ]
      }
    ],
    "repository": {
      "id": "1327728275",
      "url": "https://github.com/cedricziel/truenas-mcp",
      "source": "github"
    },
    "websiteUrl": "https://github.com/cedricziel/truenas-mcp#deploying-as-a-truenas-app",
    "description": "Inspect and manage TrueNAS SCALE storage, shares, apps and system state with your own API key"
  }
}