unifi-mcp-tool-builder

Scaffold new MCP tools for the UniFi MCP Server with TDD and Pydantic v2 models.

215|37|Updated Oct 18, 2025
One-click install
npx skills add https://github.com/enuno/unifi-mcp-server --skill unifi-mcp-tool-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unifi-mcp-tool-builder
Source: https://github.com/enuno/unifi-mcp-server/tree/main/.claude/skills/unifi-mcp-tool-builder
Command: npx skills add https://github.com/enuno/unifi-mcp-server --skill unifi-mcp-tool-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured, end-to-end blueprint for adding new MCP tools to the UniFi MCP Server, ensuring consistency with the existing 74 tools and established patterns.

Core Features & Use Cases

  • Phase-driven workflow: research, design, implementation, testing, and documentation to extend the MCP toolset.
  • Best-practice templates: ready-to-use scaffolds for tests, Pydantic models, API docs, and changelogs.
  • Use Case: a developer wants to introduce a new MCP tool; this Skill guides them to implement it with correct structure, validation, and quality gates.

Quick Start

Define your new MCP tool following the Builder's phases and generate the code skeleton, tests, and docs with minimal setup.

Frequently Asked Questions about unifi-mcp-tool-builder

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

FAQPage Schema
How do I add a new MCP tool to a UniFi Network Controller project?

You add a new MCP tool by following a phase-driven workflow of research, design, implementation, testing, and documentation that enforces TDD, Pydantic v2 models, and FastMCP tooling conventions. This ensures new UniFi Controller features match existing patterns and pass quality gates.

What is the best way to scaffold Python MCP tools with TDD?

The best way to scaffold Python MCP tools with TDD is to use ready-made templates for tests, Pydantic v2 models, and API documentation. This generates code skeletons with validation and quality gates already configured for consistent development.

Does UniFi MCP tool scaffolding require FastMCP and Pydantic v2?

Yes, UniFi MCP tool scaffolding requires FastMCP and Pydantic v2 to maintain consistency with existing patterns. The builder enforces these specific frameworks alongside TDD to generate high-quality artifacts for the MCP Server.

How do I generate API documentation and changelog updates for MCP tools?

You generate API documentation and changelog updates using best-practice templates provided during the scaffolding phases. This ensures every new UniFi MCP tool includes ready-to-use docs and changelog entries with minimal manual setup.

Can I use this scaffolding workflow for all UniFi MCP tool categories?

Yes, you can use this scaffolding workflow for all UniFi MCP tool categories. It applies to any project adding new UniFi Network Controller features as MCP tools, ensuring consistent structure and validation across the entire 74-tool toolset.

Why does scaffolding MCP tools with a blueprint improve software engineering?

Scaffolding MCP tools with a blueprint improves software engineering by enforcing TDD, Pydantic v2 validation, and FastMCP conventions across research, design, and implementation phases. This maintains consistency with existing tools and eliminates structural drift.