Skip to main content
This page covers the main knobs exposed by pwno-mcp itself.

CLI flags

FlagDefaultPurpose
--host0.0.0.0bind host for the main HTTP server
--port5500bind port for the main HTTP server
--attach-host127.0.0.1bind host for the attach sidecar API
--attach-port5501bind port for the attach sidecar API
--http-path/mcpmain HTTP transport path
--stdiooffrun as a stdio MCP server instead of HTTP

Environment variables

VariablePurpose
PWNO_RUNTIME_ROOToverride the root directory for session runtime data, process logs, and shared helper artifacts
BINARY_URLenables lazy RetDec analysis against an externally reachable binary URL

Example launches

python -m pwnomcp

Operational defaults

  • main HTTP endpoint: http://127.0.0.1:5500/mcp
  • health check: http://127.0.0.1:5500/healthz
  • attach sidecar: http://127.0.0.1:5501/attach
  • workspace root inside the runtime: /workspace
Use Docker and Compose for launch recipes and Troubleshooting for common misconfigurations.