Skip to main content
Contributions are welcome.

​
Before opening a pull request

  1. Sync dependencies with uv sync --locked --extra dev.
  2. Run formatting, type checking, and tests.
  3. Keep changes small and focused.
  4. Update README.md or docs/ when behavior changes.

​
Validation commands

uv run black --check .
uv run mypy pwnomcp --ignore-missing-imports --disable-error-code=import-untyped
uv run pytest -v

​
Documentation expectations

  • keep Mintlify navigation in docs/docs.json aligned with new pages
  • use the existing product vocabulary: sessions, /workspace, HTTP vs stdio, and tool families
  • prefer short, workflow-oriented examples over long README-style narrative