OCM MCP Server

A Model Context Protocol (MCP) server for Red Hat OpenShift Cluster Manager (OCM) API operations. Provides 30 read-only tools for cluster management, monitoring, account operations, and…

Local serverstdio

What is the OCM MCP Server?

OCM MCP Server is an MCP project maintained in the judexzhu/mcp-ocm repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server for Red Hat OpenShift Cluster Manager (OCM) API operations. Provides 30 read-only tools for cluster management, monitoring, account operations…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using uv. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares RH_API_OFFLINE_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
ocm_get_clusterCluster details with HCP/Classic detection
ocm_search_clustersSearch clusters by name, state, region, etc. (OCM search syntax)
ocm_get_cluster_statusCluster status (DNS readiness, provisioning state, health)
ocm_get_cluster_resourcesCurrently available cluster resources (CPU, memory)
ocm_get_cluster_machine_poolsMachine pools (Classic) or node pools (HCP) — auto-detected
ocm_get_cluster_service_logsService logs with pagination (page/size params)
ocm_get_cluster_install_logsInstallation logs and history
ocm_get_cluster_uninstall_logsUninstall logs
ocm_get_cluster_alertsCluster alerts with severity breakdown
ocm_get_cluster_operatorsOperator status with condition summaries
ocm_get_cluster_cpu_metricsCPU metrics by node role and OS
ocm_get_cluster_socket_metricsSocket metrics by node role and OS
ocm_get_cluster_node_metricsNode metrics
ocm_get_cluster_vpcVPC info with subnet analysis (public/private)
ocm_get_cluster_ingressIngress configuration and DNS info
ocm_get_cluster_private_linkAWS Private Link configuration
ocm_get_cluster_identity_providersIdentity provider configuration
ocm_get_cluster_groupsRBAC groups and their users
ocm_get_cluster_addonsInstalled add-ons
ocm_get_cluster_autoscalerCluster autoscaler configuration
ocm_get_cluster_kubelet_configsKubelet configurations
ocm_get_cluster_upgrade_policiesUpgrade policies (Classic + HCP control plane + node pool)
ocm_get_cluster_limited_support_reasonsLimited support reasons
ocm_get_cluster_inflight_checksInflight checks (provisioning debugging)
ocm_get_cluster_sts_operator_rolesSTS operator IAM roles
ocm_get_cluster_provision_shardProvision shard info
ocm_get_accounts_by_emailAccount lookup by email
ocm_get_subscriptionSubscription details
ocm_get_organizationOrganization details
ocm_get_current_accountCurrently authenticated user info

How to install the OCM MCP Server

{
  "mcpServers": {
    "ocm": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/mcp-ocm",
        "run",
        "ocm_mcp_server.py"
      ],
      "env": {
        "RH_API_OFFLINE_TOKEN": "YOUR_RH_API_OFFLINE_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
RH_API_OFFLINE_TOKENDeclared in the maintainer’s client configuration.Check documentation