mcp release semver agents changelog 

Release Gate

Release intelligence for AI agents. Analyze changes, detect breaking updates, and recommend the next semantic version.

Version

v0.1.3

License

MIT

Platforms

Node 18 or newer, Any MCP client

Interfaces

CLI, MCP

View on GitHubnpm packageMCP server

Overview

Version bumps and changelogs are hand rolled. An agent cannot tell whether a change is breaking or patch, so either nothing ships or the wrong version does. Release Gate reads the commits and the diff and answers with evidence.

Setup

npm install -g release-gate-mcp

Add the server to your MCP client.

{
  "mcpServers": {
    "release": {
      "command": "release-gate-mcp",
      "args": []
    }
  }
}

Usage

  • release.analyze classify commits since the last tag, detect breaking changes, and recommend the next bump.
  • release.notes generate release notes grouped by type from the commits since the last tag.
  • release.bump compute the next semantic version from the current version and the recommended bump.

Breaking changes are detected two ways:

  • Conventional commit markers such as refactor!: and BREAKING CHANGE in messages.
  • Removed exported symbols in the diff, which catch breaking changes that were never announced in a message.

Typical agent instructions:

  • “Is this change breaking or patch?”
  • “Write the release notes for the next release.”
  • “What version should we ship next?”

Gains

  • Semantic versions chosen from evidence, not a coin toss.
  • Breaking changes surfaced even when the commit message is quiet.
  • Release notes generated in seconds, grouped and readable.
  • A release gate agents can enforce before a publish is allowed.

Repository