@access-mcp/system-status 0.4.0 → 0.4.1

package/README.md

@@ -1,79 +1,86 @@
 # System Status MCP Server
 
-MCP server providing real-time system status information for ACCESS-CI resources.
+MCP server providing real-time system status information for ACCESS-CI resources. Provides critical operational information about ACCESS-CI systems, including current outages, scheduled maintenance, and system-wide announcements.
 
-## Overview
+## Usage Examples
 
-This server provides critical operational information about ACCESS-CI systems, including current outages, scheduled maintenance, and system-wide announcements.
+### **Monitor Current Issues**
 
-## Tools
+```
+"Are there any current outages on ACCESS-CI?"
+"Is Delta currently operational?"
+"What systems are experiencing issues right now?"
+"Show me all systems that are down"
+```
 
-### get_current_outages
+### **Track Maintenance Windows**
 
-Get current system outages and issues affecting ACCESS-CI resources.
+```
+"When is the next maintenance for Expanse?"
+"Show me all scheduled maintenance for this week"
+"Is there upcoming maintenance on Bridges-2?"
+"What maintenance is planned for GPU systems?"
+```
 
-**Parameters:**
+### **System Announcements**
 
-- `resource_filter` (string, optional): Filter by specific resource name or ID
+```
+"What are the latest system announcements?"
+"Are there any important notices for ACCESS users?"
+"Show me recent updates about system changes"
+"Any policy updates I should know about?"
+```
 
-**Returns:**
-- Total outages count and severity breakdown
-- Affected resources list
-- Enhanced outage details with severity levels
+### **Check Resource Status**
 
-### get_scheduled_maintenance
+```
+"What's the current status of Anvil?"
+"Is Frontera available for job submission?"
+"Check if all GPU systems are operational"
+"Get status for all TACC resources"
+```
 
-Get scheduled maintenance and future outages for ACCESS-CI resources.
+## Tools
+
+### get_current_outages
+
+Get current system outages and issues affecting ACCESS-CI resources.
 
 **Parameters:**
 
 - `resource_filter` (string, optional): Filter by specific resource name or ID
 
-**Returns:**
-- Scheduled maintenance sorted by start time
-- Time until maintenance starts
-- Duration calculations for planned windows
+**Example:**
+```typescript
+// User: "Are there any current outages on Delta?"
+const outages = await get_current_outages({
+  resource_filter: "delta"
+});
+```
 
-### get_past_outages
+### get_scheduled_maintenance
 
-Get historical outages and past incidents affecting ACCESS-CI resources.
+Get scheduled maintenance and future outages for ACCESS-CI resources.
 
 **Parameters:**
 
 - `resource_filter` (string, optional): Filter by specific resource name or ID
-- `limit` (number, optional): Maximum number of past outages to return (default: 100)
-
-**Returns:**
-- Historical outage data with duration analysis
-- Recent outages (last 30 days) summary
-- Outage type categorization
 
 ### get_system_announcements
 
-Get comprehensive system announcements combining current, scheduled, and recent past outages.
+Get all system announcements (current and scheduled).
 
 **Parameters:**
 
 - `limit` (number, optional): Maximum number of announcements to return (default: 50)
 
-**Returns:**
-- Unified view of current outages, scheduled maintenance, and recent past incidents
-- Categorized announcements for better organization
-- Timeline-based sorting
-
-### check_resource_status
+### get_resource_status
 
-Check the operational status of specific ACCESS-CI resources.
+Get the current operational status of a specific resource.
 
 **Parameters:**
 
-- `resource_ids` (array): List of resource IDs or names to check status for
-- `use_group_api` (boolean, optional): Use resource group API for more efficient querying (default: false)
-
-**Returns:**
-- Operational status for each requested resource
-- Active outage details with severity levels
-- API method used (direct vs group-specific)
+- `resource_id` (string): The resource ID to check status for
 
 ## Resources
 
@@ -133,13 +140,11 @@ Add to your Claude Desktop configuration:
 **Natural Language**: "Are there any systems down right now?"
 
 **Tool Call**:
-
 ```typescript
 const outages = await get_current_outages();
 ```
 
 **Returns**: List of active outages with:
-
 - Affected resources
 - Start time and expected resolution
 - Impact description
@@ -150,15 +155,13 @@ const outages = await get_current_outages();
 **Natural Language**: "When is Delta scheduled for maintenance?"
 
 **Tool Call**:
-
 ```typescript
 const maintenance = await get_scheduled_maintenance({
-  resource_filter: "delta",
+  resource_filter: "delta"
 });
 ```
 
 **Returns**: Upcoming maintenance windows including:
-
 - Scheduled start and end times
 - Systems affected
 - Type of maintenance
@@ -169,15 +172,13 @@ const maintenance = await get_scheduled_maintenance({
 **Natural Language**: "What are the latest announcements?"
 
 **Tool Call**:
-
 ```typescript
 const announcements = await get_system_announcements({
-  limit: 10,
+  limit: 10
 });
 ```
 
 **Returns**: Recent announcements about:
-
 - Policy changes
 - New features or services
 - Important deadlines
@@ -188,15 +189,13 @@ const announcements = await get_system_announcements({
 **Natural Language**: "Is Expanse available?"
 
 **Tool Call**:
-
 ```typescript
 const status = await get_resource_status({
-  resource_id: "expanse.sdsc.xsede.org",
+  resource_id: "expanse.sdsc.xsede.org"
 });
 ```
 
 **Returns**: Current operational status:
-
 - Overall system health
 - Service availability
 - Performance metrics

package/dist/index.js

@@ -1,16 +1,15 @@
 #!/usr/bin/env node
 import { SystemStatusServer } from "./server.js";
-import { startWebServer } from "./web-server.js";
 async function main() {
-    // Check if we should run as web server (for deployment)
+    // Check if we should run as HTTP server (for deployment)
     const port = process.env.PORT;
+    const server = new SystemStatusServer();
     if (port) {
-        // Running in web mode (deployment)
-        startWebServer(parseInt(port));
+        // Running in HTTP mode (deployment)
+        await server.start({ httpPort: parseInt(port) });
     }
     else {
         // Running in MCP mode (stdio)
-        const server = new SystemStatusServer();
         await server.start();
     }
 }

package/dist/server.js

@@ -230,8 +230,8 @@ export class SystemStatusServer extends BaseAccessServer {
             return {
                 ...outage,
                 severity,
-                posted_time: outage.CreationTime,
-                last_updated: outage.LastModificationTime,
+                posted_time: outage.CreationTime || outage.DateTime || outage.created_at || outage.date_posted,
+                last_updated: outage.LastModificationTime || outage.DateTime || outage.updated_at || outage.date_modified,
             };
         });
         const summary = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@access-mcp/system-status",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "MCP server for ACCESS-CI System Status and Outages API",
   "type": "module",
   "main": "dist/index.js",