jeanlopezxyz/mcp-redhat-cases

Red Hat Cases MCP Server

A Model Context Protocol (MCP) server for Red Hat Support Cases management.

Built with Quarkus MCP Server.

Transport Modes

This server supports two MCP transport modes:

Table of Contents

• Transport Modes
• Requirements
• Installation
• Configuration
• Tools
• Prompts
• Examples
• Development
• Contributing

Requirements

• Java 21+ - Download
• Red Hat API Token - Generate here
• Red Hat Subscription with Support - Self-Support subscriptions cannot create cases

Installation

Quick Install (Claude Code CLI)

claude mcp add redhat-cases -e REDHAT_TOKEN="your-token-here" -- npx -y mcp-redhat-cases@latest

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "redhat-cases": {
      "command": "npx",
      "args": ["-y", "mcp-redhat-cases@latest"],
      "env": {
        "REDHAT_TOKEN": "your-token-here"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "redhat-cases": {
      "command": "npx",
      "args": ["-y", "mcp-redhat-cases@latest"],
      "env": {
        "REDHAT_TOKEN": "your-token-here"
      }
    }
  }
}

VS Code

code --add-mcp '{"name":"redhat-cases","command":"npx","args":["-y","mcp-redhat-cases@latest"],"env":{"REDHAT_TOKEN":"your-token-here"}}'

Cursor

Add to mcp.json:

{
  "mcpServers": {
    "redhat-cases": {
      "command": "npx",
      "args": ["-y", "mcp-redhat-cases@latest"],
      "env": {
        "REDHAT_TOKEN": "your-token-here"
      }
    }
  }
}

Windsurf

Add to MCP configuration:

{
  "mcpServers": {
    "redhat-cases": {
      "command": "npx",
      "args": ["-y", "mcp-redhat-cases@latest"],
      "env": {
        "REDHAT_TOKEN": "your-token-here"
      }
    }
  }
}

Goose CLI

Add to config.yaml:

extensions:
  redhat-cases:
    command: npx
    args:
      - -y
      - mcp-redhat-cases@latest
    env:
      REDHAT_TOKEN: your-token-here

SSE Mode

Run as standalone server:

REDHAT_TOKEN="your-token" npx mcp-redhat-cases --port 9080

Endpoint: http://localhost:9080/mcp/sse

Configuration

Command Line Options

Environment Variables

Tools

This server provides 10 tools organized in 3 categories:

Account

getAccountInfo

Verify Red Hat API connection and get account information.

Parameters: None

Returns: Account name, number, alias, status, region, and country.

getEntitlements

Get the user's Red Hat subscriptions (entitlements). Shows which products you have access to for creating support cases.

Parameters: None

Returns: List of entitlements separated by support level:

• Products WITH Support (can create cases)
• Self-Support (NO case creation)

Important: Only products with PREMIUM, STANDARD, or similar support levels (not SELF-SUPPORTED) can be used to create support cases.

Case Management

createCase

Create a new support case in Red Hat.

Returns: Created case details with assigned case number.

Tip: Use getEntitlements first to check which products you can create cases for.

getCase

Get complete details of a support case by its number.

Returns: Full case details including description, comments, timeline, status, priority, and product.

searchCases

Search and list support cases with optional filters.

Returns: List of matching cases.

Examples:

• List open cases: searchCases
• List ALL cases: searchCases includeClosed=true
• Find urgent cases: searchCases priority='URGENT'
• Find by product: searchCases product='OpenShift'

updateCase

Update a support case: change status or reassign contact.

At least one of status or contactSSOName must be provided.

Examples:

• Reopen closed case: updateCase caseNumber='03881234' status='Waiting on Red Hat'
• Close case: updateCase caseNumber='03881234' status='Closed'
• Reassign: updateCase caseNumber='03881234' contactSSOName='jsmith'

addComment

Add a comment to an existing support case.

Returns: Confirmation of added comment.

getStatistics

Get support case statistics and metrics.

Parameters: None

Returns: Statistics including:

• Total cases
• Open urgent cases
• Distribution by status, priority, and product

Products

listProducts

List all Red Hat products available for creating support cases.

Parameters: None

Returns: List of products with name and code. Use the exact product NAME when creating a case.

listVersions

List available versions for a Red Hat product.

Returns: List of available versions for the product.

Prompts

Example Prompts

Use natural language to manage Red Hat support cases. Here are prompts organized by use case:

Getting Started

"Show my Red Hat account info"
"Am I connected to Red Hat?"
"What products can I create cases for?"
"Show my entitlements"
"What subscriptions do I have?"

Viewing Cases

"List my active support cases"
"Show all my cases"
"List all cases including closed ones"
"Show case 03881234"
"Get details for case 03881234"
"What's the status of my urgent cases?"

Searching Cases

"Find cases related to authentication"
"Search for OpenShift cases"
"Show all urgent priority cases"
"Find cases waiting on Red Hat"
"Search for cases about networking"

Creating Cases

"I need to create a support case for OpenShift"
"Create a case: my cluster nodes are NotReady"
"Open a new case for RHEL kernel panic"
"Help me create a support case for database connection issues"
"What products and versions are available for case creation?"
"List OpenShift versions"

Managing Cases

"Add a comment to case 03881234: we found the root cause"
"Close case 03881234"
"Reopen case 03881234"
"Change case 03881234 to waiting on Red Hat"
"Reassign case 03881234 to user jsmith"

Statistics & Reports

"Show case statistics"
"How many urgent cases do I have open?"
"Give me an executive summary of support cases"
"What's the distribution of cases by priority?"

Workflows

"I have an error: ImagePullBackOff - help me create a support case"
"My OpenShift cluster is down - what should I do?"
"Guide me through creating a support case"
"Help me troubleshoot case 03881234"

Development

Run in dev mode

export REDHAT_TOKEN="your-token"
./mvnw quarkus:dev

Build

./mvnw package -DskipTests

Test with script

export REDHAT_TOKEN="your-token"
./test_mcp.sh all          # Run basic tests
./test_mcp.sh entitlements # Check your subscriptions
./test_mcp.sh create       # Create a test case
./test_mcp.sh list         # List all cases

Test with MCP Inspector

# stdio mode
REDHAT_TOKEN="your-token" npx @modelcontextprotocol/inspector npx mcp-redhat-cases

# SSE mode
REDHAT_TOKEN="your-token" npx mcp-redhat-cases --port 9080
# Then connect inspector to http://localhost:9080/mcp/sse

Contributing

See for guidelines on:

• Branch protection rules
• Pull request workflow
• Development setup
• Code style and testing
• Release process

License

- Free to use, modify, and distribute.