Overview
The linuxctl command-line interface allows users and AI agents to seamlessly interact with the Linux Model Context Protocol (MCP) Daemon (mcpd) running in the background.
Grammar & Commands
The grammar
MCP Meta-Group
get mcp-api is a reserved meta-group for the MCP protocol's own top-level catalog concepts - not a real tools_group, and distinct from tool /resource (which invoke one specific item). It exists to answer "what can we get from this daemon over the MCP standard itself," straight from the protocol:
Full Command Reference
Every tool, resource, and resource template mcpd exposes, with real output captured live on an Ubuntu 24.04 VPS (host name and public addresses replaced with example ones). Mutating calls - creating and changing files, permissions, kernel parameters, services - are shown but were not run for this page; their output is what they print.
Daemon User Administration
The mcpd group edits the daemon's config files directly on disk - configs/users.yaml (users and token hashes) and configs/mcp-sudo.yaml (root grants) - and works even if the daemon isn't running. There is deliberately no MCP tool that edits these files: user/token administration is a privilege-escalation-relevant surface, so it stays with whoever has local access to the files (root, for an installed daemon), never with a remote agent.
Autocompletion (bash/zsh)
linuxctl completion prints a completion script for your shell. Once loaded, Tab completes every part of a command: