MCP Server for a Kubernetes cluster written in Python.
All 4 tools have basic verb-noun naming (list_pods, list_services, get_events, list_deployments) and short descriptions (18-48 chars). However, descriptions are minimal and lack context for LLM selection. Input schemas are present but trivial (single string param). Output schemas are completely undocumented, no return type specifications visible. No error handling guidance, no pagination support despite list tools returning unbounded results, no parameter validation hints. Tools lack the depth needed for production agent use.
Get a list of events in the specified namespace
Get a list of deployments in the specified namespace
Get a list of pods in the specified namespace
Get a list of services in the specified namespace
No output schemas documented. Tools return lists but LLM cannot infer field structure, forcing guesswork on downstream tool chaining.
Descriptions are under 50 chars and lack context. 'Get a list of pods in the specified namespace' does not explain WHEN to call this vs other discovery tools, what fields are returned, or how to use results.
No pagination support. List tools return unbounded results; large clusters will blow context windows. Missing limit, offset, and total_count fields.
Parameter descriptions are trivial. 'The Kubernetes namespace to list pods from' does not explain valid namespace formats, how to discover available namespaces, or what happens if namespace does not exist.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
No error handling guidance. Code calls Kubernetes API directly without try-catch or recovery hints. LLM receives raw exceptions instead of actionable error messages.