Flux Operator MCP

MCP server shipped with the Flux Operator for GitOps reconciliation, debugging and diffs.

By defaultCan write
With our presetRead-only
Flagssecrets

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

Read-onlyRead-only switch from the vendor's docs. Not sandbox-tested yet.
What the preset changes
  • Added --read-only

Claude Code

.mcp.json
{
  "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

~/.codex/config.toml
# 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

.cursor/mcp.json
{
  "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
Source
controlplaneio-fluxcd/flux-operator
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

Spotted something wrong? Labels change when vendors change. Suggest a correction

Read-only alternatives in Kubernetes