Package Exports

@access-mcp/xdmod
@access-mcp/xdmod/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@access-mcp/xdmod) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

XDMoD MCP Server

MCP server for public XDMoD data: charts, visualizations, metadata discovery, and dimension values from the XDMoD (XD Metrics on Demand) Usage Analytics API.

Usage Examples

Charts & Visualizations

"CPU hours chart for January 2024 (PNG)"
"Job count data for last 30 days"
"GPU usage SVG chart grouped by resource"
"Average wait time visualization for Q1 2024"

Portal Links

"XDMoD portal link for CPU hours chart"
"Interactive GPU usage view in portal"
"Job count chart link for Bridges-2"

Tools

`get_chart_data`

Get chart data and metadata for a specific statistic.

Parameters:

Parameter	Type	Description
`realm`	string	The realm (e.g., "Jobs")
`group_by`	string	The group by field (e.g., "none")
`statistic`	string	The statistic name (e.g., "total_cpu_hours")
`start_date`	string	Start date (YYYY-MM-DD)
`end_date`	string	End date (YYYY-MM-DD)
`dataset_type`	string	Dataset type (default: "timeseries")

`get_chart_image`

Get chart image (SVG, PNG, or PDF) for a specific statistic.

Parameters:

Parameter	Type	Description
`realm`	string	The realm (e.g., "Jobs")
`group_by`	string	The group by field (e.g., "none")
`statistic`	string	The statistic name (e.g., "total_cpu_hours")
`start_date`	string	Start date (YYYY-MM-DD)
`end_date`	string	End date (YYYY-MM-DD)
`format`	string	Image format: "svg", "png", or "pdf" (default: "svg")
`width`	number	Image width in pixels (default: 916)
`height`	number	Image height in pixels (default: 484)
`dataset_type`	string	Dataset type (default: "timeseries")

`get_chart_link`

Generate a direct link to view the chart in the XDMoD portal.

Parameters:

Parameter	Type	Description
`realm`	string	The realm (e.g., "Jobs", "SUPREMM")
`group_by`	string	The group by field (e.g., "none", "resource")
`statistic`	string	The statistic name (e.g., "total_cpu_hours", "gpu_time")

Understanding Realms

XDMoD organizes metrics into different realms:

Jobs Realm

Basic job accounting and resource usage metrics:

total_cpu_hours - Total CPU Hours
job_count - Number of Jobs Ended
avg_cpu_hours - Average CPU Hours per Job
total_waitduration_hours - Total Wait Duration Hours
avg_waitduration_hours - Average Wait Duration Hours
max_processors - Maximum Processor Count
total_ace - ACCESS Credit Equivalents Charged
utilization - ACCESS CPU Utilization

SUPREMM Realm

Detailed performance analytics and system metrics:

gpu_time - GPU Hours: Total
avg_percent_gpu_usage - Avg GPU usage
wall_time - CPU Hours: Total
cpu_time_user - CPU Hours: User: Total
avg_percent_cpu_user - Avg CPU %: User
avg_flops_per_core - Avg FLOPS: Per Core
avg_memory_per_core - Avg Memory: Per Core
avg_ib_rx_bytes - Avg InfiniBand rate: Per Node

Note: For GPU metrics, always use the SUPREMM realm.

Installation

npm install -g @access-mcp/xdmod

Configuration

{
  "mcpServers": {
    "xdmod": {
      "command": "npx",
      "args": ["@access-mcp/xdmod"]
    }
  }
}

No authentication required - the server accesses publicly available system-wide metrics data.