Kubernetes MCP server for managing and querying Kubernetes resources
KubeMCP has 3 tools with basic verb-noun naming (get_resources, get_resource, patch_resource). All tools have descriptions (10-60 chars), but they are minimal and lack context on when to use each tool or what they return. Input schemas are present with type definitions and parameter descriptions, but output schemas are completely undocumented, LLMs cannot plan downstream calls. The patch_resource tool accepts a free-form 'patch' object with no validation guidance. Error handling is minimal (raw ApiException messages). No tool annotations (readOnlyHint, destructiveHint) despite clear risk profiles. The get_resources and get_resource tools are confusingly similar, get_resources calls get_resource with name=None, creating ambiguity about when to use each.
Get a specific resource by kind, namespace, and name
Get all resources of a specific kind in a namespace
Patch a Kubernetes resource with the provided patch data
Output schemas completely undocumented. All tools return JSON strings with no documented structure. LLMs cannot infer what fields to expect or plan chained calls.
get_resources and get_resource are confusingly similar. get_resources internally calls get_resource with name=None, creating ambiguity. Should be split into list_resources (returns array) and get_resource (returns single item).
patch_resource accepts free-form 'patch' object with no validation, format guidance, or examples. LLMs cannot determine valid patch structure (JSON Patch vs strategic merge patch vs other formats).
No tool annotations despite clear risk profiles. patch_resource is destructive (WRITE) but lacks destructiveHint. get_resources and get_resource are read-only but lack readOnlyHint.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
Error handling returns raw ApiException messages ('ERROR: {status} - {reason}'). No recovery guidance, no actionable next steps for LLM. patch_resource has no error handling at all.