Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 41 additions & 0 deletions docs/PROMPTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,47 @@ content = "I'll retrieve and analyze the logs for you."
### Argument Substitution
Use `{{argument_name}}` placeholders in message content. The template engine replaces these with actual values when the prompt is called.

## Built-in Prompts

The Kubernetes MCP Server includes several built-in prompts that are always available:

### `cluster-health-check`

Performs a comprehensive health assessment of your Kubernetes or OpenShift cluster.

**Arguments:**
- `namespace` (optional): Limit the health check to a specific namespace. Default: all namespaces.
- `check_events` (optional): Include recent warning/error events in the analysis. Values: `true` or `false`. Default: `true`.

**What it checks:**
- **Nodes**: Status and conditions (Ready, MemoryPressure, DiskPressure, etc.)
- **Cluster Operators** (OpenShift only): Available and degraded status
- **Pods**: Phase, container statuses, restart counts, and common issues (CrashLoopBackOff, ImagePullBackOff, etc.)
- **Workload Controllers**: Deployments, StatefulSets, and DaemonSets replica status
- **Persistent Volume Claims**: Binding status
- **Events**: Recent warning and error events from the last hour

**Example usage:**
```
Check the health of my cluster
```

Or with specific parameters:
```
Check the health of namespace production
```

You can also skip event checking for faster results:
```
Check the health of my cluster without events
```

The prompt gathers comprehensive diagnostic data and presents it to the LLM for analysis, which will provide:
1. Overall health status (Healthy, Warning, or Critical)
2. Critical issues requiring immediate attention
3. Warnings and recommendations
4. Summary by component

## Configuration File Location

Place your prompts in the `config.toml` file used by the MCP server. Specify the config file path using the `--config` flag when starting the server.
Expand Down
Loading