> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pwno.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Contributing

> How to contribute code or documentation to pwno-mcp.

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

```bash theme={null}
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