Rhombus API MCP Server - Rhombus Developer Documentation

The Rhombus API MCP Server connects AI tools directly to your Rhombus security platform. Unlike the Documentation MCP (which searches docs), this server gives AI assistants the ability to take actions — list cameras, pull clips, manage doors, review alerts, and more — using your Rhombus API key.

This MCP server interacts with your live Rhombus environment. Actions taken through AI tools (unlocking doors, rebooting cameras, etc.) are real. Use with appropriate caution.

What You Can Do

The server provides 30+ tools organized by capability:

Cameras & Video

camera-tool — List cameras, get camera details, view status and health
clips-tool — Search and retrieve saved video clips (manual and policy-triggered)
video-walls-tool — Manage video wall configurations for multi-camera monitoring
reboot-cameras — Remotely reboot cameras
camera-uptime-tool — Check camera uptime and connectivity history

Access Control & Doors

access-control-tool — Manage access control systems, credentials, and users
door-tool — Lock, unlock, and monitor door status
door-schedule-exception-tool — Create and manage door schedule overrides
guest-management-tool — Manage guest access and visitor credentials

Security & Monitoring

alarm-monitoring-tool — Check monitoring status, manage threat cases
policy-alerts-tool — Review and dismiss policy-triggered alerts (motion, person detection, etc.)
events-tool — Query security events and activity logs
rules-tool — Manage automation rules and triggers

Analytics & Search

analytics-tool — Space utilization, traffic patterns, and real-time scene analysis
search-tool — Search across cameras, events, and entities
count-tool — People counting and occupancy data
faces-tool — Face recognition person lookup
lpr-tool — License plate recognition searches

Organization & Users

user-tool — Manage users and permissions
user-audit-tool — Review user activity audit trails
user-access-trail-tool — Track user access history
location-tool — Manage locations and site configuration
get-org-information — Retrieve organization details
report-tool — Generate and retrieve reports

Utilities

entity-lookup-tool — Look up any entity by UUID
get-entity-tool — Get detailed entity information
time-tool — Current time utilities
time-conversion-tool — Convert between time formats and timezones
update-tool — Update entity properties

Prerequisites

A Rhombus organization with API access enabled
An API key generated from the Rhombus Console
Node.js 18+ (for npx) or Docker (for container-based setup)

Setup

Claude Code
Claude Desktop (npx)
Claude Desktop (Docker)
Cursor
Smithery

Add the Rhombus MCP server with a single command:

claude mcp add rhombus -- npx --yes --package rhombus-node-mcp mcp-server-rhombus

Set your API key as an environment variable:

export RHOMBUS_API_KEY=YOUR_API_KEY

Verify by asking Claude Code:

"List all my Rhombus cameras"

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "rhombus": {
      "command": "npx",
      "args": ["--yes", "--package", "rhombus-node-mcp", "mcp-server-rhombus"],
      "env": {
        "RHOMBUS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

On macOS, this file is located at ~/Library/Application Support/Claude/claude_desktop_config.json

Run via Docker for an isolated environment:

{
  "mcpServers": {
    "rhombus": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "RHOMBUS_API_KEY=YOUR_API_KEY",
        "rhombussystems/mcp-server-rhombus"
      ],
      "env": {
        "RHOMBUS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Add to your Cursor MCP settings (Cmd+Shift+P → “Open MCP settings”):

{
  "mcpServers": {
    "rhombus": {
      "command": "npx",
      "args": ["--yes", "--package", "rhombus-node-mcp", "mcp-server-rhombus"],
      "env": {
        "RHOMBUS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Restart Cursor after saving.

Install automatically via Smithery:

npx -y @smithery/cli install @RhombusSystems/rhombus-node-mcp --client claude

Example Workflows

Monitor Your Cameras

Ask your AI assistant:

"Show me the status of all my cameras. Are any offline?"

The assistant uses the camera-tool to list cameras and check connectivity status.

Review Security Alerts

"What policy alerts happened in the last 24 hours? Show me the most critical ones."

The assistant uses policy-alerts-tool to query recent alerts and events-tool for details.

Manage Door Access

"Unlock the main entrance door for 30 seconds, then lock it again."

The assistant uses door-tool to control door locks in real time.

Search for Vehicles

"Has a red Toyota been seen in any camera in the last week?"

The assistant uses lpr-tool to search license plate recognition data across your cameras.

Generate a Report

"Give me a summary of foot traffic at the front entrance over the past month."

The assistant uses analytics-tool and count-tool for occupancy and traffic data.

Running Locally

To build and run from source:

Clone the repository

git clone https://github.com/RhombusSystems/rhombus-node-mcp.git
cd rhombus-node-mcp

Install dependencies

npm install

Build and run with Docker

docker build -t mcp-server-rhombus .

Then update your MCP config to use the local image name mcp-server-rhombus instead of rhombussystems/mcp-server-rhombus.

Contributing

The MCP server is open source (MIT license). You can create new tools using the built-in scaffolding:

npm run create:tool

This generates the boilerplate for a new tool in src/tools/.

Resources

GitHub Repository

Source code, issues, and contributions

npm Package

Package details and version history

Smithery

One-click installation for supported clients

Beta Feedback

Share feedback and help shape development

The Rhombus API MCP Server is in beta. For questions or issues, reach out to support@rhombus.com or visit rhombus.community.

Documentation Index

​What You Can Do

​Prerequisites

​Setup

​Example Workflows

​Monitor Your Cameras

​Review Security Alerts

​Manage Door Access

​Search for Vehicles

​Generate a Report

​Running Locally

​Contributing

​Resources

GitHub Repository

npm Package

Smithery

Beta Feedback

What You Can Do

Prerequisites

Setup

Example Workflows

Monitor Your Cameras

Review Security Alerts

Manage Door Access

Search for Vehicles

Generate a Report

Running Locally

Contributing

Resources