Skip to content
MCP server

Upgrade Brief

Pay-per-call breaking-change briefs for npm, PyPI, Helm, Terraform, Rust and Go upgrades

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://upgrade-brief.shopttyass-85f.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "upgrade-brief": {
      "url": "https://upgrade-brief.shopttyass-85f.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools