Upgrading from 0.6 to 0.7

This guide covers the changes and migration steps when upgrading from RubyLLM MCP version 0.6.x to 0.7.x.

Table of contents

  1. Breaking Changes
    1. RubyLLM 1.9 Requirement
  2. Deprecated Features
    1. Complex Parameters Support (Now Default)
  3. Getting Help
  4. Next Steps

Breaking Changes

RubyLLM 1.9 Requirement

Version 0.7 requires RubyLLM 1.9 or higher. Make sure to update your ruby_llm dependency:

# Gemfile
gem 'ruby_llm', '~> 1.9'
gem 'ruby_llm-mcp', '~> 0.7'

Then run:

bundle update ruby_llm ruby_llm-mcp

Deprecated Features

Complex Parameters Support (Now Default)

The support_complex_parameters! method is deprecated and will be removed in version 0.8.0.

What Changed:

In version 0.6.x and earlier, you had to explicitly enable complex parameter support for MCP tools to handle arrays and nested objects:

# Version 0.6.x (OLD - deprecated)
RubyLLM::MCP.configure do |config|
  config.support_complex_parameters!
end

In version 0.7.x, complex parameters are supported by default. You no longer need to call this method.

Getting Help

If you encounter issues during the upgrade:

  1. Check the GitHub Issues for similar problems
  2. Review the Configuration Guide for updated examples
  3. Open a new issue with details about your setup and the error message

Next Steps

After upgrading: