myco:add-tool-category

Installation
SKILL.md

Adding a New Tool Category to unifi-mcp

A "tool category" is a new UniFi resource type — DNS records, DHCP leases, alarms, etc. — exposed end-to-end: a manager class that talks to the controller, a schema/validator layer, a tool module that Claude calls, and tests at both layers. Omitting any step silently breaks CI or corrupts data on live controllers.

Golden-path reference implementation: managers/dns_manager.py + tools/dns.py + test_dns_manager.py + test_dns_tools.py (PR #128).

Prerequisites

  • Understand which UniFi package owns the resource: unifi-network-mcp vs. unifi-protect-mcp vs. unifi-access-mcp. Directory structure and naming conventions differ by package.
  • Know whether the resource's GET-by-ID endpoint returns 405 (see Step 2).
  • Review implement-update-tool-fetch-merge-put skill before writing any update method.
  • Have a live controller available for final validation output in the PR description.
  • Understand UniFiValidatorRegistry.validate() usage patterns (covered in Step 3).

Step 1 — Create the Manager Class

File: apps/{package}/managers/{resource}_manager.py

Installs
1
GitHub Stars
425
First Seen
Apr 29, 2026
myco:add-tool-category — sirkirby/unifi-mcp