# Tidewave Rails

> Tidewave Rails is an open-source MCP server for developer tools. MCP server giving coding agents live access to a running Rails development app. It is available on CLI and self-hosted.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/tidewave-ai/tidewave_rails
- **MCP Registry name:** io.github.tidewave-ai/tidewave-rails
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Tools

- `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.

## 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.

## Alternatives

- [Tidewave Phoenix](https://ai-powered.com/mcp/tidewave-phoenix): Tidewave Phoenix is an open-source MCP server for developer tools.
- [Rails AI Context](https://ai-powered.com/mcp/rails-ai-context): Rails AI Context is an open-source MCP server for developer tools.
- [Codemagic MCP by usefulapi](https://ai-powered.com/mcp/codemagic-mcp-by-usefulapi): Codemagic MCP by usefulapi is a freemium MCP server for developer tools.
- [Vibe Shipped](https://ai-powered.com/mcp/vibe-shipped): Vibe Shipped is a free MCP server for developer tools.
- [RoRvsWild](https://ai-powered.com/mcp/rorvswild): RoRvsWild is an MCP server for developer tools.
- [Tently](https://ai-powered.com/mcp/tently): Tently is a freemium MCP server for developer tools.
- [Gemmein](https://ai-powered.com/mcp/gemmein): Gemmein is a freemium MCP server for developer tools.
- [agent-manager.dev documentation](https://ai-powered.com/mcp/agent-manager-dev-documentation): agent-manager.dev documentation is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/tidewave-rails
