unraid-code-mode-mcp

Discover and invoke Unraid 7.2+ GraphQL operations via sandboxed MCP tooling.

1|Updated May 8, 2026
One-click install
npx skills add https://github.com/jmpijll/unraid-code-mode-mcp --skill unraid-code-mode-mcp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unraid-code-mode-mcp
Source: https://github.com/jmpijll/unraid-code-mode-mcp/tree/main
Command: npx skills add https://github.com/jmpijll/unraid-code-mode-mcp --skill unraid-code-mode-mcp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you operate an Unraid 7.2+ system by letting an LLM safely discover and invoke GraphQL operations without guessing field names or hand-writing fragile query strings.

Core Features & Use Cases

  • Schema discovery with search: find the right query or mutation names and argument shapes before calling anything live.
  • Live execution with execute: run sandboxed JavaScript that calls Unraid GraphQL through the server’s typed helper surfaces.
  • Typed convenience + raw escape hatches: use unraid.local.query.<field>({ args, fields }), unraid.local.mutation.<field>({ args, fields }), or fall back to unraid.local.graphql({ query, variables }) when you need full control.
  • Safety guardrails and clearer failures: enforces an execute time limit and an API-call budget, plus emits tagged errors the agent can react to without inventing operations.

Quick Start

Use the unraid-code-mode-mcp skill to produce a one-screen overview of your Unraid box by calling search to identify info, array, shares, vms, docker, and online, then running one execute script that fetches them in a single Promise.all and returns a Markdown table.

Frequently Asked Questions about unraid-code-mode-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query Unraid GraphQL operations without guessing field names?

You query Unraid GraphQL operations without guessing field names by using a schema search tool to discover correct query and mutation shapes, then executing them through sandboxed JavaScript via the server's typed helper surfaces.

Can I run untrusted JavaScript code to mutate my Unraid server safely?

Yes, you can safely run untrusted JavaScript to mutate your Unraid server. Execution occurs inside a QuickJS WASM sandbox that enforces strict execution time limits and API-call budgets to prevent runaway operations.

Does this approach require a specific Unraid version to work?

Yes, this approach requires Unraid version 7.2 or higher. It relies on the server's GraphQL API and typed dispatch surfaces to provide the schema discovery and safe execution environment needed for operation.

What's the best way to get an overview of my Unraid array, shares, and VMs?

The best way to get an overview of your Unraid array, shares, and VMs is to discover the relevant GraphQL fields using search, then run a single execute script that fetches them concurrently with Promise.all and formats the output as a Markdown table.

How do I execute raw GraphQL queries when typed helpers are not enough?

You execute raw GraphQL queries when typed helpers are insufficient by falling back to the unraid.local.graphql function, passing your custom query string and variables directly to the Unraid server for full control.

What limitations exist when executing code in a QuickJS sandbox?

Limitations of executing code in a QuickJS sandbox include strict enforcement of an execution time limit and an API-call budget. If these thresholds are exceeded, the sandbox emits tagged errors that the agent can react to without inventing operations.