Upgrade Brief

{
  "name": "Upgrade Brief",
  "version": "0.3.1",
  "url": "https://upgrade-brief.shopttyass-85f.workers.dev",
  "description": "npm and PyPI breaking changes and changelog between two versions of a package, for a package upgrade or a multi-package dependency upgrade plan, read from the real changelogs and GitHub release notes (not model memory): breaking changes, migration guides, release notes, and manifest changes (Node.js engines, ESM/CJS, peer dependencies, Requires-Python). Paid per call in USDC via x402 (Base or Solana).",
  "provider": {
    "organization": "Upgrade Brief",
    "url": "https://upgrade-brief.shopttyass-85f.workers.dev"
  },
  "contact": {
    "email": "shopttyass@gmail.com"
  },
  "documentationUrl": "https://upgrade-brief.shopttyass-85f.workers.dev/openapi.json",
  "capabilities": {
    "streaming": false
  },
  "x-mcp": "https://upgrade-brief.shopttyass-85f.workers.dev/mcp",
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "breaking",
      "name": "npm Breaking Changes & Migration",
      "description": "npm breaking changes between two versions of a package, before a package upgrade: the documented breaking changes per version, read from the real CHANGELOG, GitHub release notes and alpha/beta/rc notes, plus major version bumps, Node.js engine, ESM/CJS, exports and peer dependency changes, migration guide links and a verdict. Exact versions or a major ('4'); a source URL for every item. One call per dependency upgrade.",
      "tags": [
        "npm breaking changes",
        "breaking-changes",
        "package upgrade",
        "migration guide",
        "dependency upgrade"
      ],
      "examples": [
        "https://upgrade-brief.shopttyass-85f.workers.dev/breaking?package=express&from=4.21.0&to=5.0.0"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "x-endpoint": {
        "method": "GET",
        "url": "https://upgrade-brief.shopttyass-85f.workers.dev/breaking",
        "price": "$0.005",
        "payment": "x402"
      }
    },
    {
      "id": "changelog",
      "name": "npm Changelog Between Versions",
      "description": "npm changelog between two versions: the full release notes of every version in the range (newest first, up to 100), from the package CHANGELOG and GitHub releases, with publish dates, bump type (major, minor, patch), npm deprecations, extracted breaking changes and package.json manifest changes. Covers a whole package upgrade or dependency upgrade in one call instead of reading dozens of release pages.",
      "tags": [
        "npm changelog",
        "changelog",
        "release notes",
        "package upgrade",
        "version diff"
      ],
      "examples": [
        "https://upgrade-brief.shopttyass-85f.workers.dev/changelog?package=chalk&from=4.1.2&to=5.0.0"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "x-endpoint": {
        "method": "GET",
        "url": "https://upgrade-brief.shopttyass-85f.workers.dev/changelog",
        "price": "$0.01",
        "payment": "x402"
      }
    },
    {
      "id": "pypiBreaking",
      "name": "PyPI Breaking Changes (Python)",
      "description": "PyPI breaking changes between two versions of a Python package, before a pip package upgrade: the documented breaking changes per version from the project's CHANGELOG, HISTORY or CHANGES file and GitHub release notes (alpha/beta/rc folded into the major), plus Requires-Python and required dependency changes, yanked versions, migration guide links and a verdict. PEP 440 versions ('1.10.13', '2.0') or a major ('1'); a source URL for every item.",
      "tags": [
        "pypi breaking changes",
        "python package upgrade",
        "breaking changes",
        "migration guide",
        "pip upgrade"
      ],
      "examples": [
        "https://upgrade-brief.shopttyass-85f.workers.dev/pypi/breaking-changes?package=pydantic&from=1.10.13&to=2.0"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "x-endpoint": {
        "method": "GET",
        "url": "https://upgrade-brief.shopttyass-85f.workers.dev/pypi/breaking-changes",
        "price": "$0.005",
        "payment": "x402"
      }
    },
    {
      "id": "pypiChangelog",
      "name": "PyPI Changelog Between Versions",
      "description": "PyPI changelog between two versions of a Python package: the full release notes of every version in the range (newest first, up to 100) from the project's changelog file and GitHub releases, with publish dates, bump type, yanked flags, extracted breaking changes and Requires-Python / dependency changes. One call instead of reading a long HISTORY or CHANGES file before a Python package upgrade.",
      "tags": [
        "pypi changelog",
        "python release notes",
        "changelog",
        "release notes",
        "version diff"
      ],
      "examples": [
        "https://upgrade-brief.shopttyass-85f.workers.dev/pypi/changelog?package=flask&from=2.3.3&to=3.0.0"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "x-endpoint": {
        "method": "GET",
        "url": "https://upgrade-brief.shopttyass-85f.workers.dev/pypi/changelog",
        "price": "$0.01",
        "payment": "x402"
      }
    },
    {
      "id": "plan",
      "name": "Dependency Upgrade Plan",
      "description": "Dependency upgrade plan for up to 5 npm or PyPI packages in one call (e.g. react, react-dom and next together): for each package the breaking changes between your version and the target, major bumps, Node.js or Python and peer dependency changes, migration guide links and a risk score, ordered by upgrade risk, plus the peer dependency requirements between the listed packages (next 15 needs react 19). Built from real changelogs and GitHub releases.",
      "tags": [
        "dependency upgrade",
        "upgrade plan",
        "breaking changes",
        "package.json upgrade",
        "package upgrade"
      ],
      "examples": [
        "https://upgrade-brief.shopttyass-85f.workers.dev/upgrade-plan?packages=react@18.3.1:19,react-dom@18.3.1:19,next@14.2.0:15&ecosystem=npm"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "x-endpoint": {
        "method": "GET",
        "url": "https://upgrade-brief.shopttyass-85f.workers.dev/upgrade-plan",
        "price": "$0.02",
        "payment": "x402"
      }
    }
  ]
}