@plexushq/mcp-server

MCP (Model Context Protocol) server for Plexus — the HardwareOps platform for physical systems. Manage your device fleet, query telemetry, set up alerts, and create dashboards from Claude Code, Cursor, or any MCP-compatible AI assistant.

Quick Start

npx @plexushq/mcp-server setup

This opens your browser, logs you into Plexus, creates an API key, and configures your AI editor (Claude Code, Cursor, VS Code) — all in one step.

Manual Setup

If you prefer to configure manually:

1. Get your API key from Settings > API Keys
2. Add to your AI assistant:

Claude Code:

claude mcp add plexus \
  -e PLEXUS_API_KEY=plx_your_key_here \
  -- npx @plexushq/mcp-server

Cursor / VS Code — add to MCP settings:

{
  "mcpServers": {
    "plexus": {
      "command": "npx",
      "args": ["@plexushq/mcp-server"],
      "env": {
        "PLEXUS_API_KEY": "plx_your_key_here"
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | PLEXUS_API_KEY | Yes | — | Your Plexus API key (Settings > API Keys) | | PLEXUS_URL | No | https://app.plexus.company | Plexus instance URL |

Available Tools

Devices

• plexus_list_devices — List all devices with status/search filters
• plexus_get_device_status — Get detailed device status and metadata
• plexus_get_device_schema — Get discovered metric schema for a device
• plexus_classify_device — AI-classify device type from metrics
• plexus_send_command — Send a command to a connected device

Telemetry

• plexus_query_metrics — Query time-series telemetry data
• plexus_ingest — Push data points to Plexus

Alerts & Monitoring

• plexus_list_alerts — List alerts with filters
• plexus_acknowledge_alert — Acknowledge an alert
• plexus_run_rca — Run AI root cause analysis on an alert
• plexus_create_monitor — Create a threshold monitor

Dashboards

• plexus_list_dashboards — List all dashboards
• plexus_create_dashboard — Create a dashboard with panels

Available Resources

• plexus://devices — All devices with current status
• plexus://alerts/active — Currently open alerts
• plexus://dashboards — All dashboards

Agent Skills

This package includes Agent Skills in the skills/ directory. These provide structured instructions that help AI agents use Plexus effectively — intent routing, step-by-step workflows, and reference documentation.

Examples

"List all my online devices"
"What alerts are currently open?"
"Show me the temperature data for drone-001 over the last hour"
"Create a monitor on drone-001 battery that alerts below 20%"
"Run root cause analysis on the latest critical alert"
"Create a dashboard for my weather station with temperature, humidity, and pressure"

Development

git clone https://github.com/plexus-company/mcp-server.git
cd mcp-server
npm install
npm run build

Run locally:

PLEXUS_API_KEY=plx_... node dist/index.js

License

MIT