Skip to content

$ cat the-official-ruby-sdk-for-mcp-reaches-tier-1.md

The Official Ruby SDK for MCP Reaches Tier 1

The official Ruby SDK for Model Context Protocol has reached Tier 1, the top tier of the MCP SDK tiering system. The article covers what Tier 1 guarantees, support for the 2026-07-28 spec in mcp gem 1.2.0, the documentation and conformance work behind the promotion, and how to upgrade.

MCP Blog30 Oct 2026 · 5 min read · summary
Read on blog.modelcontextprotocol.io ↗
The official Ruby SDK for Model Context Protocol is now a Tier 1 SDK, as defined in our SDK tiering system. Ruby is not alone here, and joins the company of our TypeScript, Python, C#, Go, and Rust SDKs. When an SDK becomes Tier 1-compliant, it means that it reached the top of the three tiers, reserved for SDKs with the highest level of feature support, responsiveness to bugs and security issues, and alignment with MCP ecosystem priorities. If you build MCP servers or clients in Ruby, you can now sleep well knowing that you will get full spec feature support, a 100% conformance pass rate, support for new spec versions by their release date, issue triage within two business days, and critical bug fixes within seven days. This is especially important for developers that are responsible for production-grade services and applications, where being on the bleeding edge of MCP development is critical for the business. Get the Ruby SDK → Read the documentation → Full support for the 2026-07-28 MCP spec Starting with version 1.2.0 of the mcp gem, the Ruby SDK for MCP fully supports the 2026-07-28 MCP spec, which means that Ruby developers now get access to some highly-anticipated features and capabilities: The stateless lifecycle (SEP-2575) is served alongside the classic session handshake, including server/discover and the subscriptions/listen notification stream Multi round-trip requests (SEP-2322) work on both the server and the client, and a built-in shim lets handlers written in the new input_required style serve pre-2026 clients unchanged Cache hints (SEP-2549) are emitted on the modern path, the client sends the standard and custom HTTP request headers (SEP-2243), and the server checks the standard ones Roots, Sampling, and Logging are marked deprecated per SEP-2577, and clients connecting with the 2026-07-28 protocol version warn when they declare the Roots or Sampling capabilities The server serves both lifecycle eras side by side, so current clients keep working while 2026-07-28 clients use the stateless path. See Protocol Versions for how the SDK handles each variant of the MCP spec. Several 1.x releases, starting with 1.2.0, reject input that earlier releases accepted. The SDK’s versioning policy allows such changes to fix spec conformance, security issues, and clear defects - we recommend reading the changelog before upgrading an existing 1.x application to make sure that you’re ready for any breaking changes. The journey to Tier 1 The Tier 2 assessment in July showed that the SDK was already pretty close to the benchmarks we established, meeting eight of the ten Tier 1 requirements. Two things were left, however: the documentation didn’t cover every feature yet, and there was no agreed timeline for supporting new versions of the spec. Since then, we made a few changes to put us on a more robust track to conformance: Every implemented feature is documented in detail, with accompanying examples, from non-text content types through elicitation options to the full OAuth client flow. With version 1.3.0, this documentation moved from a simple in-repo README.md file to a revamped documentation site. We’re very excited to see developers lean on this resource as the go-to page for all things Ruby MCP SDK. The SDK passes 100% of the scored server and client conformance scenarios for both the 2025-11-25 and 2026-07-28 requirement sets, measured with the standard MCP conformance suite’s frozen scoring for each spec version. The repository maintained a 100% issue triage rate within the Tier 1 window, with no P0 issues filed. If you report an issue, we’re going to look at it as soon as possible. If you are curious about the full evidence tables for standards conformance, including repro steps for the conformance results, you can refer to our Tier 1 assessment. And as the specification evolves, the Ruby SDK team has committed to supporting the next MCP spec, targeted for late March 2027, by its release date. The SDK roadmap covers all other planned features and extensions, including the newly-introduced tasks extension. If you haven’t noticed yet, the road here was short but quite steep: the SDK was initially assessed at Tier 3 in March 2026, reached Tier 2 with the 1.0 release in July, and applied for Tier 1 in August. It was confirmed at Tier 1 in September - in under seven months, server conformance went from 25 of 30 scenarios to every scored scenario, client conformance went from untested to 100%, and documented features went from 22 of 48 to 46. This was only possible thanks to our SDK maintainers and a community of Ruby developers who helped us with input and feedback along the way! Oh, and if you’re counting the features we haven’t documented - the two that remain are the legacy SSE transport, which the SDK intentionally does not implement, as it was deprecated. Get started To get started, add the gem to your application: bundle add mcp Alternatively, you can install it on its own with gem install mcp. To upgrade an existing application, set the constraint in your Gemfile and run bundle update mcp: gem 'mcp', '~> 1.8' If you are already running a 1.x server, upgrading lets it serve 2026-07-28 clients alongside existing ones. See the Ruby SDK documentation for guides on building servers and clients, including Rails integration, and the 1.0 announcement for a walkthrough of the basics. Give us your feedback If you run into any problems or unexpected behavior while using the SDK, please report them in our issue tracker. Acknowledgements The Ruby SDK is maintained by Topher Bullock, Koichi Ito, Ateş Göral, and Jonathan Hefner together with the broader Ruby community. Thank you to everyone for the feedback and contributions on the road from Tier 3 to Tier 1! We could not have done this without you. Special thanks to Felix Weinberger and Paul Carleton for their review and independent verification of the Tier 1 assessment, and to Den Delimarsky for the final review.

source

This is a summary of an article first published by MCP Blog. The full piece is on their site.

Open original