tinyhumansai/openhuman · error

invalid --port value `{raw}`

Error message

invalid --port value `{raw}`

What it means

CLI argument parsing in run_stdio_from_cli: the value following `--port` failed u16 parsing (out of range 0–65535 or non-numeric). Usage error, not a network failure — the MCP HTTP server never starts. Re-run with a valid port, e.g. `--port 9300` (the default).

Source

Thrown at src/openhuman/mcp/server/stdio.rs:59

                    "http" => McpTransport::Http,
                    other => bail!("unknown --transport value `{other}` (expected stdio or http)"),
                };
                index += 2;
            }
            "--host" => {
                bind_host = args
                    .get(index + 1)
                    .ok_or_else(|| anyhow::anyhow!("missing value for --host"))?
                    .clone();
                index += 2;
            }
            "--port" => {
                let raw = args
                    .get(index + 1)
                    .ok_or_else(|| anyhow::anyhow!("missing value for --port"))?;
                port = raw
                    .parse()
                    .map_err(|_| anyhow::anyhow!("invalid --port value `{raw}`"))?;
                index += 2;
            }
            "--auth-token" => {
                let token = args
                    .get(index + 1)
                    .ok_or_else(|| anyhow::anyhow!("missing value for --auth-token"))?;
                if token.trim().is_empty() {
                    bail!("--auth-token must not be empty");
                }
                auth_token = Some(token.trim().to_string());
                index += 2;
            }
            "-h" | "--help" => {
                print_help();
                return Ok(());
            }
            other => bail!("unknown mcp arg: {other}"),
        }

View on GitHub (pinned to 7491200858)

Solutions

1. Use a decimal port between 0 and 65535 (e.g. 9300)
2. Remove quotes, spaces or unit suffixes from the value

When it happens

Trigger: Thrown at src/openhuman/mcp/server/stdio.rs:59 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of tinyhumansai/openhuman@7491200858 (2026-08-17). Data as JSON: /api/errors/23706f85ec3437ff. Report an issue: GitHub.