visitor-audit

Correlate Access badge scans with Network client connections to audit visitor activity.

777|101|Updated Apr 21, 2025
One-click install
npx skills add https://github.com/sirkirby/unifi-network-mcp --skill visitor-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visitor-audit
Source: https://github.com/sirkirby/unifi-network-mcp/tree/main/plugins/cross-product/skills/visitor-audit
Command: npx skills add https://github.com/sirkirby/unifi-network-mcp --skill visitor-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Determining who physically visited a site and which devices they connected requires manually cross-referencing door access logs with network client records, which is slow and error-prone.

Core Features & Use Cases

  • Timeline Correlation: Queries the unified location timeline for Access badge_scan events and Network client_connect events within a given time window.
  • Visitor-to-Device Matching: Matches badge-in times with new network client connections to identify which guest devices appeared during each visit.
  • Visitor Log Reporting: Produces a structured log showing who visited, when, how long they stayed, and what devices they connected.
  • Use Case: Ask for a visitor audit of the past 24 hours to see every badge-in event alongside the guest devices that joined the network during each visit, flagging unusual device activity.

Quick Start

Ask the assistant to audit visitors for today by correlating badge scans with network client connections and listing the devices each visitor brought.

Frequently Asked Questions about visitor-audit

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

FAQPage Schema
How do I audit visitor activity across door access and Wi-Fi networks?

Query the unified location timeline for Access badge_scan events and Network client_connect events in the same time window, then match badge-in times with new client connections. This produces a visitor log showing who came, when, and which devices they brought.

How to correlate badge scans with network client connections in UniFi?

Filter the unifi_location_timeline for badge_scan and client_connect events, then align timestamps so each badge-in is paired with devices that joined the network during that visit window. The result links physical entry to guest device activity.

Does visitor auditing require both UniFi Access and Network servers?

The Access server is required as the primary source of visitor badge-in logs. The Network server is optional but adds device correlation, showing which client devices appeared during each visit.

What time windows can I use for a visitor audit?

Any natural-language window such as today, this week, or the past 24 hours works. The skill filters timeline events to that window before correlating badge scans with client connections.

Why are no devices shown for some visitor badge-ins?

A visitor may not have connected any device to the network during their visit, or the Network server may not be connected. Without the Network server, only badge-in events from the Access server are reported.