GitHub release notes generator
github_release_notesWrite the release notes for a release or tag of a public GitHub repository: compares two of its releases or plain Git tags (default: the latest release vs the one before) and turns the commits and merged pull requests between them into a Keep a Changelog 2.0.0 section with breaking changes flagged and their migration steps, plus plain-language release notes that thank the contributors. With mode "backfill" it writes the notes for each tag in a run of consecutive version tags (up to 10; by default the newest tags that were never published as GitHub releases) and returns a ready-to-run gh release create <tag> --notes-file … script that publishes them. Also returns the merged pull requests, the releases and tags to pick from (each labelled release or tag) and how each commit was sorted. Deterministic, no AI, no sign-in.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"repository": "<repository>"
},
"name": "github_release_notes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | The release or plain tag to write notes for. Default: the latest release. A branch name gives what's merged since `from`. In backfill mode: the newest tag of the run; default: the newest tag without a GitHub release. | |
| from | No | The earlier release or tag (not included). Default: the release before `to` (the tag before it for a plain tag). In backfill mode: the tag the run starts after; default: the nearest release before `to`. | |
| mode | No | "single" (default): one release. "backfill": every tag after `from` up to `to`, each compared with the tag before it, plus a script that creates the missing GitHub releases. | |
| output | No | What the text answer contains: "both" (default: release notes and Keep a Changelog; in backfill mode also the script), "keep-a-changelog" (CHANGELOG.md sections), "release-notes" (for GitHub releases or an announcement) or "script" (backfill only: the gh script). | |
| repository | Yes | Public github.com repository: "owner/repo" or its URL. A release URL (…/releases/tag/v1.2.0) or compare URL sets the range too. | |
| include_prereleases | No | Backfill only: include pre-release tags such as v2.0.0-rc.1 in the run. Default false, so each stable release covers everything since the stable one before it. |