Upgrading from 0.8 to 1.0

Version 1.0 is a stable release with no breaking changes. Upgrade by updating your Gemfile.

Table of contents

  1. Breaking Changes
  2. Upgrade Steps
    1. 1. Update Gemfile
    2. 2. Done!
  3. What’s New in 1.0
  4. Optional: Custom Transport Registration
  5. Resources

Breaking Changes

✓ No Breaking Changes

Version 1.0 maintains full backward compatibility with 0.8.x. All existing code continues to work without modifications.

Upgrade Steps

1. Update Gemfile 

gem 'ruby_llm-mcp', '~> 1.0'

Optional - for MCP SDK adapter (requires Ruby 3.1+):

gem 'mcp', '~> 0.7'

Then run:

bundle update ruby_llm-mcp

2. Done!

Your existing 0.8 code will work without changes.

What’s New in 1.0

  • Stable adapter system - Production-ready RubyLLM and MCP SDK adapters
  • Enhanced documentation - Merged and improved guides
  • Custom transport clarity - Proper namespace documentation for RubyLLM::MCP::Native::Transport.register_transport

Optional: Custom Transport Registration

If you’re using custom transports, ensure you use the correct namespace:

# Correct registration (was unclear in 0.8 docs)
RubyLLM::MCP::Native::Transport.register_transport(:custom, CustomTransport)

Resources

Congratulations on upgrading to 1.0! 🎉

Questions? Open an issue or check the documentation.