MergeScope

[](https://pypi.org/project/mergescope/) [](https://github.com/martin5211/MergeScope/actions/workflows/publish.yml) [](https://pypi.org/project/mergescope/)

Audits merged PRs against Jira tickets. Extracts Jira IDs from PR titles, descriptions, branch names, and commit messages, then validates each ticket's fixVersion against your expected release.

Powered by a LangGraph agent that talks to GitHub and Jira through MCP servers. Works standalone or with Amazon Q.

uvx mergescope --help

Or permanently:

uv tool install mergescope

mergescope \
  -f 2026-03-01 \
  -t 2026-03-31 \
  -v "1.2.0" \
  -r company/backend

| Flag | Description | |---|---| | -f, --from-date | Start date (YYYY-MM-DD) | | -t, --to-date | End date (YYYY-MM-DD) | | -v, --fix-version | Expected Jira fixVersion | | -r, --repo | GitHub repo (owner/repo) | | -c, --config | Config file (default: mergescope.yaml) | | --mcp-config | Amazon Q MCP config path | | --llm-provider | anthropic, bedrock, copilot, or local | | --llm-model | Model ID | | --llm-base-url | API base URL (copilot/local) | | --language | Response language (e.g. Spanish) | | --verbose | Debug logging |

Override the default prompt in mergescope.yaml. Supports {repo}, {from_date}, {to_date}, {fix_version}:

prompt_template: |
  I need to audit tickets merged between {from_date} and {to_date}.
  The expected fixVersion is {fix_version}.
  Extract Jira IDs from merge commits in {repo} and validate their fixVersion.

Works in any language:

language: "es"
response_language: "Spanish"
prompt_template: |
  Necesito auditar tickets mergeados entre {from_date} y {to_date}.
  La fixVers