Happy slice of mcp pizzaMCP.pizza

tidewave_phoenix

MCP.Pizza Chef: tidewave-ai

While you're building a Phoenix web application, this tool lets your coding assistant run real code inside your running app, check the actual logs, look up documentation for the exact library versions you're using, and query your development database directly. It works inside editors like Cursor and VS Code, needs no separate account or key, and installs by adding one small package to your project. It comes from the team behind Tidewave, a development environment built for Phoenix and Rails applications.

Coding
Data

Use This MCP server To

Run real code inside my running app to test an idea Check my app's live logs to see what broke Look up documentation for the exact library versions I'm using Query my development database right from my coding assistant Jump straight to the file and line where code lives List every database model in my project at once

README

Tidewave Phoenix

Tidewave Phoenix is an MCP server that provides runtime-level tools for developing Phoenix apps using coding agents.

Your agent will be able to use this MCP server to talk to your running Phoenix app in development to:

  • execute code in the context of the running app (like an IEx session for agents)
  • read the app's live logs
  • query your development database
  • get source locations of modules and functions
  • read documentation pinned to the exact hex package versions your project depends on

This MCP server is an open-source component of Tidewave, the agentic development environment for Phoenix and Rails.

You can use this project as a standalone MCP server or integrated with the Tidewave product by following the installation instructions below.

Installation

1. Add the Tidewave hex package to your app

Option 1: Manually

Add the tidewave package to your mix.exs:

def deps do
  [
    {:tidewave, "~> 0.6", only: :dev},
    {:phoenix, ...},
  ]
end

Then, for Phoenix applications, go to your lib/my_app_web/endpoint.ex and right above the if code_reloading? do block, add:

+  if Mix.env() == :dev do
+    plug Tidewave
+  end

   if code_reloading? do

tidewave_phoenix FAQ

Can I use this to check what went wrong after an error in my app?
Yes — it can read your app's live logs so your assistant sees exactly what happened, including the backtrace, right after the error occurs.
Can I use this to look up documentation for my project's dependencies?
Yes — it pulls documentation matched to the exact versions locked in your project, so you get accurate answers instead of generic ones that might not fit your setup.
Which apps does this work with?
It works with any assistant that supports MCP, including Cursor, VS Code, Claude Code, Codex, and Neovim.
Do I need an account or a paid key to use it?
No — it runs alongside your own project during development, with no external account, sign-up, or subscription required.
Is this easy to set up if I'm not very technical?
Not really — it's built for people already building an Elixir and Phoenix application, and setup means adding a package to your project and a couple of lines of code, which is a developer task.
Will this work on my live, public website?
No — it's meant to run only in development, connected to the copy of your app running on your own computer, not on a public production site.
Can I use this with Ruby on Rails instead of Phoenix?
This particular version is built for Phoenix and Elixir projects; the same company also makes a separate version for Rails.
Does it change my database or app without me asking first?
It only runs code or database queries when your assistant is prompted to, so keep an eye on what it's about to do if you're touching anything you can't easily undo.