Kubernetes Resources Reference via MCP

Ask your AI agent about Kubernetes resources directly

Kubernetools offers the same Kubernetes resources reference as an MCP (Model Context Protocol) server, free to use at https://mcp.kubernetools.com/. Connect it to any MCP-compatible agent, and you can ask questions like "what fields does a Deployment spec have?" or "how do I set a Pod's restart policy?" and get answers pulled straight from the official Kubernetes API definitions — no need to open a browser and search the docs yourself.

Connect your agent

Most MCP clients accept a remote server configuration in this form (consult your client's documentation for exactly where to add it):

{
  "mcpServers": {
    "kubernetools": {
      "url": "https://mcp.kubernetools.com/?version=v1.36"
    }
  }
}

That's it — no sign-up, no API key. Once connected, your agent will be able to look up Kubernetes resources for you automatically whenever it's relevant to your question.

Choosing a Kubernetes version

The version part of the URL controls which Kubernetes release the answers come from. Change v1.36 to v1.35, v1.34, or v1.33 if you're working with an older cluster. If you leave it out, the most recent version is used.

Managing clusters on different Kubernetes versions? Add one server entry per version, each with its own name and version in the URL, so your agent always checks the reference that matches the cluster you're working on:

{
  "mcpServers": {
    "kubernetools-1.35": {
      "type": "http",
      "url": "https://mcp.kubernetools.com/?version=v1.35"
    },
    "kubernetools-1.36": {
      "type": "http",
      "url": "https://mcp.kubernetools.com/?version=v1.36"
    }
  }
}

Your agent will then see both as separate tool sets and can query whichever version is relevant to your question.

What you can ask

You don't need to know the exact tool names below to use the server — just ask your question naturally and your agent will pick the right one. They're listed here for reference:

• Find a resource — browse or search for a Kubernetes kind, such as "list all resources in the apps group."
• Look up a resource in detail — get every field for a specific kind, such as "what fields does a Deployment have?"
• Look up a related type — drill into a nested type mentioned in another resource, such as "tell me more about PodSpec."

Want to run your own private instance instead of using the hosted service? See the mcp-server repository for the container image and setup instructions.