Available Tools

The DVT MCP Server offers a collection of specialized tools designed to provide MCP hosts with access to compilation database information.

The following section details each available tool, including its parameters and a brief description.

dvt_get_symbol_definitions

Retrieves the full source code definitions of symbols (e.g., classes, modules, interfaces).

Parameters:

  • symbol_name_query (string) - Symbol name or wildcard pattern

dvt_get_symbol_locations

Finds where symbols are defined in the project (file path and line range).

Parameters:

  • symbol_name_query (string) - Symbol name or wildcard pattern

dvt_get_symbol_references

Finds all usages of a symbol across the project.

Parameters:

  • symbol_name (string) - Exact symbol name

dvt_get_identifier_references

Finds all usages of a specific identifier (e.g., variable, function parameter) across the project.

Parameters:

  • file_name_or_path (string) - File containing the identifier

  • identifier_surrounding_code (string) - Code line with identifier in tags

dvt_get_symbol_dependencies

Retrieves source code definitions of all symbols that a given symbol depends on.

Parameters:

  • symbol_name (string) - Exact symbol name

dvt_get_compiled_files_tree

Shows all compiled files in the project as a hierarchical tree.

Parameters:

None

dvt_get_design_top

Retrieves the top-level design element(s) in the project.

Parameters:

None

dvt_get_design_subinstances

Lists all sub-instances of a specified design element.

Parameters:

  • design_element_path (string) - Hierarchical path to design element

dvt_get_verification_top

Gets the top-level UVM component.

Parameters:

None

dvt_get_verification_subcomponents

Lists all subcomponents of a specified UVM component.

Parameters:

  • verification_component_path (string) - Hierarchical path to UVM component

dvt_get_file_identifiers

Lists all identifiers in a file, grouped by line.

Parameters:

  • file_name_or_path (string) - File name or path

dvt_get_problems

Retrieves compilation problems (errors/warnings) for a given file.

Parameters:

  • file_name_or_path (string) - File name or path

  • include_warnings (boolean) - Include warnings in results

Note

When the -project argument is not provided to dvt_mcp.sh, an additional project_path parameter, containing the absolute path of the project, is required for every tool.

This helps the DVT MCP Server determine the project it needs to retrieve information about.