rancher-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RANCHER_URL | Yes | URL of the Rancher server (e.g., https://rancher.example.com) | |
| RANCHER_TOKEN | Yes | API token for Rancher (format: token-xxxxx:yyyyyyyyyyyy) | |
| RANCHER_VERIFY_TLS | No | Set to 'false' to disable TLS verification (e.g., for self-signed certificates) | |
| RANCHER_MCP_ALLOW_WRITE | No | Set to 'true' to enable write operations like scale_workload and redeploy_workload | |
| RANCHER_MCP_MAX_REPLICAS | No | Maximum replicas for scaling (default 20) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_clustersA | List all Rancher-managed clusters with state and capacity summary. |
| list_nodesA | List the nodes of a cluster with roles, state and requested resources. |
| list_projectsA | List Rancher projects of a cluster (project ids are needed to inspect workloads). |
| list_workloadsA | List workloads (deployments, daemonsets...) of a project, optionally filtered by namespace. |
| list_podsA | List pods of a project. Set only_unhealthy=True to see only pods in CrashLoopBackOff/Error/Pending states or with more than 3 restarts. |
| get_pod_logsB | Fetch the last N log lines of a pod. Use previous=True to read logs from the previous (crashed) container instance. |
| get_eventsB | List recent Kubernetes events of a cluster (Warning events by default). |
| diagnose_workloadA | One-shot diagnosis of a workload: state, unhealthy pods, restart counts and related Warning events. Ideal first call when something is failing. |
| scale_workloadA | Scale a workload to N replicas. Requires RANCHER_MCP_ALLOW_WRITE=true. Capped by RANCHER_MCP_MAX_REPLICAS (default 20). |
| redeploy_workloadB | Trigger a rolling redeploy of a workload (equivalent to the Rancher UI 'Redeploy' button). Requires RANCHER_MCP_ALLOW_WRITE=true. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Each tool targets a distinct resource or action: listing clusters, projects, workloads, pods, nodes; retrieving events, logs; diagnosing a workload; redeploying or scaling. No overlaps.
All tools use an imperative verb followed by a noun (e.g., list_clusters, get_pod_logs, diagnose_workload). Names are uniformly snake_case and follow a predictable pattern.
10 tools is right in the ideal range (3-15). The set covers listing, retrieval, diagnosis, and two write operations without being bloated or too sparse.
For a diagnostics and light remediation server, the tool surface is complete: full read coverage of relevant Rancher resources, log/event access, workload diagnosis, and write operations for redeploy and scaling. No obvious gaps.