F5 Cloud Status MCP Server

A Model Context Protocol (MCP) server for monitoring F5 Cloud service status, providing real-time status information, component health, incidents, and scheduled maintenance.

Features

• Real-time Status Monitoring: Get current operational status of F5 Cloud services
• Component Tracking: Monitor 148+ individual service components across multiple categories
• Incident Management: Track active and historical incidents with detailed updates
• Maintenance Windows: Access scheduled, active, and upcoming maintenance information
• Dual Data Sources: API-first with automatic web scraper fallback for reliability
• Intelligent Caching: TTL-based caching with configurable durations per data type
• Comprehensive Search: Search across components, incidents, and maintenance by keyword

Installation

Base Configuration

The standard configuration for all MCP clients:

{
  "mcpServers": {
    "f5-cloud-status": {
      "command": "npx",
      "args": ["-y", "f5cloudstatus-mcp@latest"]
    }
  }
}

This uses npx to automatically download and run the latest version. No manual installation required.

Claude Desktop

1. Locate your configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add the base configuration (see above)

3. Restart Claude Desktop

4. Verify: Look for the 🔌 MCP icon showing "f5-cloud-status" connected

Claude Code

CLI installation:

claude mcp add f5-cloud-status npx f5cloudstatus-mcp@latest

VS Code (with GitHub Copilot)

Requirements: VS Code 1.102 or later

CLI installation:

code --add-mcp '{"name":"f5-cloud-status","command":"npx","args":["f5cloudstatus-mcp@latest"]}'

Or enable auto-discovery:

{
  "chat.mcp.discovery.enabled": true
}

Or manual configuration in settings.json:

{
  "chat.mcp.servers": {
    "f5-cloud-status": {
      "command": "npx",
      "args": ["-y", "f5cloudstatus-mcp@latest"]
    }
  }
}

Cursor IDE

One-click install:

1. Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
2. Type "Cursor Settings" → MCP
3. Browse and click Install for F5 Cloud Status

Or manual configuration:

• Project: Create .cursor/mcp.json with base configuration
• Global: Create ~/.cursor/mcp.json with base configuration

Windsurf

Plugin Store:

1. Click Plugins in Cascade panel → Search "F5 Cloud Status" → Install

Or manual:

1. Windsurf Settings → Cascade → MCP Servers → Add Custom Server
2. Add base configuration

Cline (VS Code Extension)

1. Install Cline extension in VS Code
2. Add base configuration to Cline's MCP settings or VS Code settings.json:

   {
     "cline.mcpServers": {
       "f5-cloud-status": {
         "command": "npx",
         "args": ["-y", "f5cloudstatus-mcp@latest"]
       }
     }
   }

3. Restart VS Code

See Cline MCP docs for more details.

Alternative Installation: Global NPM

npm install -g f5cloudstatus-mcp

Configuration:

{
  "mcpServers": {
    "f5-cloud-status": {
      "command": "f5cloudstatus-mcp"
    }
  }
}

Example Queries

Once configured, ask your AI assistant:

📖 See USAGE_EXAMPLES.md for 14 detailed real-world examples with expected responses.

Quick Examples

Check overall status:

What is the current status of F5 Cloud services?

List all components:

Show me all F5 Cloud components and their current operational status

Check for issues:

Are there any F5 Cloud components that are degraded or having issues?

Find specific component:

What is the status of the F5 Distributed Cloud Services API Gateway?

Check for incidents:

Are there any active incidents affecting F5 Cloud services?

Search for maintenance:

Are there any upcoming maintenance windows for F5 Cloud services?

Available Tools

The server provides six MCP tools for interacting with F5 Cloud status:

1. f5-status-get-overall - Get the current overall status of F5 Cloud services
2. f5-status-get-components - Get all service components with current status
3. f5-status-get-component - Get detailed information about a specific component
4. f5-status-get-incidents - Get current and recent incidents
5. f5-status-get-maintenance - Get scheduled maintenance windows
6. f5-status-search - Search for components, incidents, or maintenance by keyword

Development

This project uses fully automated CI/CD with version bumping. See docs/CICD.md for details.

License

MIT - See LICENSE file for details

Support

• GitHub Issues: GitHub Issues
• NPM Package: https://www.npmjs.com/package/f5cloudstatus-mcp