feat: add some XDMoD data

Author: a-pasquale

data-sources/xdmod.md

@@ -3,8 +3,8 @@ id: xdmod
 name: XDMoD Metrics
 description: HPC metrics, usage analytics, and resource specifications from the ACCESS XDMoD instance
 category: Metrics & Reporting
-track: Operations
-responsible_team: Operations
+track: Metrics
+responsible_team: Metrics
 access_level: Varies
 is_canonical: true
 api_endpoint: https://xdmod.access-ci.org/controllers/user_interface.php
@@ -26,14 +26,34 @@ mcp:
       description: Get filter values for a dimension (e.g., all resources, institutions)
     - name: get_chart_data
       method: POST
-      description: Get chart data and metadata for a statistic
+      description: Get chart data and metadata for a statistic with optional filters
     - name: get_chart_image
       method: POST
       description: Get chart as SVG, PNG, or PDF image
     - name: get_chart_link
       method: GET
       description: Generate a URL to the interactive XDMoD portal chart
 
+mcp_authenticated:
+  available: true
+  package: "@access-mcp/xdmod-data"
+  notes: Authenticated access via XDMoD API token (xdmod-data Python package). Required for per-user data queries.
+  tools:
+    - name: get_user_data
+      description: Get user-specific usage data by exact user identifier
+    - name: get_raw_data
+      description: Extract XDMoD metrics with complex filtering, timeseries/aggregate modes
+    - name: describe_fields
+      description: Discover dimensions and metrics in a specific realm
+    - name: describe_realms
+      description: List all available XDMoD data realms with capabilities
+    - name: get_smart_filters
+      description: Discover filter values for use with get_raw_data (resources, queues, institutions)
+    - name: get_analysis_template
+      description: Get pre-configured analysis patterns (14 templates for common scenarios)
+    - name: integrate_nsf_xdmod
+      description: Correlate NSF funding data with XDMoD computational usage patterns
+
 use_cases:
   - How much CPU time was used across ACCESS last quarter?
   - Which resources have the highest GPU utilization?
@@ -393,9 +413,9 @@ notes:
 
 XDMoD (XD Metrics on Demand) provides comprehensive metrics on ACCESS cyberinfrastructure usage. It covers 9 realms of data from job accounting (Jobs), detailed performance monitoring (SUPREMM), cloud compute (Cloud), gateway usage (Gateways), allocation tracking (Allocations), user accounts (Accounts), allocation requests (Requests), resource hardware specifications (ResourceSpecifications), and storage (Storage).
 
-The MCP server provides two tiers:
-- **@access-mcp/xdmod** (TypeScript) — Public aggregate data via `public_user=true`. No auth required. Discovery tools + chart tools.
-- **@access-mcp/xdmod-data** (Python) — Authenticated per-user data via XDMoD API tokens. Requires `XDMOD_API_TOKEN`.
+Two MCP servers provide access at different tiers:
+- **@access-mcp/xdmod** (TypeScript, 6 tools) — Public aggregate data via `public_user=true`. No auth required. Discovery, chart data, chart images, and portal links.
+- **@access-mcp/xdmod-data** (Python, 7 tools) — Authenticated access via XDMoD API tokens. Per-user data, complex filtering, analysis templates, and NSF funding integration. Requires `XDMOD_API_TOKEN`.
 
 ## Notes
 

docs/field-dictionary.md

@@ -15,6 +15,7 @@ Field-level documentation for all ACCESS data sources.
 - [COManage/ACCESS Identity](#comanage)
 - [Event Registrations](#event_registrations)
 - [Events and Training](#events)
+- [XDMoD Metrics](#xdmod)
 
 <h2 id="access_support_drupal">ACCESS Support Drupal</h2>
 
@@ -239,3 +240,20 @@ Field-level documentation for all ACCESS data sources.
 - **Belongs To** `affinity_groups`: Events can be associated with an affinity group
 - **Has Many** `tags`: Events are tagged for discovery
 - **Has Many** `event_registrations`: Registration records for this event
+
+<h2 id="xdmod">XDMoD Metrics</h2>
+
+*HPC metrics, usage analytics, and resource specifications from the ACCESS XDMoD instance*
+
+**Example questions this data can answer:**
+
+- How much CPU time was used across ACCESS last quarter?
+- Which resources have the highest GPU utilization?
+- How many jobs ran on Delta in January 2024?
+- What science gateways are most active?
+- How are allocations distributed across fields of science?
+- What is the total GPU capacity across ACCESS resources?
+- Show me wait times by resource for the past month
+- How many active users and PIs are there?
+
+*No fields documented.*

docs/index.md

@@ -19,6 +19,12 @@ The ACCESS ecosystem spans dozens of data sources across multiple teams and trac
 
 ## Data Sources
 
+### Metrics
+
+| Source | Description | Access | |
+|--------|-------------|--------|---|
+| [XDMoD Metrics](field-dictionary#xdmod) | HPC metrics, usage analytics, and resource specifications from the ACCESS XDMoD instance | Varies | [MCP](https://access-mcp.netlify.app/servers/xdmod) · [API](https://xdmod.access-ci.org/controllers/user_interface.php) |
+
 ### Operations
 
 | Source | Description | Access | |

docs/inventory.dbml

@@ -1,5 +1,5 @@
 // ACCESS Data Inventory
-// Generated: 2026-02-13 18:43
+// Generated: 2026-02-24 17:53
 // Source: data-sources/*.md
 
 // =============================================================================
@@ -97,6 +97,21 @@ Enum data_source {
     priority: High
   ''']
 
+  xdmod [note: '''
+    name: XDMoD Metrics
+    description: HPC metrics, usage analytics, and resource specifications from the ACCESS XDMoD instance
+    category: Metrics & Reporting
+    track: Metrics
+    responsible_team: Metrics
+    access_level: Varies
+    is_canonical: true
+    canonical_source: null
+    mcp_available: true
+    mcp_package: @access-mcp/xdmod
+    api_endpoint: https://xdmod.access-ci.org/controllers/user_interface.php
+    priority: High
+  ''']
+
 }
 
 // =============================================================================