Talos Linux MCP Server

An MCP server that exposes Talos Linux cluster management to AI agents (Claude Code, OpenAI Codex, and any MCP-compatible client). Instead of pasting talosctl output into chat, the agent calls structured tools that return machine-readable JSON directly from the Talos gRPC API - zero token cost for intermediate output. Its 23 documented tools cover talos, etcd.

People who work with talos and etcd and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Go.

VERIFIED ACTIVE

LAST COMMIT 2026-08-24 · ★ 4 · #64 OF 153 MAINTAINED CLOUD INFRASTRUCTURE · VERIFIED 2026-09-18

MIT · Go servers · how we verify → /methodology

01 · Install Talos Linux MCP Server

Claude Code

claude mcp add nosmoht-talos-mcp-server -- npx -y talos-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "nosmoht-talos-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "talos-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package talos-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.Nosmoht is GitHub-verified and matches the repo owner

03 · What Talos Linux MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list all available resource types and their aliases. Call this first to discover what can be queried, list all Talos services and their current state (running, stopped, health), list containers in a namespace (default: k8s.io for Kubernetes containers), and list running processes on target nodes.

The 23 tools it gives your agent

Extracted from the project's README - what Talos Linux MCP Server lets an agent do.

talos_resource_definitions
- List all available resource types and their aliases. Call this first to discover what can be queried.
talos_get
- Get or list any COSI resource by type (e.g. MachineStatus, Member, NodeAddress, Service). Supports maintenance-mode (insecure=true + endpoint).
talos_version
- Get Talos version info from target nodes. Supports maintenance-mode (insecure=true + endpoint).
talos_services
- List all Talos services and their current state (running, stopped, health).
talos_containers
- List containers in a namespace (default: k8s.io for Kubernetes containers).
talos_processes
- List running processes on target nodes.
talos_health
- Check cluster health (etcd, Kubernetes API, node readiness). Supports control_plane_nodes / worker_nodes override.
talos_logs
- Fetch recent service logs (last N lines, no follow).
talos_dmesg
- Read kernel ring buffer messages.
talos_events
- Fetch recent Talos runtime events (service changes, config changes).
talos_etcd
- Query etcd cluster: members (default) or status.
talos_etcd_snapshot
- Stream an etcd snapshot to a local file path.
show all 23 tools
talos_list_files
- List files and directories on a node filesystem.
talos_read_file
- Read file contents from a node filesystem.
talos_validate
- Validate a machine config (YAML/JSON) offline - no cluster connection.
talos_service_action
- Start, stop, or restart a Talos service (note: restarting etcd is not supported by the Talos API).
talos_reboot
- Reboot target nodes. Supports mode: default, powercycle, force.
talos_upgrade
- Upgrade Talos on target nodes. Supports preserve (default true), stage, force, reboot_mode.
talos_rollback
- Roll back the last upgrade on target nodes.
talos_patch_config
- Apply a targeted machine config patch (strategic-merge or RFC 6902 JSON Patch).
talos_reset
- Wipe and factory-reset target nodes (irreversible).
talos_apply_config
- Apply a complete machine config to a single node. Supports maintenance-mode (insecure=true + endpoint) for fresh-node bootstrap.
talos_meta
- Read, write, or delete META partition key/value pairs. Supports maintenance-mode (insecure=true + endpoint).

Latest releases

v2.5.1 · 2026-06-16

extend tested range to Talos v1.13 (track machinery v1.13.4) (#211)

v2.5.0 · 2026-06-16

purpose-first tool descriptions + routing for reliable tool selection [review:tool-routing-descriptions] (#209)

v2.4.3 · 2026-06-03

document path allowlist symlink limitation and warn at startup [review:symlink-allowlist-docs] (#202)

04 · Who maintains Talos Linux MCP Server

Talos Linux MCP Server is maintained by nosmoht. It's the only MCP server we track from this author; the repo dates to Apr 2026.

05 · Facts

category
cloud infrastructure - ranked #64 of 153 actively-maintained cloud infrastructure servers as of 2026-09-18.
registry
io.github.Nosmoht/talos-mcp-server (active, first published 2026-04-16 · 11 versions)
packages
npm:talos-mcp

06 · Talos Linux MCP Server FAQ

Is Talos Linux MCP Server still maintained?

Yes - as of 2026-09-18, its last commit was 2026-08-24. We re-verify nightly.

What can Talos Linux MCP Server do?

With this server connected, an agent can list all available resource types and their aliases. Call this first to discover what can be queried, list all Talos services and their current state (running, stopped, health), list containers in a namespace (default: k8s.io for Kubernetes containers), and list running processes on target nodes.

How do I install Talos Linux MCP Server?

Run `npx -y talos-mcp`. You can also paste the ready-made client config above.

Does Talos Linux MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Talos Linux MCP Server