Skip to content

Gateway CLI

The Freesail Gateway (freesail-gateway) serves as the bridge between AI Agents (via MCP) and the Frontend (via Server Sent Events). It supports multiple running modes and configuration options.

npx freesail-gateway \[options\]
OptionDefaultDescription
—http-port <port>3001The port for the UI-facing HTTP/SSE server.
—mcp-mode <mode>stdioThe transport mode for the Agent connection. Options: stdio (default) or http.
—mcp-port <port>3000The port for the MCP Streamable HTTP server (only used if mode is http).
—mcp-host <host>127.0.0.1The host to bind the MCP server to. Defaults to localhost for security.
—log-file <file>undefinedPath to a file where logs should be written.