Kubently MCP Server

Kubently

Kubently - Troubleshooting Kubernetes Agentically

Overview

Kubently (Kubernetes + Agentically) enables AI agents to troubleshoot Kubernetes clusters through natural language conversations. By implementing the A2A (Agent-to-Agent) protocol, Kubently allows multiple agents to collaborate in diagnosing and resolving cluster issues autonomously.

Key Features

• Multi-LLM Support: Compatible with Google Gemini, OpenAI, Anthropic, and other providers
• A2A Protocol: Industry-standard agent-to-agent communication for complex workflows
• MCP Server: Optional Model Context Protocol endpoint so MCP clients (Claude Desktop, Cursor, custom agents) get direct tool access
• Natural Language Interface: Conversational Kubernetes troubleshooting and debugging
• Comprehensive Analysis: Automated issue detection, root cause analysis, and solution recommendations
• Security-First: API key authentication, OAuth/OIDC support, and TLS with cert-manager
• Persistent Sessions: Redis-backed conversation history and context management
• Extensive Tool Suite: kubectl integration, log analysis, resource inspection, and more

Quick Start

For Users: Get Started in 5 Minutes

Point kubectl at any cluster (kind, minikube, or real) and run:

npm install -g @kubently/cli
kubently install

That's it. The CLI installs Kubently via Helm, wires up secrets and the executor, port-forwards the API, and drops you into a debug chat:

kubently> why is my nginx pod crashlooping?

You'll need an LLM API key (Anthropic, OpenAI, or Google) — the installer prompts for it, or reads ANTHROPIC_API_KEY / OPENAI_API_KEY / GOOGLE_API_KEY from your environment. Use --provider to pick the LLM, --chart ./deployment/helm/kubently to install from a local checkout, and kubently install --help for everything else.

Use from Claude Code / Cursor (MCP)

Already ran kubently install? Add Kubently to Claude Code:

claude mcp add kubently -- kubently mcp

Or connect directly over HTTP (no bridge process):

claude mcp add --transport http kubently http://localhost:8080/mcp/ \
  --header "X-API-Key: <your-api-key>"

Then ask Claude things like "use kubently to figure out why payments pods are crashlooping". Any MCP client works — see docs/MCP.md for Cursor and generic configuration.

Proactive diagnosis (Alertmanager → Slack)

Set api.env.SLACK_WEBHOOK_URL to a Slack incoming-webhook URL and point Alertmanager at Kubently:

receivers:
  - name: kubently
    webhook_configs:
      - url: https://<your-kubently-host>/webhooks/alertmanager
        http_config:
          http_headers:            # Alertmanager >= 0.28
            X-API-Key:
              secrets: ["<your-api-key>"]

Each firing alert is diagnosed by the agent and the result is posted to Slack — the bot often explains the root cause before you've opened your laptop.

📖 See QUICK_START.md for full quick-start guide

📚 See GETTING_STARTED.md for production deployment

For Developers: Local Testing

# Deploy with automated testing
./deploy-test.sh

# Run comprehensive test suite
./test-automation/run_tests.sh test-and-analyze --api-key test-api-key

📖 See CLAUDE.md for development guidelines

Configuration

LLM Providers

Configure your preferred LLM provider in .env:

# Google Gemini
GOOGLE_API_KEY=your-gemini-api-key

# OpenAI
OPENAI_API_KEY=your-openai-api-key

# Anthropic
ANTHROPIC_API_KEY=your-anthropic-api-key

Helm Deployment

Customize deployment using Helm values:

# Edit deployment configuration
vim deployment/helm/test-values.yaml

# Deploy with custom values
helm install kubently deployment/helm -f deployment/helm/test-values.yaml

Architecture

• API Server: FastAPI-based REST API for cluster management and authentication
• A2A Server: Implements A2A protocol with LangGraph for workflow orchestration
• Test Automation: Comprehensive testing framework with 20+ Kubernetes scenarios
• CLI Tools: Modern Node.js CLI for interactive debugging

Documentation

Getting Started

• Quick Start Guide - Get running in 5 minutes
• Getting Started - Complete setup for production use
• Deployment Guide - Detailed deployment options and configuration

Usage & Operations

• CLI Admin Guide - Managing clusters and executors
• Test Queries - Example API requests and A2A protocol usage
• MCP Connect Guide - Connect MCP clients (Claude Desktop, Cursor, custom agents)
• Environment Variables - Configuration reference

Architecture & Development

• Architecture - System design and components
• A2A Protocol Spec - Official protocol documentation
• Development Guide - Guidelines for contributors

Troubleshooting

• Getting Started - Common Issues - Troubleshooting guide

Contributing

See CLAUDE.md for development guidelines and contribution instructions.

Maintainer

Kubently Team - hello@kubently.io

License

Apache 2.0 License - See LICENSE file for details