guest-management-tool
Retrieve guest lists with check-in status, activity logs, and sign-in records filtered by location and time range.
Instructions
This tool manages Rhombus guest/visitor operations. It can list all guests, retrieve activity logs, and filter activities by location.
It has the following modes of operation, determined by the "requestType" parameter:
get-all-guests: List all guests across the organization with their check-in status, host, company, and contact info.
get-activity-logs: Get org-wide guest activity logs (sign-ins, sign-outs). Supports optional time range filtering via startTimeMs/endTimeMs.
get-activities-for-location: Get guest activity logs for a specific location. Requires locationUuid. Supports optional time range filtering.
Output filtering (all tools):
includeFields(string[]): Dot-notation paths to keep in the response (e.g."vehicleEvents.vehicleLicensePlate"). Omit to return all fields.filterBy(array): Predicates to filter array items. Each entry:{field, op, value}where op is one of= != > >= < <= contains. All conditions are ANDed. Example:[{field:"vehicleLicensePlate", op:"=", value:"ABC123"}]WARNING: some tool responses exceed 400k characters — use these params to request only the data you need.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| requestType | Yes | The type of guest management request to make. | |
| locationUuid | Yes | Location UUID. Required for 'get-activities-for-location'. | |
| startTimeMs | Yes | Start time filter in milliseconds since epoch. Optional for activity queries. | |
| endTimeMs | Yes | End time filter in milliseconds since epoch. Optional for activity queries. | |
| includeFields | Yes | Dot-notation field paths to include in the response (e.g. "vehicleEvents.vehicleLicensePlate"). Pass null to return all fields. WARNING: some responses can exceed 400k characters — use includeFields to request only the data you need. For high-volume tools this may be required to get a complete answer. | |
| filterBy | Yes | Filter array items in the response by field values. All conditions are ANDed. Example: [{field: "vehicleLicensePlate", op: "=", value: "ABC123"}, {field: "confidence", op: ">", value: 0.8}] Use alongside includeFields to get only the specific records and fields you need. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| guests | No | List of guests in the organization | |
| activities | No | List of guest activity log entries | |
| error | No | An error message if the request failed. |