rhombus-node-mcp 0.1.27 → 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/api/get-entity-tool-api.js

@@ -3,23 +3,25 @@ import { postApi } from "../network/network.js";
 import { formatTimestamp } from "../util.js";
 import { tempFunc } from "../utils/temp.js";
 export async function getCameraList(requestModifiers, sessionId) {
+    const body = await postApi({
+        route: "/camera/getMinimalCameraStateList",
+        body: {},
+        modifiers: requestModifiers,
+        sessionId,
+    });
     return {
-        cameras: (await postApi({
-            route: "/camera/getMinimalCameraStateList",
-            body: {},
-            modifiers: requestModifiers,
-            sessionId,
-        })).cameraStates.filter((camera) => !!camera.locationUuid),
+        cameras: (body.cameraStates ?? []).filter((camera) => !!camera.locationUuid),
     };
 }
 export async function getDoorbellCameras(requestModifiers, sessionId) {
+    const body = await postApi({
+        route: "/doorbellcamera/getMinimalStateList",
+        body: {},
+        modifiers: requestModifiers,
+        sessionId,
+    });
     return {
-        doorbellCameras: (await postApi({
-            route: "/doorbellcamera/getMinimalStateList",
-            body: {},
-            modifiers: requestModifiers,
-            sessionId,
-        })).minimalStates.filter((doorbellCamera) => !!doorbellCamera.locationUuid),
+        doorbellCameras: (body.minimalStates ?? []).filter((doorbellCamera) => !!doorbellCamera.locationUuid),
     };
 }
 export async function getBadgeReaders(requestModifiers, sessionId) {
@@ -30,7 +32,7 @@ export async function getBadgeReaders(requestModifiers, sessionId) {
         sessionId,
     }).then((response) => {
         return {
-            badgeReaders: response.minimalStates.filter((badgeReader) => !!badgeReader.locationUuid),
+            badgeReaders: (response.minimalStates ?? []).filter((badgeReader) => !!badgeReader.locationUuid),
         };
     });
 }
@@ -65,7 +67,7 @@ export async function getAudioGateways(timeZone, requestModifiers, sessionId) {
         sessionId,
     }).then((response) => {
         return {
-            audioGateways: response.audioGatewayStates
+            audioGateways: (response.audioGatewayStates ?? [])
                 .filter((camera) => !!camera.locationUuid)
                 .map((gateway) => ({
                 ...gateway,
@@ -84,7 +86,7 @@ export async function getDoorSensors(requestModifiers, sessionId) {
         sessionId,
     }).then((response) => {
         return {
-            doorStates: response.doorStates.filter((door) => !!door.locationUuid),
+            doorStates: (response.doorStates ?? []).filter((door) => !!door.locationUuid),
         };
     });
 }
@@ -97,7 +99,7 @@ export async function getEnvironmentalSensors(timeZone, tempUnit, requestModifie
     }).then((response) => {
         logger.info("Using tempUnit: ", tempUnit);
         return {
-            climateStates: response.climateStates
+            climateStates: (response.climateStates ?? [])
                 .filter((sensor) => !!sensor.locationUuid)
                 .map((_sensor) => {
                 const { temperatureCelcius, ...sensor } = _sensor;
@@ -120,7 +122,7 @@ export async function getMotionSensors(requestModifiers, sessionId) {
         sessionId,
     }).then((response) => {
         return {
-            occupancySensorStates: response.occupancySensorStates.filter((occupancySensor) => !!occupancySensor.locationUuid),
+            occupancySensorStates: (response.occupancySensorStates ?? []).filter((occupancySensor) => !!occupancySensor.locationUuid),
         };
     });
 }
@@ -132,7 +134,7 @@ export async function getButtons(timeZone, requestModifiers, sessionId) {
         sessionId,
     }).then((response) => {
         return {
-            buttonStates: response.states
+            buttonStates: (response.states ?? [])
                 .filter((button) => !!button.locationUuid)
                 .map((button) => ({
                 ...button,
@@ -151,7 +153,7 @@ export async function getKeypads(requestModifiers, sessionId) {
         sessionId,
     }).then((response) => {
         return {
-            keypadStates: response.keypads.filter((keypad) => !!keypad.locationUuid),
+            keypadStates: (response.keypads ?? []).filter((keypad) => !!keypad.locationUuid),
         };
     });
 }
@@ -163,7 +165,7 @@ export async function getEnvironmentalGateways(timeZone, requestModifiers, sessi
         sessionId,
     }).then((response) => {
         return {
-            minimalEnvironmentalGatewayStates: response.minimalEnvironmentalGatewayStates
+            minimalEnvironmentalGatewayStates: (response.minimalEnvironmentalGatewayStates ?? [])
                 .filter((gateway) => !!gateway.locationUuid)
                 .map((gateway) => ({
                 ...gateway,

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/logger.js

@@ -17,7 +17,7 @@ catch (error) {
 const appenders = {
     // stderr for terminal visibility (always available)
     stderr: { type: "stderr" },
-    // only send warn+ to stderr (never stdout)
+    // production stderr: hide trace/debug (e.g. full response snippets); still shows info+ like [POSTAPI] REQUEST
     stderrInfo: {
         type: "logLevelFilter",
         appender: "stderr",
@@ -36,7 +36,8 @@ if (fileLoggingEnabled) {
         layout: { type: "basic" },
     };
 }
-const stderrAppender = process.env.DEBUG === "true" ? "stderr" : "stderrInfo";
+const isProduction = process.env.NODE_ENV === "production";
+const stderrAppender = isProduction ? "stderrInfo" : "stderr";
 // Configure categories based on available appenders
 const categories = {
     default: {

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/tools/get-entity-tool.js

@@ -14,7 +14,9 @@ includes a "connected" boolean field indicating whether it is currently online (
 When asked about device health, offline devices, or connectivity issues, use this tool to fetch all device
 types and check the "connected" field to identify which devices are offline or unreachable.`;
 const TOOL_HANDLER = async (args, extra) => {
-    const { entityTypes, timeZone, filterBy, tempUnit } = args;
+    const { entityTypes, timeZone, tempUnit } = args;
+    const filterBy = args.filterBy ?? { locationUuids: null };
+    const locationFilter = filterBy.locationUuids;
     const { requestModifiers, sessionId } = extractFromToolExtra(extra);
     const promises = [];
     if (entityTypes.includes(DeviceType.CAMERA)) {
@@ -61,8 +63,10 @@ const TOOL_HANDLER = async (args, extra) => {
                 // then filter
                 response[key] = value.filter((item) => {
                     let pass = true;
-                    if (item.locationUuid && filterBy.locationUuids && filterBy.locationUuids.length > 0) {
-                        pass = pass && filterBy.locationUuids.includes(item.locationUuid);
+                    if (item.locationUuid &&
+                        locationFilter &&
+                        locationFilter.length > 0) {
+                        pass = pass && locationFilter.includes(item.locationUuid);
                     }
                     return pass;
                 });

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/dist/types/get-entity-tool-types.js

@@ -2,18 +2,21 @@ import { z } from "zod";
 import { createUuidSchema } from "../types.js";
 import DeviceType from "./deviceType.js";
 import { TempUnit } from "../utils/temp.js";
+const filterByObjectSchema = z.object({
+    locationUuids: z
+        .array(createUuidSchema())
+        .nullish()
+        .describe("The UUIDs of the locations to filter by. Set to null or an empty array to not filter by location."),
+});
 export const TOOL_ARGS = {
     entityTypes: z
         .array(z.nativeEnum(DeviceType).describe("The entity type to retreive"))
         .describe("What type of entities to retrieve."),
     filterBy: z
-        .object({
-        locationUuids: z
-            .array(createUuidSchema())
-            .nullable()
-            .describe("The UUIDs of the locations to filter by. Set to null or an enmpty array to not filter by location."),
-    })
-        .describe("Additional filters that can be applied to the result."),
+        .union([filterByObjectSchema, z.null()])
+        .optional()
+        .transform((v) => v ?? { locationUuids: null })
+        .describe("Additional filters that can be applied to the result. Omit or pass null for no filtering."),
     timeZone: z
         .string()
         .describe("The timezone for formatting timestamps. This is necessary for the tool to produce accurate formatted timestamps."),

package/package.json

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