Open-source, license-free MCP server for RTL waveform debug (FST + SystemVerilog static analysis), an Indago/Verisium Debug MCP alternative.
Wave-mcp demonstrates solid domain-specific tool design for RTL waveform analysis. All 25 tools have descriptions (avg ~120 chars) and input schemas with typed parameters. Naming follows verb_noun convention (list_*, get_*, signal_*, etc.). However, output schemas are not documented in the source, parameter descriptions lack constraint details (ranges, enums, formats), and error handling guidance is absent. No tool annotations (readOnlyHint/destructiveHint) despite clear risk classifications. Descriptions are functional but generic, they state WHAT but rarely WHEN or WHY to call each tool. Parameter relationships (e.g., session_id optional across all tools) are undocumented. This is a competent domain tool that would benefit from LLM-optimized descriptions and structured error responses.
Analyze signal activity (toggle count, idle time, etc.).
Analyze clock signals and derive timing information.
Close a work session and release its resources.
Convert a VCD waveform file to FST format for faster access.
Analyze finite state machine behavior from signal values.
Find all instances of a given module type.
List child instances of a given scope with optional filtering.
Output schemas not documented. No tool returns a documented response structure. LLMs cannot plan downstream calls or extract required fields without seeing what each tool returns.
Parameter descriptions lack constraint details. No enums, ranges, formats, or validation rules. E.g., 'levels' is integer but no min/max; 'protocol' in transaction_analysis has no enum of valid protocols (axi, apb, ahb, etc.).
No tool annotations despite clear risk classifications. Tools marked WRITE (open_session, close_session, convert_vcd_to_fst, open_viewer) lack destructiveHint. READ_ONLY tools lack readOnlyHint. Agents cannot distinguish safe from risky operations.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 63 | 2025-06-18+ | v2 |
List all module types in the design.
List signals in a given scope.
Get the source code declaration of a module.
Open a new work session with waveform and optional netlist/RTL sources.
Open a session for static RTL analysis without a waveform.
Open an interactive browser-based waveform viewer.
Prepare a session with waveform and design files for analysis.
Get detailed information about a scope (instance).
Get information about the current session, including loaded design, waveform, and netlist metadata.
Get the source code declaration of a signal.
Get all drivers (assignments) of a signal.
Get detailed information about a signal.
Get all readers (uses) of a signal.
Get the value of a signal at a specific time.
Get all value changes for a signal.
Get signal value changes within a time range.
Extract and analyze transactions from waveform data.
Compare two waveforms and report differences.
Error handling guidance absent. No tool description explains what to do if a session_id is invalid, a signal_path does not exist, or a file cannot be read. Agents have no recovery path.
Descriptions are generic and lack WHEN/WHY context. E.g., 'Get information about the current session' does not explain when to call it vs open_session, or what metadata is returned. LLMs cannot distinguish similar tools.