K8gentS MCP
A human-in-the-loop Root Cause Analysis agent for Kubernetes that uses LLMs to diagnose cluster failures from event streams and proposes remediation steps. It enforces safety via Slack approval gates and OPA Gatekeeper admission policies, ensuring non-deterministic reasoning remains bounded by deterministic guardrails.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Diagnose Kubernetes cluster failures using LLM-driven root cause analysis
- Surface top hypotheses with resolution steps to Slack
- Execute approved fixes inside ephemeral Jobs bounded by OPA Gatekeeper
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
docker.io/jdoornink/k8gents:0.1.1
{
"transport": "stdio",
"identifier": "docker.io/jdoornink/k8gents:0.1.1",
"registryType": "oci",
"environmentVariables": [
{
"name": "AI_API_KEY",
"format": "string",
"isRequired": true,
"description": "Google Gemini API key for LLM-powered root cause analysis"
},
{
"name": "AI_MODEL",
"format": "string",
"description": "Gemini model to use (default: gemini-2.5-pro)"
},
{
"name": "KUBECONFIG",
"format": "string",
"description": "Path to kubeconfig file. Omit to use in-cluster config or ~/.kube/config automatically."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"k8gents-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"AI_API_KEY=<YOUR_AI_API_KEY>",
"-e",
"AI_MODEL=<YOUR_AI_MODEL>",
"-e",
"KUBECONFIG=<YOUR_KUBECONFIG>",
"docker.io/jdoornink/k8gents:0.1.1"
],
"env": {
"AI_API_KEY": "<YOUR_AI_API_KEY>",
"AI_MODEL": "<YOUR_AI_MODEL>",
"KUBECONFIG": "<YOUR_KUBECONFIG>"
}
}
}
}Cline
{
"mcpServers": {
"k8gents-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"AI_API_KEY=<YOUR_AI_API_KEY>",
"-e",
"AI_MODEL=<YOUR_AI_MODEL>",
"-e",
"KUBECONFIG=<YOUR_KUBECONFIG>",
"docker.io/jdoornink/k8gents:0.1.1"
],
"env": {
"AI_API_KEY": "<YOUR_AI_API_KEY>",
"AI_MODEL": "<YOUR_AI_MODEL>",
"KUBECONFIG": "<YOUR_KUBECONFIG>"
}
}
}
}VS Code
{
"servers": {
"k8gents-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"AI_API_KEY=<YOUR_AI_API_KEY>",
"-e",
"AI_MODEL=<YOUR_AI_MODEL>",
"-e",
"KUBECONFIG=<YOUR_KUBECONFIG>",
"docker.io/jdoornink/k8gents:0.1.1"
],
"env": {
"AI_API_KEY": "<YOUR_AI_API_KEY>",
"AI_MODEL": "<YOUR_AI_MODEL>",
"KUBECONFIG": "<YOUR_KUBECONFIG>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"k8gents-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"AI_API_KEY=<YOUR_AI_API_KEY>",
"-e",
"AI_MODEL=<YOUR_AI_MODEL>",
"-e",
"KUBECONFIG=<YOUR_KUBECONFIG>",
"docker.io/jdoornink/k8gents:0.1.1"
],
"env": {
"AI_API_KEY": "<YOUR_AI_API_KEY>",
"AI_MODEL": "<YOUR_AI_MODEL>",
"KUBECONFIG": "<YOUR_KUBECONFIG>"
}
}
}
}Let your agent find its tools
Find servers like K8gentS MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.