Flux Operator MCP
MCP server shipped with the Flux Operator for GitOps reconciliation, debugging and diffs.
Labels are provisional (from the project README/docs, checked Nov 3, 2026). Not yet tested in our sandbox.
Read-only switch
flux-operator-mcp serve --read-only disables tools that modify cluster state (default false). diff_kubernetes_manifest stays available.
Preset
- Added
--read-only
Claude Code
{
"mcpServers": {
"flux-operator": {
"command": "flux-operator-mcp",
Removed: "args": ["serve"],
"args": ["serve", "--read-only"],
"env": {
"KUBECONFIG": "/path/to/.kube/config"
}
}
}
}Optional third layer: add "deny": ["mcp__flux-operator__<write tool>"] under permissions in .claude/settings.json.
Codex
# Generated by redpresets.dev on 2026-11-03. Unverified preset. Also use a read-only credential. Not a security guarantee.
[mcp_servers.flux-operator]
command = "flux-operator-mcp"
Removed: args = ["serve"]
args = ["serve", "--read-only"]
default_tools_approval_mode = "writes"
[mcp_servers.flux-operator.env]
KUBECONFIG = "/path/to/.kube/config"default_tools_approval_mode = "writes" asks before any tool the server does not mark read-only.
Cursor
{
"mcpServers": {
"flux-operator": {
"type": "stdio",
"command": "flux-operator-mcp",
Removed: "args": ["serve"],
"args": ["serve", "--read-only"],
"env": {
"KUBECONFIG": "/path/to/.kube/config"
}
}
}
}Don't add write tools to mcpAllowlist in .cursor/permissions.json. Leave them on approval. Cursor's docs say the allowlist is not a security boundary.
Lines marked + are what we added to the vendor's install command. Struck-through lines marked − are what they replaced; Copy leaves those out.
Credential layer
Bind the kubeconfig/service account the agent uses to a read-only ClusterRole (e.g. the built-in view role). view excludes Secrets; do not grant get secrets to agents.
Gotchas
- Repository license is AGPL-3.0 (per GitHub metadata).
Facts
- Vendor
- ControlPlane (Flux) official
- License
- AGPL-3.0
- GitHub stars
- 781
- Latest release
- v0.62.0 (Oct 26, 2026)
- Last push
- Oct 27, 2026
- Status
- Active
- Last checked
- Nov 3, 2026
Sources
- MCP config docs: --read-only flag · checked Oct 27, 2026
Spotted something wrong? Labels change when vendors change. Suggest a correction
Read-only alternatives in Kubernetes
MCP server for Argo CD applications: list, inspect, sync and manage apps.
Kubernetes analyzer; k8sgpt serve --mcp exposes its cluster analysis over MCP.
Python/npm kubectl MCP server with a large tool surface including Helm and diagnostics.