Last modified June 21, 2026
Muster CLI and resource reference
muster is the command-line interface for Muster, the MCP gateway that gives AI agents unified, secure access to your fleet. This section documents the CLI commands, the meta-tools Muster exposes to agents, and the custom resources you author to extend it.
For a conceptual overview, start with AI agents on the platform. To connect your IDE, follow Set up your AI agent.
Reference pages
| Page | Description |
|---|---|
| Meta-tools | The meta-tools Muster exposes to agents, plus the core_* tool catalog |
| Custom resources | The MCPServer and Workflow schemas |
CLI commands
| Command | Description |
|---|---|
serve | Start the aggregator server |
standalone | Run the aggregator and agent in one process |
agent | Connect to the aggregator as a client, or bridge it over stdio |
context | Manage named endpoint contexts |
auth | Authenticate to a remote aggregator |
list | List resources |
get | Get details for one resource |
create | Create a workflow or MCP server definition |
call | Call an MCP tool by name |
start | Start a service or run a workflow |
stop | Stop a service |
check | Check that a resource is available |
events | List resource events |
version | Print CLI and server version |
self-update | Update the CLI from GitHub |
Common flags
The client commands that talk to a running aggregator (list, get, create, call, start, stop, check, events) share these flags:
| Name | Description |
|---|---|
--output, -o | Output format: table (default), wide, json, or yaml |
--no-headers | Suppress the header row in table output |
--quiet, -q | Suppress non-essential output |
--debug | Enable debug logging, showing MCP protocol messages |
--config-path | Configuration directory. Defaults to ~/.config/muster |
--endpoint | Remote aggregator endpoint URL. Reads MUSTER_ENDPOINT when unset |
--context | Use a named context. Reads MUSTER_CONTEXT when unset |
--auth | Authentication mode: auto (default), prompt, or none. Reads MUSTER_AUTH_MODE when unset |
Most of these commands need a running aggregator. Start one with muster serve, or point --endpoint at a remote one.
Configuration
Muster reads its configuration from ~/.config/muster by default. Override the directory with --config-path:
~/.config/muster/
├── config.yaml # aggregator port, host, transport, namespace
├── mcpservers/ # MCPServer definitions
└── workflows/ # Workflow definitions
In Kubernetes mode, Muster reads MCPServer and Workflow custom resources from the cluster instead. See Deploy Muster.
Contributing
See the GitHub project for source code, issues, and pull requests.
Need help, got feedback?
We listen to your Slack support channel. You can also reach us at support@giantswarm.io. And of course, we welcome your pull requests!