Upgrade Brief
Pay-per-call breaking-change briefs for npm, PyPI, Helm, Terraform, Rust and Go upgrades
- Pricing
- Paid
- Platforms
- API
- Runs
- Remotely
- Version
- 0.5.0
- Listing updated
- 2 days ago
About Upgrade Brief
Upgrade Brief is a paid MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.
Each brief is read from real changelogs, GitHub releases and registry data, with a source URL for every item, instead of the model guessing what changed. Calls are paid per request in USDC through x402, with no account or API key, over Base or Solana. Most briefs cost $0.005 to $0.01; changelogs are $0.01 and a multi-package plan is $0.02. Version listings are free.
The ecosystem coverage is specific. For npm it reports breaking changes, Node engine, ESM or CJS and peer dependency shifts. For PyPI it adds Requires-Python changes and yanked releases. GitHub Actions briefs diff action.yml and flag Node runtime changes. Helm briefs diff values.yaml, Terraform briefs read provider upgrade guides, Rust briefs cover feature flags and MSRV, and Go briefs cover go.mod and /vN import path moves.
The upgrade-plan tool takes up to five npm or PyPI packages together, orders them by risk and includes peer requirements between them. The service is at version 0.5.0 per its own endpoint.
Install
Run in a terminal
claude mcp add --transport http upgrade-brief https://upgrade-brief.shopttyass-85f.workers.dev/mcpAdd to Settings → Connectors → Add custom connector
https://upgrade-brief.shopttyass-85f.workers.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"upgrade-brief": {
"url": "https://upgrade-brief.shopttyass-85f.workers.dev/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"upgrade-brief": {
"type": "http",
"url": "https://upgrade-brief.shopttyass-85f.workers.dev/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"upgrade-brief": {
"serverUrl": "https://upgrade-brief.shopttyass-85f.workers.dev/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"upgrade-brief": {
"type": "http",
"url": "https://upgrade-brief.shopttyass-85f.workers.dev/mcp"
}
}
}Tools this server provides (12)
Taken from the project documentation; the running server may differ.
- npm_breaking_changes
- Breaking changes between two npm versions.
- npm_changelog
- Release notes between two npm versions.
- pypi_breaking_changes
- Breaking changes between two PyPI versions.
- pypi_changelog
- Release notes between two PyPI versions.
- dependency_upgrade_plan
- Upgrade plan for up to five npm or PyPI packages.
- github_action_breaking_changes
- Upgrade brief for a GitHub Action version change.
- helm_breaking_changes
- Upgrade brief for a Helm chart.
- terraform_breaking_changes
- Upgrade brief for a Terraform provider.
- crates_breaking_changes
- Upgrade brief for a Rust crate.
- go_breaking_changes
- Upgrade brief for a Go module.
- npm_versions
- Lists npm versions with dates and bump type.
- pypi_versions
- Lists PyPI versions with dates and bump type.
What it does
- Per-version breaking changes
- Documented breaking changes between two versions, each with a source URL.
- Full changelogs
- Release notes for up to 100 versions with dates and bump types.
- Multi-package plans
- Up to five npm or PyPI packages ordered by upgrade risk.
- GitHub Actions briefs
- action.yml diff, Node runtime changes and workflow edits.
- Infrastructure coverage
- Helm values diffs and Terraform provider upgrade guides.
- Free version lists
- List valid versions for npm and PyPI at no cost.
Good for
- Check what breaks before bumping a library to a new major version
- Plan a coordinated upgrade of react, react-dom and next
- Review a GitHub Actions version change in a workflow
- Prepare a Terraform provider or Helm chart upgrade
- Find the Go import path rewrite for a v1 to v3 move
Pricing
Paid
Pay per call: $0.005 to $0.02 in USDC via x402; version lists free
Prices change. Check upgrade-brief.shopttyass-85f.workers.dev before you buy.
Upgrade Brief FAQ
How much does a call cost?
$0.005 to $0.02 per paid call, in USDC via x402; version lists are free.
Do I need an account?
No account or API key is required.
Which ecosystems are covered?
npm, PyPI, GitHub Actions, Helm, Terraform, crates.io and Go modules.
Where does the data come from?
Changelogs, GitHub releases and registry or repository data.
Is Upgrade Brief free?
No. Upgrade Brief is a paid product.
How do I add Upgrade Brief to Claude Code?
Run this command in your terminal: claude mcp add --transport http upgrade-brief https://upgrade-brief.shopttyass-85f.workers.dev/mcp
What are the best alternatives to Upgrade Brief?
The closest alternatives to Upgrade Brief are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Upgrade Brief

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools