1. Docs
  2. Reference
  3. Muster CLI
  4. CLI commands
  5. agent

Last modified June 21, 2026

'muster agent' command reference

muster agent connects to a running aggregator as an MCP client. Modern IDEs and the developer portal chat connect to the aggregator URL directly over remote, OAuth-protected MCP, so muster agent is an optional local bridge. Use it for clients that can only speak stdio, or to explore tools by hand.

The aggregator must be running first. Start it with muster serve.

Usage

muster agent [flags]

The command runs in one of three modes:

  • Normal (default): connects, lists tools, and waits for tool-update notifications.
  • REPL (--repl): an interactive prompt to list and run tools, resources, and prompts.
  • MCP server (--mcp-server): runs an MCP server over stdio that an IDE configures as its MCP endpoint. This is the local-bridge mode for stdio-only clients.

Flags

NameDescription
--endpointAggregator MCP endpoint URL. Reads the configured context when unset
--contextUse a named context. Reads MUSTER_CONTEXT when unset
--transportTransport for the connection: streamable-http (default) or sse
--replStart the interactive prompt
--mcp-serverRun as an MCP server over stdio, for stdio-only IDEs
--timeoutHow long to wait for notifications. Defaults to 5m
--authAuthentication mode: auto (default), prompt, or none. Reads MUSTER_AUTH_MODE when unset
--disable-auto-ssoDon’t authenticate to remote MCP servers automatically after Muster auth
--silentAttempt silent re-auth using OIDC prompt=none. Needs IdP support, not available with Dex
--verboseEnable verbose logging, including keepalive messages
--json-rpcLog full JSON-RPC messages
--no-colorDisable colored output
--config-pathConfiguration directory. Defaults to ~/.config/muster