Skip to content

MCP / AI Integration

KVM Fleet exposes a Model Context Protocol (MCP) server, allowing AI assistants like Claude to query your fleet.

Available tools

The MCP server provides 5 read-only tools:

Tool Description
list_devices List all devices with status, tags, and last-seen time
get_device_health Get health metrics for a specific device (uptime, CPU, memory, agent version)
query_audit_log Search audit log entries by date range, event type, or actor
verify_audit_integrity Verify the SHA-256 hash chain for a date range
list_open_console_sessions List currently active console sessions

All tools are read-only. The MCP server cannot modify devices, users, or settings.

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "kvmfleet": {
      "command": "npx",
      "args": ["-y", "@kvmfleet/mcp-server"],
      "env": {
        "KVMFLEET_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add kvmfleet -- npx -y @kvmfleet/mcp-server

Set the API key in your environment:

export KVMFLEET_API_KEY=your-api-key

Generate an API key

  1. Go to Settings > API Keys in the dashboard
  2. Click Create key
  3. Copy the key (it's only shown once)

Example prompts

Once connected, you can ask your AI assistant:

  • "Are any KVM devices offline right now?"
  • "Show me the audit log for the last 24 hours"
  • "Verify the audit chain integrity for March 2026"
  • "Who has open console sessions right now?"
  • "What's the health status of device DC1-R3-S7?"

Security

  • The MCP server authenticates with your API key
  • All tools are read-only — no state mutations possible
  • Data access respects your organization's RLS boundaries
  • API keys can be revoked instantly from the dashboard