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

  • page (number, optional) - Page number to request. Pages start at 1

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

  • page (number, optional) - Page number to request. Pages start at 1

dvt_get_symbol_references

Retrieves all usages of a symbol across the project.

Parameters:

  • symbol_name (string) - Exact symbol name

  • page (number, optional) - Page number to request. Pages start at 1

dvt_get_identifier_references

Retrieves 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

  • page (number, optional) - Page number to request. Pages start at 1

dvt_get_symbol_dependencies

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

Parameters:

  • symbol_name (string) - Exact symbol name

  • page (number, optional) - Page number to request. Pages start at 1

dvt_get_compiled_files

Retrieves all compiled files in the project.

Parameters:

  • filter (string, optional) - Glob pattern to include only compiled files whose paths match it

  • page (number, optional) - Page number to request. Pages start at 1

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

  • page (number, optional) - Page number to request. Pages start at 1

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

  • page (number, optional) - Page number to request. Pages start at 1

dvt_get_file_identifiers

Lists all identifiers in a file, grouped by line.

Parameters:

  • file_name_or_path (string) - File name or path

  • page (number, optional) - Page number to request. Pages start at 1

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

  • page (number, optional) - Page number to request. Pages start at 1

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.