</>MCP Agents Market
MCP Server

tidewave_phoenix

by tidewave-ai852ElixirUpdated 2026-09-07

MCP server with runtime-level tools for Phoenix development

Claude CodeCodexCursorVS Code

Tidewave Phoenix is an MCP server that connects AI coding agents directly to running Phoenix applications during development. It exposes runtime-level capabilities similar to an IEx session, enabling agents to execute Elixir code in the app context, query development databases, read live logs, and access documentation pinned to exact dependency versions. Developers install it as a Hex package plug in their Phoenix app and connect it via HTTP to supported MCP clients. Originally developed by Dashbit as part of the Tidewave agentic development environment, it works standalone or integrated with the full Tidewave product.

Key Features

Execute Elixir code within the running application context, like an IEx session for AI agents
Query development databases directly using SQL through the execute_sql_query tool
Read application logs in real-time to debug issues and verify behavior
Retrieve documentation for modules and functions from exact versions in mix.lock
Locate source code definitions by file and line across the app and hex dependencies
HTTP/streamable transport connects to Phoenix apps at their development server endpoint
Automatic Content-Security-Policy adjustments for development environments
Supports umbrella projects and multiple hosts/subdomains via *.localhost

Use Cases

  • 01Debugging Phoenix applications by reproducing failing code paths against live runtime state
  • 02Verifying database changes and query results during agent-assisted development
  • 03Investigating request failures by reading backtrace logs immediately after errors occur
  • 04Navigating to exact source locations in dependencies without manual grepping
  • 05Testing function behavior by calling it against the actual running app instead of assumptions
  • 06Building Phoenix features with AI agents that understand the runtime environment and dependencies

Related MCP Servers

View more

tidewave_phoenix — FAQ

What is the Tidewave Phoenix MCP server?+

It's an MCP server that connects AI coding agents to running Phoenix applications in development mode, providing tools to execute code, query databases, read logs, and access documentation within the app's runtime context.

How do I install Tidewave Phoenix in my Phoenix app?+

Add {:tidewave, "~> 0.6", only: :dev} to your mix.exs dependencies, then add 'plug Tidewave' in your endpoint.ex file above the code_reloading block. Alternatively, use mix igniter.install tidewave for automatic installation.

Which MCP clients work with Tidewave Phoenix?+

It works with Claude Code, Codex, Cursor, Neovim, OpenCode, VS Code, and other MCP clients that support HTTP/streamable transport. Configure them to connect to http://localhost:4000/tidewave/mcp or your app's development server endpoint.

Do I need API keys to use this MCP server?+

No API keys are required. You only need a Phoenix application running in development mode with the Tidewave hex package installed and configured.

Is Tidewave Phoenix free and open source?+

Yes, it's open source under the Apache License 2.0. It can be used standalone for free or integrated with the commercial Tidewave product.

What are the prerequisites for using this server?+

You need an Elixir Phoenix application (v1.8+ recommended, LiveView v1.1+ for best results) running in development mode. The server must be accessible via HTTP, typically at localhost:4000.

How do I install tidewave_phoenix?+

Open the source repository on GitHub and follow its README. tidewave_phoenix is a mcp server — MCP Agents Market links you directly to the official repo.

Is tidewave_phoenix free?+

tidewave_phoenix is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.

Related searches