Nexus MCP Server

Retrieve a customer record. Details for contact information and location information.

Organization profile, list of all customers, and a site count. This is only available to organization administrators.

List of every customer under your organization — ID, name, abbreviation, industry. This is only available to organization administrators.

List of sites visible to your access level. Organization administrators see every site and can optionally narrow by customer; while customer access can only see their own.

Detailed information about a specific site. Organization administrators can look up any site in the organization; customers can only see their own sites.

Query across every device you have access to — HVAC units, meters, cold storage sensors, lighting, refrigeration, generators. Filter by site, category, status, network, make/model, location, or the Nexus Device they are connected to.

Schedule history for one device — every time a schedule was set, with full schedule details (name, type, days, store hours, date range). Identify by your deviceId or the Nexus Device they are connected to. Most recent first; default limit 50.

Live, current settings from any of your devices. Inspects and returns the current state of all configurable settings for a device — HVAC, lighting, refrigeration, generators. Identify by your deviceId or the Nexus Device they are connected to. Meters are read-only and will return an empty settings object.

Current status, real-time monitoring, temperature trends, supply/return differentials, and setpoint deviation for every HVAC unit.

Runtime hours by stage, efficiency scoring, cycling pattern analysis, and runtime trends — detects short-cycling and uneven load sharing.

Efficiency metrics, energy consumption estimates, and cost calculations with configurable utility rates.

Indoor air quality scoring, humidity and CO2 monitoring, thermal comfort metrics, and PPD / PMV-style comfort analysis.

Damper control analysis, economizer performance, and ASHRAE compliance checking — find units running outside spec.

Maintenance alerts, failure prediction, anomaly detection, and health scoring — surface issues before they cause downtime.

Multi-site comparison, benchmarking, and executive summary dashboards across your portfolio. Customer scope or higher.

Occupancy patterns, schedule optimization, degree-day analytics, hourly dashboards, data quality, and connectivity health.

Real-time power monitoring, consumption trends with configurable binning, and current load readings across all meters.

Voltage quality analysis, power factor scoring, THD, and phase imbalance detection. Supports single-phase, 3-phase wye, and delta with wild-leg.

Peak demand analysis, demand patterns, interval-based demand calculations, forecasting, and site-level aggregation with device breakdowns.

Energy breakdown by phase, cost analysis with configurable rates, and efficiency metrics for every meter in scope.

Anomaly detection, predictive maintenance, connectivity checks, and data-quality auditing to keep meter data trustworthy.

Hourly dashboards, executive summaries, and raw-telemetry dumps — ready-to-share reports for stakeholders.

Raw telemetry, analytics, FDA alerts, danger-zone detection (41–135°F), and location summaries for freezers and coolers.

Compliance summaries, health metrics, violation rollups, cross-site comparison, trends, and a full dashboard combining all views in one call.

Working-level sensor telemetry — raw rows, per-bin stats, last-reading lookups, value-based filtering, out-of-range detection, and sensor discovery. Eleven analysis types over temperature, humidity, CO2, pressure, and more.

Executive sensor dashboards — system health, critical alerts, real-time operational metrics, trends, geographic and device-type rollups, and a flexible multi-field groupBy aggregation.

Query active alarms with flexible filters — customer, site, device, severity, category, alarm code, source, or state. Supports countOnly for dashboards.

Acknowledge, clear, escalate, suppress, assign, or comment on an alarm. An optional comment can attach to any command.

Push setting changes to a connected device (HVAC, lighting, generator). Apply new settings for one device or at bulk, based on your criteria.

Start an automated HVAC/RTU equipment test on one device. Stages come from the configured test template; rejected if a test is already running. Technician category.

Abort a running test by testId, or the latest active test on a device. Only tests that are In Progress or Pending can be aborted. Technician category.

Read equipment test status and results by testId, device (IMEI / deviceId), or site. Results are automatically scoped to your license key.

List tests for your customer/sites with filters — status, failed-only, repair-flagged, cleanup-incomplete, date range, make/model — to browse and pick the test you want. Filtering on cleanup-incomplete surfaces units whose settings may not have been restored after testing.

Aggregate tests with a GROUP BY count — per status, per site, by result, by make — for quick fleet roll-ups.

Log a manual test result or issue for one device — notes, issue description, and an optional repair flag. Creates a Reported test record.

Turn Markdown or HTML content into a NexRev-branded report, saved and returned as a time-limited download link (light and dark themes).

Server-built reports from your data by type — equipment test, FDA cold-storage compliance, or HVAC worst-performer scorecard — returned as download links.