Skill Claude CodeCodex
Use this skill when adding any tool that talks to the UniFi public Integration API (X-API-Key auth, /proxy/network/integration/...). The integration API uses a different ID namespace and field schema from the V2 controller API, so these tools form their own "families" with scoped IDs. Covers when to start a new family…
Skill Claude CodeCodex
Apply this skill when adding an endpoint to apps/api/, authoring a mutation-ack serializer, wiring ManagerFactory, resolving Phase 5A routing collisions, or diagnosing the validatemanifest or testresourceroutecoverage CI gates. Covers: resource vs. action classification (409 vs. 200+envelope); Cursor + paginate()…
Skill Claude CodeCodex
Activate when working on Claude plugin configuration, MCP transport behavior, or plugin release mechanics in unifi-mcp. Covers: keeping UNIFIMCPHTTPFORCE at its safe default in apps//config/config.yaml for all three apps (network, protect, access); the stdio-primary transport pattern in transport.py and why…
Skill Claude CodeCodex
Covers plugin configuration, transport stability, local development workflow, and release lifecycle for the three Claude MCP plugins in this repo (unifi-network, unifi-protect, unifi-access). Apply this skill when modifying plugin.json files, changing transport.py asyncio patterns, writing or auditing shell scripts in…
Skill Claude CodeCodex
Use this skill when reviewing or merging any community PR in unifi-mcp — even if the user just says "take a look at this PR" or "can we merge this." Covers the quality gate checklist (f-string logger ban, Ruff lint, validator registration, doc site update ordering), the fork-edit model for trusted contributors…
Skill Claude CodeCodex
Apply this skill when implementing a new UniFi resource type end-to-end across all layers — manager class, tool layer, domain models, tests, API REST/GraphQL exposure, and action dispatcher integration. Covers: manager CRUD with 405 workarounds, V2 API response normalization, domain Pydantic models and field…
Skill Claude CodeCodex
Activate this skill when running, interpreting, extending, or debugging the live hardware smoke test harness in scripts/livesmoke.py. Covers all aspects of manifest-driven live testing against real UniFi hardware: .env credential setup, tool classification tiers, --phase flag selection to bound blast radius, the…
Skill Claude CodeCodex
Use this skill whenever you're adding, changing, or reviewing sensitive-field disclosure behavior on an MCP tool or API response — even if the user just asks to "expose this field" or "let callers opt into raw data." Covers: configuring per-surface redaction via redactsensitivefields and its env-var hierarchy…
Skill Claude CodeCodex
Covers the full release pipeline for the unifi-mcp monorepo: determining release scope by analyzing changed packages, scoping hatch-vcs version tag globs per Python package to prevent sibling-tag contamination, pushing tags in strict dependency order (unifi-core → unifi-mcp-shared → app servers → relay → worker when…
Skill Claude CodeCodex
Activate this skill when adding a new manager, adding a new tool category, writing or debugging tool unit tests, diagnosing tool-visibility failures, investigating startup performance, or extending/maintaining/debugging the two-tier tool discovery system (toolindex) — even if the user doesn't explicitly ask about the…
Skill Claude CodeCodex
Use when adding, changing, or reviewing tool categories, tool parameters, or tool docstrings in unifi-mcp apps (apps/access, apps/network, apps/protect) whose behavior surfaces through generated artifacts: each app's generated tool manifest (e.g. apps/protect/src/unifiprotectmcp/toolsmanifest.json) and the plugin…
Skill Claude CodeCodex
Apply this skill whenever modifying, debugging, or extending UniFi client data retrieval in the unifi-mcp monorepo — even if the user doesn't explicitly ask about correctness or fallback behavior. Covers five permanent architectural fixtures of clients.py: (1) choosing the right endpoint (/stat/sta for live clients…
Plugin Claude Code
Plugin marketplace listing 3 plugins: unifi-network, unifi-protect, unifi-access.
Instructions file GitHub Copilot
Copilot instructions for sirkirby/unifi-mcp: AGENTS.md is the canonical source for repository architecture, golden paths, hard bans, and quality gates. CONTRIBUTING.md is the contributor-facing workflow. Do not duplicate or weaken either file here.
Skill Claude CodeCodex
Review UniFi MCP pull requests for architecture, controller-contract, cross-surface, security, test, release, and live-validation defects while preserving human merge authority.
Instructions file CodexOpenCode
AGENTS.md instructions for sirkirby/unifi-mcp, covering project rules, non-goals, architecture rules, layering and singletons.
Instructions file
Claude Code instructions for sirkirby/unifi-mcp: All project rules are in AGENTS.md. This file contains only Claude Code-specific behavior.
Plugin Claude Code
Skills that correlate events across UniFi Network, Protect, and Access for unified security and operational insights.
Skill Claude CodeCodex
Investigate a network incident by correlating device events with camera footage and physical access logs. Use when the user reports a device going offline, a network anomaly, or wants to understand what caused an infrastructure event.
Skill Claude CodeCodex
Show everything that happened at a specific area across all UniFi products (Network, Protect, Access) in a given time window. Use when the user asks about activity at a door, entrance, room, or area.
Skill Claude CodeCodex
Audit visitor activity by correlating Access badge scans with Network client connections. Use when the user wants to know who visited, when, and what devices they brought.
Plugin Claude Code
UniFi Access MCP server — manage door locks, credentials, visitors, and access policies.
MCP server Claude CodeCodexCursor +2
MCP server "unifi-access" as configured in sirkirby/unifi-mcp. Runs locally from the system Python package. Needs 13 environment variables to run.
Skill Claude CodeCodex
Configure the UniFi Access MCP server for Claude Code, Codex, or OpenClaw — set controller host, credentials, API key, and permissions.