# Upgrade Brief

> Upgrade Brief is a paid MCP server for developer tools. Pay-per-call breaking-change briefs for npm, PyPI, Helm, Terraform, Rust and Go upgrades. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Website:** https://upgrade-brief.shopttyass-85f.workers.dev
- **MCP Registry name:** dev.workers.shopttyass-85f.upgrade-brief/upgrade-brief
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http upgrade-brief https://upgrade-brief.shopttyass-85f.workers.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://upgrade-brief.shopttyass-85f.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "upgrade-brief": {
      "url": "https://upgrade-brief.shopttyass-85f.workers.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "upgrade-brief": {
      "type": "http",
      "url": "https://upgrade-brief.shopttyass-85f.workers.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "upgrade-brief": {
      "serverUrl": "https://upgrade-brief.shopttyass-85f.workers.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "upgrade-brief": {
      "type": "http",
      "url": "https://upgrade-brief.shopttyass-85f.workers.dev/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/upgrade-brief
