Artifacts/unraid-mcp
2
0
Fork 0
forked from HomeLab/unraid-mcp
Code Pull Requests Actions Packages Releases 5 Activity
Files
c4fa6937abf21c63a49c5cf18c383f578097ea4b
unraid-mcp/skills/unraid/references/endpoints.md
Jacob Magar 184b8aca1c fix: address 18 CRITICAL+HIGH PR review comments 
**Critical Fixes (7 issues):**
- Fix GraphQL schema field names in users tool (role→roles, remove email)
- Fix GraphQL mutation signatures (addUserInput, deleteUser input)
- Fix dict(None) TypeError guards in users tool (use `or {}` pattern)
- Fix FastAPI version constraint (0.116.1→0.115.0)
- Fix WebSocket SSL context handling (support CA bundles, bool, and None)
- Fix critical disk threshold treated as warning (split counters)

**High Priority Fixes (11 issues):**
- Fix Docker update/remove action response field mapping
- Fix path traversal vulnerability in log validation (normalize paths)
- Fix deleteApiKeys validation (check response before success)
- Fix rclone create_remote validation (check response)
- Fix keys input_data type annotation (dict[str, Any])
- Fix VM domain/domains fallback restoration

**Changes by file:**
- unraid_mcp/tools/docker.py: Response field mapping
- unraid_mcp/tools/info.py: Split critical/warning counters
- unraid_mcp/tools/storage.py: Path normalization for traversal protection
- unraid_mcp/tools/users.py: GraphQL schema + null handling
- unraid_mcp/tools/keys.py: Validation + type annotations
- unraid_mcp/tools/rclone.py: Response validation
- unraid_mcp/tools/virtualization.py: Domain fallback
- unraid_mcp/subscriptions/manager.py: SSL context creation
- pyproject.toml: FastAPI version fix
- tests/*: New tests for all fixes

**Review threads resolved:**
PRRT_kwDOO6Hdxs5uu70L, PRRT_kwDOO6Hdxs5uu70O, PRRT_kwDOO6Hdxs5uu70V,
PRRT_kwDOO6Hdxs5uu70e, PRRT_kwDOO6Hdxs5uu70i, PRRT_kwDOO6Hdxs5uu7zn,
PRRT_kwDOO6Hdxs5uu7z_, PRRT_kwDOO6Hdxs5uu7sI, PRRT_kwDOO6Hdxs5uu7sJ,
PRRT_kwDOO6Hdxs5uu7sK, PRRT_kwDOO6Hdxs5uu7Tk, PRRT_kwDOO6Hdxs5uu7Tn,
PRRT_kwDOO6Hdxs5uu7Tr, PRRT_kwDOO6Hdxs5uu7Ts, PRRT_kwDOO6Hdxs5uu7Tu,
PRRT_kwDOO6Hdxs5uu7Tv, PRRT_kwDOO6Hdxs5uu7Tw, PRRT_kwDOO6Hdxs5uu7Tx

All tests passing.

Co-authored-by: docker-fixer <agent@pr-fixes>
Co-authored-by: info-fixer <agent@pr-fixes>
Co-authored-by: storage-fixer <agent@pr-fixes>
Co-authored-by: users-fixer <agent@pr-fixes>
Co-authored-by: config-fixer <agent@pr-fixes>
Co-authored-by: websocket-fixer <agent@pr-fixes>
Co-authored-by: keys-rclone-fixer <agent@pr-fixes>
Co-authored-by: vm-fixer <agent@pr-fixes>
2026-02-15 16:42:58 -05:00

1.4 KiB
Raw Blame History

Unraid API Endpoints Reference

Complete list of available GraphQL read-only endpoints in Unraid 7.2+.

System & Metrics (8)

  1. info - Hardware specs (CPU, OS, motherboard)
  2. metrics - Real-time CPU/memory usage
  3. online - Server online status
  4. isInitialSetup - Setup completion status
  5. config - System configuration
  6. vars - System variables
  7. settings - System settings
  8. logFiles - List all log files

Storage (4)

  1. array - Array status, disks, parity
  2. disks - All physical disks (array + cache + USB)
  3. shares - Network shares
  4. logFile - Read log content

Virtualization (2)

  1. docker - Docker containers
  2. vms - Virtual machines

Monitoring (2)

  1. notifications - System alerts
  2. upsDevices - UPS battery status

User & Auth (4)

  1. me - Current user info
  2. owner - Server owner
  3. isSSOEnabled - SSO status
  4. oidcProviders - OIDC providers

API Management (2)

  1. apiKeys - List API keys

Customization (3)

  1. customization - UI theme & settings
  2. publicTheme - Public theme
  3. publicPartnerInfo - Partner branding

Server Management (3)

  1. registration - License info
  2. server - Server metadata
  3. servers - Multi-server management

Bonus (1)

  1. plugins - Installed plugins (returns empty array if none)
View Git Blame Copy Permalink