[v1.x] Add a v2 status banner to the README#2835
Merged
Merged
Conversation
States that v2 is in alpha with pre-releases published to PyPI as 2.0.0aN, that installers never select a pre-release without an explicit opt-in, that packages depending on mcp should add a <2 upper bound before the stable v2 release, and that v1.x is in maintenance mode and remains recommended for production. This README is also the PyPI project description for stable releases, so the banner uses absolute links and plain blockquote markup.
felixweinberger
approved these changes
Jun 11, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a short banner to the v1.x README announcing the v2 alpha.
Motivation and Context
v2 pre-releases are about to be published to PyPI as
2.0.0aN. This branch's README is both the repository documentation for the stable line and the PyPI project description for every stable release, so it is the highest-traffic place to tell users three things: v2 is coming and is currently in alpha, installers will not give anyone a pre-release without an explicit opt-in, and packages that depend onmcpshould add a<2upper bound before the stable v2 release lands. It also states v1.x's maintenance-mode status.The banner uses plain blockquote markup and absolute URLs so it renders correctly on PyPI (no GitHub-only alert syntax, no relative links).
A companion PR on
main(#2834) updates that branch's README banner to match.How Has This Been Tested?
markdownlint and pre-commit pass; docs-only change.
Breaking Changes
None.
Types of changes
Checklist
AI Disclaimer