MCP Tools Reference

This reference documents all tools available through the Validatar MCP Server. Tools are organized into read-only operations (browsing and querying) and write operations (creating, updating, and executing).

Read-Only Tools

These tools retrieve information from your Validatar instance without making changes.

describe

Retrieve detailed information about a Validatar object.

Use when: You want to inspect the configuration, status, or metadata of a specific object in your catalog or project.

describe_quick_test

Get the details of a specific quick test available for a table or column.

Use when: You want to understand what a specific quick test does before creating it, including its variables and configuration options.

list

List child objects of a parent Validatar object.

Use when: You want to browse the hierarchy — for example, listing schemas in a data source, tables in a schema, columns in a table, tests in a folder, or projects on the home page.

list_quick_tests

List available quick tests for a table or column.

Use when: You want to see what out-of-the-box tests are available for a specific table or column, optionally filtered by quality dimension or existing test coverage.

list_custom_metadata_options

List custom metadata fields and their options for a Validatar object.

Use when: You want to see what custom metadata fields are available for an object and what values they currently hold.

convert_url_to_key

Convert a Validatar application URL to an object type and ID.

Use when: You have a URL from the Validatar UI and need to determine the object type and ID for use with other MCP tools.

get_global_trust_score_settings

Retrieve the global trust score configuration.

Use when: You need to understand how trust scores are calculated, what quality dimensions are configured, or what severity levels and impact ratings are available.

search_documentation_articles

Search across all articles in the Validatar documentation.

Use when: You want to find relevant documentation articles by keyword or topic.

search_documentation_assistive

Ask the Validatar documentation assistant a question.

Use when: You have a question about how Validatar works and want a synthesized answer drawn from the documentation.

Write Tools

These tools create, modify, or execute operations in your Validatar instance. All write operations are tracked as AI Actions and can be reverted.

create_standard_test

Create a new standard test in a project.

Use when: You want to create a one-off test that validates a specific data condition with explicitly defined source and target queries.

create_template_test

Create a new template test in a project.

Use when: You want to create a reusable test definition that automatically generates child tests based on metadata selection criteria.

create_quick_test

Create a quick test for a table or column from an available template.

Use when: You want to quickly add test coverage to a table or column using one of the predefined quick test templates.

create_data_source

Create a new data source.

Use when: You want to register a new database connection in Validatar for testing and profiling.

update_data_source

Update an existing data source configuration.

Use when: You need to modify connection details, settings, or other properties of an existing data source.

execute_standard_tests

Execute one or more standard tests.

Use when: You want to run specific tests and see their results. Only standard tests (including child tests materialized from templates) can be executed directly.

execute_data_source_script

Execute a SQL or Python script against a data source.

Use when: You want to run ad-hoc queries to explore data, validate assumptions, or troubleshoot test results.

update_custom_metadata

Update custom metadata field values for a Validatar object.

Use when: You want to tag or classify objects with custom metadata — for example, assigning data domains, owners, or sensitivity levels.

create_folder

Create a new folder in a project.

Use when: You want to organize tests into a folder structure within a project.

rename_folder

Rename an existing folder.

Use when: You want to update a folder's display name.

move_folder

Move a folder to a different parent.

Use when: You want to reorganize the folder hierarchy within a project.

delete_folder

Delete a folder from a project.

Use when: You want to remove an unused folder. Set delete_child_tests to true to remove contained tests, or false to move them to the parent folder.

create_project

Create a new project.

Use when: You want to set up a new project for organizing and executing tests.

update_project

Update an existing project's configuration.

Use when: You need to modify project settings or properties.

revert_action

Revert a change made by a previously executed AI Action.

Use when: An AI-initiated change needs to be undone — for example, a test was created incorrectly or a metadata update needs to be rolled back.

Object Types

The following object types are used across tools that accept an object_type parameter:

Custom Field Value Format

Several tools accept or return custom field values. The format is consistent:

{
  "field_name": {
    "values": ["value1", "value2"]
  },
  "another_field": {
    "values": ["single_value"]
  }
}

Each field accepts a list of values — even single-value fields use an array.

Related

• Connecting to the Validatar MCP Server — setup and authentication
• Using the Validatar AI Chat Interface — the in-app AI chat experience