npm package: @plexushq/mcp-server
Description: MCP server for Plexus — manage your device fleet from any AI assistant
Latest version: 0.1.8

# @plexushq/mcp-server

MCP ([Model Context Protocol](https://modelcontextprotocol.io)) server for [Plexus](https://plexus.company) — 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

```bash
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](https://app.plexus.company/settings/api-keys)
2. Add to your AI assistant:

**Claude Code:**
```bash
claude mcp add plexus \
  -e PLEXUS_API_KEY=plx_your_key_here \
  -- npx @plexushq/mcp-server
```

**Cursor / VS Code** — add to MCP settings:
```json
{
  "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](https://agentskills.io) 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

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

Run locally:

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

## License

MIT