cu4d-mcp

MCP (Model Context Protocol) server for ControlUp DEX device and application data.

Installation

npm install cu4d-mcp

Configuration

Set environment variables:

DEX_API_KEY=your-api-key
DEX_API_URL=https://your-dex-api-endpoint/cu4d-dal-mcp

Or use a config file (config/local.json5):

{
  dexPapi: {
    baseUrl: "https://your-dex-api-endpoint/cu4d-dal-mcp",
    apiKey: "your-api-key"
  }
}

Available Tools (28 total)

Device Tools (8)

| Tool | Description | |------|-------------| | list_devices | List devices with filtering, sorting, and DEX scores | | get_device_metadata | Get device basic info (name, platform, group) | | get_device_agent_info | Get agent version and features | | get_device_os_hardware | Get OS and hardware details | | get_device_users | Get user and session info | | get_device_network | Get network and location info | | get_device_performance | Get CPU, memory, disk metrics | | get_device_apps | Get app stability metrics |

History Tools (5)

| Tool | Description | |------|-------------| | get_device_performance_history | Historical performance metrics | | get_device_network_history | Historical network metrics | | get_device_score_history | Historical DEX scores | | get_device_stability_history | Historical crashes/freezes/hangs | | get_device_users_history | Historical user activity |

Application & Event Tools (4)

| Tool | Description | |------|-------------| | list_applications | List installed applications | | get_application_crashes | Get crash statistics by app | | compare_application_versions | Compare version crash rates | | get_win_event_logs | Get Windows event logs |

Process Tools (3)

| Tool | Description | |------|-------------| | get_device_high_resource_processes | Per-device high CPU/memory processes | | get_device_process_history | Per-device process lifecycle history | | get_fleet_high_resource_processes | Fleet-wide high resource process analysis |

Fleet Analysis Tools (6)

| Tool | Description | |------|-------------| | get_bsod_analysis | BSOD analysis with bugcheck codes and patterns | | get_app_usage_analysis | Application usage/focus time analysis | | get_isp_latency_analysis | ISP latency patterns by provider/region | | get_dex_score_analysis | Historical DEX score root cause analysis | | get_script_execution_stats | Script execution analytics | | get_ucc_session_analysis | Teams/Zoom call quality analysis | | get_logon_duration_analysis | Windows logon duration breakdown |

Aggregation & Query Tools (2)

| Tool | Description | |------|-------------| | aggregate_data | Fleet-wide aggregations (count, avg, sum, min, max, percentiles, cardinality) | | execute_custom_query | Run custom Elasticsearch queries (last resort) |

Architecture

Index metadata is centralized in a single registry (src/registry/index-registry.ts). All Zod schemas, tool descriptions, and documentation are auto-generated from this registry. When adding or modifying an index/field, update only the registry.

Usage with Cursor

Add to your MCP settings:

{
  "mcpServers": {
    "cu4d": {
      "command": "npx",
      "args": ["cu4d-mcp"],
      "env": {
        "DEX_API_KEY": "your-api-key",
        "DEX_API_URL": "https://your-endpoint/cu4d-dal-mcp"
      }
    }
  }
}

Usage with Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "cu4d": {
      "command": "npx",
      "args": ["cu4d-mcp"],
      "env": {
        "DEX_API_KEY": "your-api-key",
        "DEX_API_URL": "https://your-endpoint/cu4d-dal-mcp"
      }
    }
  }
}

License

Proprietary - ControlUp