`oroc mcp`

Run a Model Context Protocol (MCP) server for agent tooling.

By default this subcommand speaks JSON-RPC over stdio (stdout is reserved for MCP messages). Use --http to run an HTTP/SSE transport.

Usage#

oroc mcp [options] [<workspace-dir>]

Option	Description
`--stdio`	stdio transport (default)
`--http`	HTTP/SSE transport
`--host=<host>`	bind host (default: 127.0.0.1)
`--port=<port>`	bind port (default: 0 for ephemeral)
`--endpoint=<path>`	endpoint path (default: /mcp)
`--token=<token>`	require bearer token (default varies)
`--no-auth`	disable token auth (loopback only)
`--workspace=<path>`	workspace root (default: CWD or )
`--config=<path>`	oro.toml path relative to workspace (default: oro.toml)
`--read-workspace-only`	restrict filesystem reads to workspace root
`--allow-read-outside-workspace`	allow reading files outside workspace (default)
`--replace-sse-stream`	allow a new SSE connection to replace an existing one

Stdio mode disables JSON logs and suppresses INFO output so stdout remains valid MCP JSON-RPC.
HTTP mode implements MCP Streamable HTTP (2025-06-18). Clients must call initialize and then include Mcp-Session-Id on subsequent requests.