# Verdi Bridge

> Verdi Bridge is an open-source MCP server for developer tools. Let an AI agent inspect waveforms and navigate RTL inside a live Synopsys Verdi session. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux
- **Repository:** https://github.com/ruihongy/verdi_bridge
- **MCP Registry name:** io.github.RuihongY/verdi-bridge
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [engineering simulation](https://ai-powered.com/categories/engineering-simulation)
- **Listing updated:** 2026-11-18

## About

Verdi Bridge connects an agent to a running Synopsys Verdi debug session, so a request such as adding FIFO pointers and investigating why a full flag stayed high turns into visible actions in the waveform and source windows. The agent reasons and the bridge observes, with 18 typed tools that work locally or over SSH on your existing Verdi setup.

Tools cover finding and displaying signals, moving the cursor and time window, jumping before an error, listing value changes and transitions, sampling signals on a clock and counting changes over long windows. Others read simulation logs, measure a clock, trace a signal's driver and open the driving source. Waveform queries preserve X and Z values, time arguments carry explicit units, and big FSDB files can be read outside the GUI through Verdi's NPI reader.

A licensed Verdi installation is required and nothing from the vendor is bundled. The README labels it experimental at version 0.3.3, tested with Verdi T-2022.06-SP2-1 on Linux, and says it does not compile, edit or repair RTL. It is MIT licensed and not affiliated with Synopsys.

## Features

- **Signal discovery:** Finds and adds signals to the waveform view.
- **Time navigation:** Sets cursor and window, or jumps before an error.
- **Value inspection:** Reads transitions and value changes, preserving X and Z.
- **Clock sampling:** Samples signals on a clock and counts changes.
- **Driver tracing:** Follows a signal to its driving RTL and opens the source.
- **Remote operation:** Works locally or over SSH with an existing Verdi.
- **Large waveform reads:** Uses the NPI reader for large FSDB files.

## Good for

- Find when a handshake signal dropped
- Investigate why a FIFO full flag stayed high
- Open the RTL that drives a failing signal
- Summarise activity across a long simulation window
- Measure a clock from the waveform

## Install

### Claude Code (Terminal)

```sh
claude mcp add verdi-bridge -- uvx verdi-bridge
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "verdi-bridge": {
      "command": "uvx",
      "args": [
        "verdi-bridge"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "verdi-bridge": {
      "command": "uvx",
      "args": [
        "verdi-bridge"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "verdi-bridge": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "verdi-bridge"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "verdi-bridge": {
      "command": "uvx",
      "args": [
        "verdi-bridge"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "verdi-bridge": {
      "command": "uvx",
      "args": [
        "verdi-bridge"
      ]
    }
  }
}
```

## Tools

- `find_signals`: Finds signals by name.
- `browse_scope`: Browses a design scope.
- `add_signals`: Adds signals to the waveform.
- `set_cursor`: Moves the waveform cursor.
- `set_time_window`: Sets the visible time window.
- `jump_before_error`: Jumps to a time before the error.
- `find_transitions`: Finds signal transitions.
- `get_value_changes`: Lists value changes.
- `sample_signals`: Samples signal values.
- `count_changes`: Counts changes over a window.
- `sample_on_clock`: Samples signals on a clock.
- `read_log`: Reads the simulation log.
- `measure_clock`: Measures a clock.
- `trace_driver`: Traces a signal's driver.
- `read_source`: Reads RTL source.
- `read_source_file`: Reads a source file.
- `goto_source`: Opens the source location.

## FAQ

### What do I need to use it?

A licensed Synopsys Verdi installation, Python 3.11 or newer on the client and Python 3.6 or newer with Tcl 8.6 on the remote host.

### Can it change my RTL?

No. It does not automatically compile, edit or repair RTL.

### How mature is it?

The README calls it experimental, version 0.3.3.

### Does it work over SSH?

Yes. It works locally or over SSH.

### Is Verdi Bridge free?

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

### How do I add Verdi Bridge to Claude Code?

Run this command in your terminal: claude mcp add verdi-bridge -- uvx verdi-bridge

### What are the best alternatives to Verdi Bridge?

The closest alternatives to Verdi Bridge are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/verdi-bridge
