{"id":"linuxserver-unifi","name":"unifi","homepage":"https://hub.docker.com/r/linuxserver/unifi","repo_url":"https://hub.docker.com/r/linuxserver/unifi","category":"infrastructure","subcategories":[],"tags":["networking","home-lab","iot","unifi","automation","monitoring"],"what_it_does":"unifi is a client/library for interacting with UniFi (UniFi Network Controller / UniFi OS) devices and configuration via their APIs, typically to read controller/site/device state and perform supported management actions.","use_cases":["Monitor UniFi networks (sites, gateways, switches, access points)","Automate provisioning/changes for UniFi controller-managed equipment","Inventory and health checks for UniFi devices","Collect configuration/state for reporting and alerting"],"not_for":["Direct low-level device firmware flashing","High-scale multi-tenant SaaS integrations without a controller per tenant","Use where you need a formally versioned third-party public API contract (unless the project documents compatibility)"],"best_when":"You have a UniFi controller available and want to automate/read its managed topology and device status.","avoid_when":"You require a guaranteed stable external API contract with first-class auth/SDK support beyond what the UniFi controller provides.","alternatives":["UniFi Controller UI/API documentation","Community UniFi API wrappers for your chosen language","Direct UniFi Controller API calls from your own code"],"af_score":29.5,"security_score":44.5,"reliability_score":30.0,"package_type":"mcp_server","discovery_source":["docker_mcp"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:35:14.528502+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":false,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["UniFi controller login/session (controller credentials)","Controller token/session-based authentication (varies by implementation)"],"oauth":false,"scopes":false,"notes":"unifi libraries commonly rely on the UniFi Controller’s auth flow (e.g., username/password to obtain a session or API token). The exact auth method and any role/scope granularity depend on the library implementation and UniFi controller version."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"This is a software library/package; cost is mainly operational (your controller environment, hosting, and any subscriptions for UniFi hardware/software)."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":29.5,"security_score":44.5,"reliability_score":30.0,"mcp_server_quality":0.0,"documentation_accuracy":0.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":55.0,"rate_limit_clarity":10.0,"tls_enforcement":40.0,"auth_strength":60.0,"scope_granularity":20.0,"dependency_hygiene":50.0,"secret_handling":50.0,"security_notes":"Security posture depends on how you deploy the client and how the UniFi controller is configured. If the library supports direct controller credentials/session handling, treat controller credentials/tokens as secrets. Scope granularity is typically limited by UniFi’s authentication model rather than fine-grained OAuth-style scopes. TLS/enforcement may vary by deployment (controller may be reachable over HTTPS or not).","uptime_documented":0.0,"version_stability":45.0,"breaking_changes_history":40.0,"error_recovery":35.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["UniFi Controller/API behavior can differ by controller version and UniFi OS release; automation may need adaptation.","Auth/session lifetimes and controller connectivity issues may require re-auth or resilient client handling.","Rate limiting and transient controller errors may require retries/backoff (often not standardized across libraries).","Some UniFi endpoints/actions may be long-running or eventually consistent; polling may be necessary."]}}