supercorp-ai/supergateway

Questions, ideas or just want to chat? Join the community on Discord.
Supported by:
Supercov — Coverage for coding agents and software factories 🌙
Superinterface
Supercorp
## Installation & Usage
Run Supergateway via npx:
bash
npx -y supergateway --stdio "uvx mcp-server-git"
--stdio "command": Command that runs an MCP server over stdio
--sse "https://mcp-server-ab71a6b2-cd55-49d0-adba-562bc85956e3.supermachine.app": SSE URL to connect to (SSE→stdio mode)
--streamableHttp "https://mcp-server.example.com/mcp": Streamable HTTP URL to connect to (StreamableHttp→stdio mode)
--outputTransport stdio | sse | ws | streamableHttp: Output MCP transport (default: sse with --stdio, stdio with --sse or --streamableHttp). A remote server given with --sse or --streamableHttp can be served over sse, ws or streamableHttp too; see Remote server → SSE, WS or Streamable HTTP
--port 8000: Port to listen on (stdio→SSE, stdio→WS or stdio→Streamable HTTP mode, default: 8000)
--host 127.0.0.1: Address to listen on, e.g. 127.0.0.1 or ::1 ([::1] also works) (stdio→SSE, stdio→WS or stdio→Streamable HTTP mode, default: every interface). --baseUrl does not control binding: only --host limits which addresses accept connections. Refused in SSE→stdio and Streamable HTTP→stdio mode, which listen on nothing
--baseUrl "http://localhost:8000": Base URL for SSE clients (stdio→SSE mode; optional)
--ssePath "/sse": Path for SSE subscriptions (stdio→SSE mode, default: /sse)
--messagePath "/message": Path for messages (stdio→SSE or stdio→WS mode, default: /message)
--streamableHttpPath "/mcp": Path for Streamable HTTP (stdio→Streamable HTTP mode, default: /mcp)
--stateful: Run stdio→Streamable HTTP in stateful mode
--sessionTimeout 60000: Session timeout in milliseconds (stateful stdio→Streamable HTTP mode only)
--protocolVersion "2025-06-18": Protocol version the gateway uses when it initializes the server itself and the client's request doesn't name one (stateless stdio→Streamable HTTP mode, default: 2024-11-05)
--header "x-user-id: 123": Add one or more headers (stdio→SSE, stdio→Streamable HTTP, SSE→stdio, or Streamable HTTP→stdio mode; can be used multiple times). With a local server they go on the gateway's responses; with a remote one (--sse, --streamableHttp) they are sent to the remote server
--oauth2Bearer "some-access-token": Adds an Authorization header with the provided Bearer token
--logLevel debug | info | none: Controls logging level (default: info). Use debug for more verbose logs, none to suppress all logs.
--logFormat text | json: Log line format (default: text). json writes one JSON object per line with time, level, msg and, when a log call carries values, data, for ELK and similar log pipelines. Logs go to the same streams as text, so stdio output still carries only MCP messages.
--cors: Enable CORS (stdio→SSE or stdio→WS mode). Use --cors with no values to allow all origins, or supply one or more allowed origins (e.g. --cors "http://example.com" or --cors "/example\\.com$/" for regex matching).
--healthEndpoint /healthz: Register one or more endpoints (every mode but stdio output; can be used multiple times) that respond with "ok"