rhombus-node-mcp 0.1.28 → 0.1.29

package/dist/api/events-tool-api.js

@@ -75,6 +75,71 @@ async function getAccessControlEventsForDoor(doorUuid, startTime, endTime, timeZ
     }
     return allEvents;
 }
+export async function getBrivoAccessControlEvents(startTime, endTime, timeZone, requestModifiers, sessionId) {
+    // Step 1: fetch Brivo integration config to get configured doors and their location UUIDs
+    const integrationResponse = await postApi({
+        route: "/integrations/accessControl/getBrivoIntegrationV2",
+        body: {},
+        modifiers: requestModifiers,
+        sessionId,
+    });
+    const brivoSettings = integrationResponse.orgIntegrationV2;
+    const integrationEnabled = brivoSettings?.enabled ?? false;
+    const doorInfoMap = brivoSettings?.doorInfoMap ?? {};
+    const brivoDoors = Object.entries(doorInfoMap)
+        .filter(([, info]) => info != null)
+        .map(([brivoDoornId, info]) => ({
+        brivoDoornId,
+        doorName: info.doorName ?? undefined,
+        locationUuid: info.locationUuid ?? undefined,
+    }));
+    if (brivoDoors.length === 0) {
+        return {
+            integrationEnabled,
+            brivoDoorsConfigured: 0,
+            brivoDoors: [],
+            events: [],
+        };
+    }
+    // Step 2: collect unique location UUIDs from configured Brivo doors
+    const locationUuids = [...new Set(brivoDoors.map(d => d.locationUuid).filter((id) => !!id))];
+    // Step 3: query CredentialReceivedEvents for each location
+    const MAX_LIMIT = 1000;
+    const allEvents = [];
+    await Promise.all(locationUuids.map(async (locationUuid) => {
+        const body = {
+            locationUuid,
+            typeFilter: ["CredentialReceivedEvent"],
+            ...(startTime ? { createdAfterMs: startTime } : {}),
+            ...(endTime ? { createdBeforeMs: endTime } : {}),
+            limit: MAX_LIMIT,
+        };
+        const response = await postApi({
+            route: "/component/findComponentEventsByLocation",
+            body,
+            modifiers: requestModifiers,
+            sessionId,
+        });
+        const mapped = (response.componentEvents || []).map(event => mapAccessControlEvent(event, timeZone));
+        allEvents.push(...mapped);
+    }));
+    allEvents.sort((a, b) => (b.timestampMs || 0) - (a.timestampMs || 0));
+    return {
+        integrationEnabled,
+        brivoDoorsConfigured: brivoDoors.length,
+        brivoDoors,
+        events: allEvents.map(e => ({
+            authenticationResult: e.authenticationResult ?? undefined,
+            authorizationResult: e.authorizationResult ?? undefined,
+            doorUuid: e.doorUuid ?? undefined,
+            locationUuid: e.locationUuid ?? undefined,
+            user: e.user ?? undefined,
+            credSource: e.credSource ?? undefined,
+            timestampMs: e.timestampMs ?? undefined,
+            datetime: e.datetime,
+        })),
+    };
+}
 export async function getFaceEvents(_locationUuid, timeZone, requestModifiers, sessionId) {
     const nowMs = Date.now();
     const rangeStartMs = nowMs - THREE_HOURS_MS;

package/dist/createServer.js

@@ -29,7 +29,7 @@ export default async function createServer() {
         version: "1.0.0",
     }, {
         capabilities: {
-            resources: {},
+            ...(resources.length > 0 ? { resources: {} } : {}),
             tools: {},
         },
     });

package/dist/tools/events-tool.js

@@ -1,4 +1,4 @@
-import { getAccessControlEvents, getEventsForEnvironmentalGateway, getClimateEventsForSensor, getComponentEventsByLocation, getHumanMotionEvents, getButtonPressEvents, getOccupancyEvents, getProximityEvents, getDoorbellEvents, } from "../api/events-tool-api.js";
+import { getAccessControlEvents, getBrivoAccessControlEvents, getEventsForEnvironmentalGateway, getClimateEventsForSensor, getComponentEventsByLocation, getHumanMotionEvents, getButtonPressEvents, getOccupancyEvents, getProximityEvents, getDoorbellEvents, } from "../api/events-tool-api.js";
 import { EventsToolRequestType, OUTPUT_SCHEMA, TOOL_ARGS, } from "../types/events-tools-types.js";
 import { createToolStructuredContent } from "../util.js";
 import { getLogger } from "../logger.js";
@@ -9,7 +9,27 @@ const TOOL_NAME = "events-tool";
 const TOOL_DESCRIPTION = `
 **Scope:** This tool returns **raw, event-level data** (individual events with timestamps). Use **report-tool** when you need aggregated counts, time-series summaries, or analytics over intervals.
 
-This tool has 5 modes, set by "eventType": access-control, environmental-gateway, climate-sensor, component-events, camera. Use it when the user asks for specific events (unlocks, badge ins, credentials, arrivals, environmental readings, climate data, camera motion, or other component events). It can return large result sets; keep time ranges narrow. For ranges spanning more than ~24 hours, prefer report-tool for aggregates. For maximum flexibility across event types at a location, use eventType "component-events".
+This tool has multiple modes, set by "eventType": access-control, brivo-access-control, environmental-gateway, climate-sensor, component-events, camera. Use it when the user asks for specific events (unlocks, badge ins, credentials, arrivals, environmental readings, climate data, camera motion, or other component events). It can return large result sets; keep time ranges narrow. For ranges spanning more than ~24 hours, prefer report-tool for aggregates. For maximum flexibility across event types at a location, use eventType "component-events".
+
+---
+
+When eventType is "brivo-access-control":
+
+Retrieves badge/credential events from Brivo-integrated doors. Automatically fetches the Brivo integration configuration to determine which locations have Brivo doors mapped. No door UUIDs are required.
+
+Use this when the user asks specifically about Brivo events, Brivo badge ins, Brivo access control, or events from Brivo doors.
+
+Arguments:
+  * **startTime (string):** Start of the time range (ISO 8601).
+  * **endTime (string):** End of the time range (ISO 8601).
+
+Returns:
+  * **integrationEnabled:** Whether the Brivo integration is currently enabled.
+  * **brivoDoorsConfigured:** Number of Brivo doors configured in the integration.
+  * **brivoDoors:** List of Brivo doors with their IDs, names, and associated Rhombus location UUIDs.
+  * **events:** Credential received events from all locations that have Brivo doors configured, sorted newest first.
+
+Note: Events are fetched at the location level, so results may include events from all access-controlled doors at locations where Brivo is configured.
 
 ---
 
@@ -92,6 +112,13 @@ const TOOL_HANDLER = async (args, extra) => {
     const { eventType, accessControlledDoorUuids, deviceUuid, sensorUuid, locationUuid, componentEventTypes, startTime, endTime, limit, timeZone, tempUnit, cameraUuid, duration, buttonSensorUuid, occupancySensorUuid, proximityTagUuids, doorbellCameraUuid, } = args;
     logger.debug(`eventType: ${eventType}`);
     switch (eventType) {
+        case EventsToolRequestType.BRIVO_ACCESS_CONTROL: {
+            const result = await getBrivoAccessControlEvents(startTime ? new Date(startTime).getTime() : undefined, endTime ? new Date(endTime).getTime() : undefined, timeZone, extra._meta?.requestModifiers, extra.sessionId);
+            return createToolStructuredContent({
+                eventType: "brivo-access-control",
+                brivoAccessControlEvents: result,
+            });
+        }
         case "access-control": {
             if (!accessControlledDoorUuids || accessControlledDoorUuids.length === 0) {
                 return createToolStructuredContent({

package/dist/types/access-control-tool-types.js

@@ -13,7 +13,7 @@ export var AccessControlRequestType;
     AccessControlRequestType["GET_REMOTE_UNLOCK_USERS"] = "get-remote-unlock-users";
 })(AccessControlRequestType || (AccessControlRequestType = {}));
 export const TOOL_ARGS = {
-    requestType: z.enum(AccessControlRequestType).describe("The type of access control request to make."),
+    requestType: z.nativeEnum(AccessControlRequestType).describe("The type of access control request to make."),
     doorUuid: z
         .string()
         .nullable()

package/dist/types/events-tools-types.js

@@ -6,6 +6,7 @@ import { TempUnit } from "../utils/temp.js";
 export var EventsToolRequestType;
 (function (EventsToolRequestType) {
     EventsToolRequestType["ACCESS_CONTROL"] = "access-control";
+    EventsToolRequestType["BRIVO_ACCESS_CONTROL"] = "brivo-access-control";
     EventsToolRequestType["ENVIRONMENTAL_GATEWAY"] = "environmental-gateway";
     EventsToolRequestType["CLIMATE_SENSOR"] = "climate-sensor";
     EventsToolRequestType["COMPONENT_EVENTS"] = "component-events";
@@ -20,6 +21,7 @@ export const TOOL_ARGS = {
         .nativeEnum(EventsToolRequestType)
         .describe("The type of events to retrieve. " +
         "access-control: Access control events like unlocks, badge ins, credentials, arrivals. " +
+        "brivo-access-control: Badge/credential events from Brivo-integrated doors. Does not require door UUIDs — automatically looks up which doors are configured via the Brivo integration. " +
         "environmental-gateway: Environmental gateway events with sensor readings and derived values. " +
         "climate-sensor: Climate sensor events with temperature, humidity, air quality readings. " +
         "component-events: All types of component events for a location (most flexible option). " +
@@ -143,6 +145,7 @@ export const OUTPUT_SCHEMA = z.object({
     eventType: z
         .enum([
         "access-control",
+        "brivo-access-control",
         "environmental-gateway",
         "climate-sensor",
         "component-events",
@@ -153,6 +156,52 @@ export const OUTPUT_SCHEMA = z.object({
         "doorbell",
     ])
         .optional(),
+    brivoAccessControlEvents: z.optional(z
+        .object({
+        integrationEnabled: z.boolean().describe("Whether the Brivo integration is enabled"),
+        brivoDoorsConfigured: z
+            .number()
+            .describe("Number of Brivo doors configured in the integration"),
+        brivoDoors: z
+            .array(z.object({
+            brivoDoornId: z.string().describe("Brivo's door ID"),
+            doorName: z.string().optional().describe("Brivo door name"),
+            locationUuid: z.string().optional().describe("Rhombus location UUID for this door"),
+        }))
+            .describe("List of Brivo doors configured in the integration"),
+        events: z
+            .array(z.object({
+            authenticationResult: z
+                .string()
+                .optional()
+                .describe("The result of the authentication process"),
+            authorizationResult: z
+                .string()
+                .optional()
+                .describe("The result of the authorization process"),
+            doorUuid: z
+                .string()
+                .optional()
+                .describe("The Rhombus access controlled door UUID"),
+            locationUuid: z
+                .string()
+                .optional()
+                .describe("The Rhombus location UUID where the event occurred"),
+            user: z.string().optional().describe("Username of the person who triggered the event"),
+            credSource: z
+                .string()
+                .optional()
+                .describe("The source of the credential (e.g. WIEGAND, NFC, BLE_WAVE, REMOTE)"),
+            timestampMs: z
+                .number()
+                .optional()
+                .describe("Timestamp in milliseconds when the event occurred"),
+            datetime: z.string().optional().describe("Formatted datetime string of the event"),
+        }))
+            .describe("Credential received events from locations that have Brivo doors configured, sorted by timestamp (newest first)"),
+    })
+        .nullable()
+        .describe("Brivo access control events. Fetches credential events from all locations that have Brivo doors configured in the integration.")),
     accessControlEvents: z.optional(z
         .array(z.object({
         authenticationResult: z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rhombus-node-mcp",
-  "version": "0.1.28",
+  "version": "0.1.29",
   "description": "MCP server for Rhombus API",
   "keywords": [
     "ai",