Generate a categorized changelog
generate_changelogGenerate a categorized Markdown changelog from GitHub commits between two refs. Parses Conventional Commits or uses keyword heuristics to organize changes into Features, Bug Fixes, Docs, and more.
Instructions
Generate a clean, categorized Markdown changelog (Features / Bug Fixes / Docs / etc.) between two refs in a public GitHub repository. Uses Conventional Commits parsing where available and falls back to keyword heuristics otherwise. This is the main tool — use list_tags first if you don't know valid ref names.
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": {
"owner": "<owner>",
"repo": "<repo>",
"from_ref": "<from_ref>",
"to_ref": "<to_ref>"
},
"name": "generate_changelog"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| repo | Yes | Repository name, e.g. 'react' | |
| owner | Yes | Repository owner, e.g. 'facebook' | |
| to_ref | Yes | Ending ref (newer), e.g. 'main' or the latest tag | |
| from_ref | Yes | Starting ref (older), e.g. a previous release tag | |
| include_contributors | No | Append a contributor commit-count summary (default false) |