aos serve

Expose this machine’s commands to other agents

2 commands. Run aos serve --help for the same list from the binary, or see every group.

Expose the commands to an MCP client. mcp serves every available non-blocking command as a typed tool over HTTP on loopback, guarded by a per-run or pinned token. tools previews the catalogue without starting a server. See using it from an agent (MCP).

Commands

aos serve mcp

Serve every command as an MCP tool over streamable HTTP

aos serve mcp [--addr=<host:port> | --socket=<path>] [--token=<k>] [--groups=<a,b>] [--gui=on|off|auto] [--quiet]

flag	values	meaning
--addr	<host:port>	Optional
--socket	<path>	Optional
--token	<k>	Optional
--groups	<a,b>	Optional. comma-separated
--gui	on, off, auto	Optional
--quiet		Optional

aos serve mcp
aos serve mcp --socket=~/.aos/serve.sock   # the host end of an SSH RemoteForward
aos serve mcp --addr=127.0.0.1:9000 --groups=window,capture,exec
aos serve mcp --gui=off   # screenless tools only

aos serve tools

Print the MCP tool catalogue this machine would expose

aos serve tools [--groups=<a,b>]

flag	values	meaning
--groups	<a,b>	Optional. comma-separated

aos serve tools --groups=window