Contributing

Thanks for considering a contribution to green-api-mcp-gateway.

Quick start

git clone https://github.com/green-api/green-api-mcp-gateway.git
cd green-api-mcp-gateway
make lint test build

Requires Go 1.25+ and golangci-lint.

Open an issue first if the change is non-trivial — it's easier to align on direction before code is written.
Use Conventional Commits for commit messages (feat:, fix:, docs:, chore:, refactor:, test:).
Keep PRs focused — one concern per PR.
Include tests for new behaviour. Run make test locally before pushing.
CI must be green before merge.

Please include:

What you expected to happen
What actually happened
Steps to reproduce (minimal config / commands)
Output of ./green-api-mcp-gateway --version (or commit SHA if built from source)
Relevant logs with secrets redacted

See .github/ISSUE_TEMPLATE/ for bug-report and feature-request templates.