Skip to content
MCP server

Tidewave Rails

MCP server giving coding agents live access to a running Rails development app

Pricing
Open source
Platforms
CLI, self-hosted
Version
0.8.0
Listing updated
today

Similar MCP servers

About Tidewave Rails

Tidewave Rails is an open-source MCP server for developer tools. It is available on CLI and self-hosted.

The README says Tidewave Rails lets a coding agent talk to a Rails app while it runs in development. Instead of guessing at behavior from source files, the agent can execute Ruby inside the live process, read the app's logs, and run SQL against the development database.

It also looks up documentation pinned to the gem versions listed in the app's Gemfile.lock, and resolves where classes and methods are defined, including methods generated at runtime and code installed by gem dependencies. It is installed as a gem in the development group and connects to the app's own server over streamable HTTP at the /tidewave/mcp path.

The project is aimed at Rails developers who use AI coding agents and want them grounded in their running application. The README warns that it is not meant for production, and it raises an error when code reloading is disabled.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

project_eval
Evaluates Ruby code in the context of the running application and returns the result and printed output.
execute_sql_query
Runs a SQL query against the app's development database and returns the rows.
get_docs
Looks up documentation for a class, method, or constant using the gem versions in Gemfile.lock.
get_source_location
Returns the file and line where a class, module, or method is defined.

What it does

Runtime code execution
Runs Ruby code inside the running app and returns the result and any printed output.
Live log reading
Lets the agent read the application's logs as they are produced.
Development database queries
Runs SQL against the development database and returns the rows.
Version-pinned gem docs
Looks up documentation for classes, methods and constants matching the gem versions in Gemfile.lock.
Source location lookup
Reports the file and line where a class or method is defined, including inside gem dependencies.

Good for

  • Reproduce a failing code path against live application state while debugging
  • Check that a create action saved records with the expected values
  • Insert test records to see how a page renders with realistic data
  • Find where a method defined through metaprogramming or a gem is declared
  • Look up API docs for the exact gem versions an app uses before generating code

Pricing

Open source

Open source under Apache License 2.0; part of the Tidewave product.

Tidewave Rails FAQ

How does an agent connect to Tidewave Rails?

The README says to add the MCP server to the client configuration as an http (streamable) type, pointing to the /tidewave/mcp path on the port the web app runs on, for example http://localhost:3000/tidewave/mcp.

Can it be used in production?

No. The README says Tidewave is not meant for production and raises an error in any environment where code reloading is disabled.

Does it provide tools for routes or associations?

No. The README explains that agents are better off reading those source files directly, so the project does not include route or association tools.

Which ORM does it support?

The configuration lists active_record as the default and sequel as an alternative via preferred_orm.

Is Tidewave Rails free?

Yes. Tidewave Rails is open source, so you can use and self-host it for free.

What are the best alternatives to Tidewave Rails?

The closest alternatives to Tidewave Rails are Tidewave Phoenix, Rails AI Context, Codemagic MCP by usefulapi, Vibe Shipped and RoRvsWild.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.

How AIPoweredBot checks servers