Skip to content

Supported Tools

The TestGen MCP server exposes the prompts, tools, and resources listed below.

For setup instructions, see Set up the MCP Server. For example questions to ask an assistant, see MCP Server.

Prompts

Prompts are pre-built workflows you can invoke directly through your AI client — typically as a slash command (for example, /testgen:table_health in Claude Code) or from a quick-action menu. They orchestrate several tool calls behind the scenes for common investigations. Exact UX varies by client.

  • compare_runs — Compare the most recent test run against the previous run.
  • health_check — Run a data quality health check across all projects and test suites.
  • hygiene_triage — Guided hygiene issue triage workflow.
  • investigate_failures — Investigate test failures to identify root causes and patterns.
  • profiling_overview — Explore the profiling results for a table group.
  • table_health — Assess the data quality health of a specific table across all test suites.

Tools

Tools are operations the assistant calls during a conversation, picked based on what you ask.

Discover what TestGen knows about

  • get_data_inventory — Get a structural inventory of the TestGen configuration.
  • get_project — Get a project's configuration and configuration counts.
  • get_test_suite — Get a test suite's configuration and test-definition breakdown.
  • get_test_type — Get detailed information about a specific test type.
  • list_projects — List all projects the authenticated user has access to.
  • list_tables — List tables in a table group.
  • list_test_suites — List all test suites for a project with their latest run statistics.

Investigate quality issues

  • bulk_update_test_results — Set the disposition on every matching test result in a suite.
  • bulk_update_tests — Enable or disable tests in a suite in bulk.
  • compare_test_runs — Compare two test runs and report what changed between them.
  • create_test — Create a test in a test suite.
  • create_test_note — Attach a note to a test definition.
  • delete_test_note — Delete a test note.
  • export_tests — Export test definitions from a test suite as a portable JSON document.
  • get_failure_summary — Summarize test failures grouped by test type, table, or column.
  • get_failure_trend — Time-series of test result counts by time bucket.
  • get_source_data — Look up rows that match or violate a test or hygiene issue's criteria.
  • get_source_data_query — Get the SQL query that would look up source data, without executing it.
  • get_table_sample — Fetch sample rows from a source table for inspection.
  • get_test — Get full details of a test definition.
  • get_test_run — Get a single test run with status, timing, result counts, and testing score.
  • import_tests — Apply an export document from export_tests to a test suite.
  • list_test_notes — List notes attached to a test definition, newest first.
  • list_test_result_history — Get the historical results of one test definition across runs.
  • list_test_results — List individual test results for a test run, with optional filters.
  • list_test_runs — List test runs across a project, including queued and in-progress runs.
  • list_test_types — List available test types with optional filtering.
  • list_tests — List test definitions in a test suite.
  • search_test_results — Search test results across multiple runs with flexible filters.
  • update_test — Update fields on an existing test.
  • update_test_note — Replace the body of a test note.
  • update_test_result — Set the disposition on a single test result (confirm, dismiss, mute, or clear).
  • validate_custom_test — Dry-run a custom test SQL query against the test suite's parent connection.

Browse profiling results

  • compare_profiling_runs — Compare two profiling runs on the same table group.
  • generate_create_table_script — Generate a CREATE TABLE script for a profiled table.
  • get_column_frequent_values — Get the top frequent values for one column from its profile run.
  • get_column_patterns — Get the top character patterns for one string column from its profile run.
  • get_column_profile_detail — Get the value distribution and statistics for one column.
  • get_hygiene_issue — Get full details of a specific hygiene issue.
  • get_profiling_run — Get a single profiling run with status, timing, and totals.
  • get_profiling_trends — Show a time series of caller-named profiling metrics.
  • get_schema_history — Show a per-run timeline of structural changes across recent profiling runs.
  • get_table — Get an overview of a table with profiling highlights.
  • list_column_profiles — List per-column profile headers across a table group.
  • list_hygiene_issues — List hygiene issues for a profiling run.
  • list_profiling_runs — List profiling run history for a table group.
  • list_profiling_summaries — List aggregated profiling health summaries for a table group or project.
  • search_columns — Search columns by name across one or many projects.
  • search_hygiene_issues — Search hygiene issues across profiling runs and table groups.
  • update_hygiene_issue — Update the disposition of a hygiene issue (confirm, dismiss, or mute).

Trigger profiling, tests, and test generation

  • cancel_profiling_run — Request cancellation of a profiling run that has not finished.
  • cancel_test_run — Request cancellation of a queued or running test run.
  • create_profiling_schedule — Create a recurring profiling schedule for a table group.
  • create_test_run_schedule — Create a recurring test-run schedule for a test suite.
  • delete_schedule — Delete a schedule.
  • generate_tests — Submit a test-generation job for a test suite.
  • get_schedule — Get full details for a schedule, including the last five execution attempts.
  • list_schedules — List schedules for a project — profiling and test run schedules.
  • run_profiling — Submit a profiling run for a table group.
  • run_tests — Submit a test run for a test suite.
  • update_schedule — Update a schedule's cron, timezone, or active state.

Track data quality scores

  • create_scorecard — Create a scorecard in a project.
  • delete_scorecard — Delete a scorecard.
  • get_quality_scores — Quality-score rollup with optional grouping and filtering.
  • get_scorecard — Get a scorecard with its current scores and per-category breakdown.
  • list_scorecards — List the scorecards defined in a project.
  • update_scorecard — Update fields on an existing scorecard.

Manage TestGen configuration

  • create_connection — Create a database connection in a project. Enterprise
  • create_notification — Create an email notification for a test-run, profiling-run, or score-drop event.
  • create_project — Create a new project. Enterprise
  • create_table_group — Create a table group on an existing connection.
  • create_test_suite — Create a test suite under a table group.
  • delete_notification — Delete an email notification.
  • get_connection — Get a connection's configuration.
  • get_notification — Get full details of an email notification.
  • get_table_group — Get a table group's full configuration.
  • list_connections — List database connections in a project.
  • list_notifications — List notifications configured across projects, or scoped to a parent entity.
  • list_project_members — List the members of a project and their roles. Enterprise
  • list_table_groups — List table groups in a project or on a specific connection.
  • preview_table_group — Probe the target database for tables matching a table group's filters.
  • set_project_membership — Add a member to a project, change a member's role, or remove a member. Enterprise
  • test_connection — Test connectivity against a stored or inline-supplied connection.
  • update_catalog_metadata — Apply metadata updates to tables and columns within table groups.
  • update_connection — Update fields on an existing connection. Enterprise
  • update_notification — Update fields on an existing email notification.
  • update_project — Update a project's settings.
  • update_table_group — Update fields on an existing table group.
  • update_test_suite — Update fields on a test suite.

Browse monitor health and events

  • create_metric_monitor — Create a new Metric monitor on a table.
  • delete_metric_monitor — Remove a Metric monitor.
  • disable_monitors — Turn off monitoring for a table group.
  • enable_monitors — Turn on monitoring for a table group.
  • get_monitor_settings — Get a table group's monitor configuration and schedule.
  • get_monitor_summary — Get monitor health for a table group.
  • list_monitor_events — List per-table monitor events for one monitor type.
  • list_monitor_schema_changes — List schema changes detected for a table group, newest first.
  • list_monitored_tables — List monitored tables in a table group with per-type anomaly counts.
  • list_monitors — List configured monitors for a table.
  • set_monitor_historical — Switch a monitor to Historical Calculation mode.
  • set_monitor_predictive — Switch a monitor to Prediction Model mode.
  • set_monitor_static — Switch a monitor to Static Thresholds mode with fixed manual bounds.
  • update_metric_monitor — Update the name and / or expression of an existing Metric monitor.
  • update_monitor_settings — Update a table group's monitor configuration and/or schedule.
  • validate_metric_expression — Dry-run a metric expression against the table group's connection without saving.

Resources

Resources are static reference documents that AI clients can fetch by URI.

  • testgen://column-profile-fields — Reference for column-profile fields by general_type, with PII redaction notes.
  • testgen://connection-parameters — Supported database flavors for the connection tools.
  • testgen://generation-sets — Reference of generation sets and the test types each one generates.
  • testgen://glossary — Glossary of TestGen concepts.
  • testgen://hygiene-issue-types — Reference table of all hygiene issue types.
  • testgen://test-types — Reference table of all test types.