Advertise
MCP.so
Sign In

Talos Linux MCP Server

@Nosmoht

Repository

Basic information

Category

Developer Tools

License

MIT

Transports

stdio

Author

Nosmoht

Submitted by

Thomas Krahn

About Talos Linux MCP Server

MCP server for Talos Linux cluster management via the native gRPC API

#talos#mcp#kubernetes

Talos Linux MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Talos Linux MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is 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). It provides structured tools that return machine-readable JSON directly from the Talos gRPC API using the same mTLS credentials as talosctl (~/.talos/config). Designed for operators managing Talos clusters.

How to use Talos Linux MCP Server?

Install via npx talos-mcp (no Go required, Linux/macOS, amd64/arm64), download a binary, or build from source with Go 1.21+. Configure via ~/.talos/config or environment variables like TALOSCONFIG and TALOS_CONTEXT. Start as stdio MCP server or enable Streamable HTTP with TALOS_MCP_HTTP_ADDR. Add to your MCP client config (e.g., .mcp.json for Claude Code, claude_desktop_config.json, or .codex/config.toml).

Key features of Talos Linux MCP Server

  • 14 read‑only tools for cluster introspection (logs, health, services, etc.)
  • 8 mutating tools with explicit safety guards (confirm, dry‑run)
  • Safety profiles and environment variables (read‑only mode, allowed nodes/paths)
  • Maintenance‑mode (insecure) operations with certificate fingerprint pinning
  • Upgrade path validation (at most one minor version at a time)
  • Supports Talos Linux v1.9.x through v1.13.x

Use cases of Talos Linux MCP Server

  • Diagnose cluster health and node issues via structured queries
  • Read logs, dmesg, process lists, and files from any node
  • Perform upgrades or rollbacks with validation and confirmation
  • Apply machine config patches or bootstrap new nodes in maintenance mode
  • Inspect etcd cluster status and take backups

Frequently asked questions

1

What Talos versions are supported?

Tested against Talos Linux v1.9.x through v1.13.x. A startup warning appears if the cluster version is outside this range.

2

How does upgrade path validation work?

The `talos_upgrade` tool ensures at most one minor version jump (e.g., v1.11.x → v1.12.x). Upgrades that skip more are rejected unless `TALOS_MCP_SKIP_VERSION_CHECK=true` is set.

3

How to enable maintenance‑mode (insecure) operations?

Set `TALOS_MCP_ENABLE_INSECURE=true` and `TALOS_MCP_INSECURE_ALLOWED_NODES` to a comma‑separated list of permitted maintenance‑mode IPs/CIDRs. Connection MITM can be mitigated with certificate fingerprint pinning.

4

Can I run the server in read‑only mode?

Yes. Set `TALOS_MCP_READ_ONLY=true` to disable all mutating tools at startup.

5

What transport and authentication is supported?

The server can run over stdio (default) or HTTP (when `TALOS_MCP_HTTP_ADDR` is set). HTTP mode requires a bearer token

Comments

More Developer Tools MCP servers

Leadpages MCP

Leadpages

Leadpages MCP is a remote MCP server available at https://mcp.leadpages.com.

Official Porkbun MCP Server

Porkbun LLC

Official Porkbun MCP server, maintained by Porkbun. Check domain availability and pricing, register, renew and transfer domains, and manage DNS records, nameservers, URL forwarding, glue records, DNSSEC and domain contac

32

LastPing

LastPing

Know when your AI agents, cron jobs and CI pipelines fail, stall or go quiet. Your agent sets up monitors from a plain description, tells you what is broken and why, reads run history and traces, and writes notes on inci

Eddyter AI Rich Text Editor MCP

EddyterAI

Set up and manage the Eddyter AI rich text editor by talking to your AI agent — for Claude, Cursor, Codex and other MCP tools. A Model Context Protocol server that lets AI tools add Eddyter to a React, Next.js, Vite or R

9

TaskerArmy Agent

TaskerArmy

Ask Claude or ChatGPT what Shopify theme optimization tasks are pending on your store, a remote MCP server for TaskerArmy Agent accounts.

Advertise