run
Start both the API server and MCP gateway for local development:synthetiq server and synthetiq gateway together, providing everything apps and agents need to run locally. There is no separate per-app dev server — all apps in the workspace are served through the runtime.
| Flag | Default | Description |
|---|---|---|
--port <number> | 5940 | API server port |
--gateway-port <number> | 5941 | MCP gateway port |
server
Start the API server for workspace agents and multi-app loading:- Multi-app loading — Serves all apps in
_apps/from a single process - Agent API — Endpoint for workspace agent interactions
- Health checks — Monitoring endpoint at
/health
| Flag | Default | Description |
|---|---|---|
--port <number> | 5940 | Server port |
gateway
Start the local MCP gateway for all services in the workspace:_mcp/, loads them dynamically, and exposes them over the MCP protocol. Apps and agents connect to the gateway to call service tools.
| Flag | Default | Description |
|---|---|---|
--port <number> | 5941 | Gateway port |
--module-dir <path> | Current workspace | Workspace directory |