Skip to main content
Ask AI

Tools reference

All tools are exposed to MCP clients with the tr_ prefix. Enable the matching capability or the tool will not be registered.

For the full, machine-maintained table (every tool and description), see the @testrelic/mcp README on GitHub.

core

ToolPurpose
tr_list_reposList repositories you can access.
tr_recent_runsRecent test runs with filters.
tr_describe_repoRepo metadata and integration summary.
tr_get_configResolved MCP configuration (capabilities, paths).
tr_healthConnectivity and cache health—good first call.
tr_integration_statusLive check for a specific integration type.

coverage

ToolPurpose
tr_user_journeysTop user journeys (usage-backed).
tr_coverage_gapsRanked gaps between journeys and tests.
tr_coverage_reportProgress toward coverage targets.
tr_test_mapMap tests to journeys and code nodes.
tr_fetch_cachedRetrieve a large payload by cache_key.

creation

ToolPurpose
tr_plan_testMarkdown plan from a journey or goal.
tr_generate_testRunnable test code from a plan.
tr_dry_run_testTypecheck / list tests on generated output.
tr_generate_assertionStable assertion snippet for a step.
tr_list_templatesAvailable framework templates.

healing

ToolPurpose
tr_heal_runProposed patch for a failing run.
tr_suggest_locatorPrefer stable locators over brittle selectors.
tr_replay_failureArtefacts and steps to reproduce offline.

impact

ToolPurpose
tr_analyze_diffBlast radius and tests touched by a diff.
tr_risk_scoreLightweight risk signal from journey usage.
tr_select_testsMUST / SHOULD / OPTIONAL buckets for testing.

triage

ToolPurpose
tr_diagnose_runCompact failure summary for a run.
tr_compare_runsDiff two runs for regressions or fixes.
tr_flaky_auditRank flaky tests over a window.
tr_search_failuresText search across failures.
tr_ai_rcaRoot-cause narrative when available.
tr_suggest_fixPlatform suggestion for a failing test.
tr_create_jiraCreate or dedupe a Jira issue.
tr_dismiss_flakyMark known-flaky with a reason.

signals

ToolPurpose
tr_user_impactCorrelate a run with user- and log-based impact.
tr_production_signalQuery production logs (LogQL) in a window.
tr_affected_sessionsSessions cohort for comms or rollback.

devtools

ToolPurpose
tr_project_trendsPass rate, duration, flakiness trends.
tr_active_alertsActive platform alerts.
tr_index_repoIndex a local checkout for semantic search.
tr_search_codeVector search over indexed code.
tr_cache_statsCache layer counters for debugging.

Security

Disclosure and versioning policy for the upstream project: SECURITY.md.

Loading chart…