All tools are exposed to MCP clients with the tr_ prefix. Enable the matching capability or the tool will not be registered.
The tr_* names are the current v2 namespace. The older testrelic_* names are kept as deprecated aliases for backward compatibility — prefer the tr_* form in new prompts and configs.
For the full, machine-maintained table (every tool and description), see the @testrelic/mcp README on GitHub.
core
| Tool | Purpose |
|---|
tr_list_repos | List repositories you can access. |
tr_recent_runs | Recent test runs with filters. |
tr_describe_repo | Repo metadata and integration summary. |
tr_get_config | Resolved MCP configuration (capabilities, paths). |
tr_health | Connectivity and cache health—good first call. |
tr_integration_status | Live check for a specific integration type. |
coverage
| Tool | Purpose |
|---|
tr_user_journeys | Top user journeys (usage-backed). |
tr_coverage_gaps | Ranked gaps between journeys and tests. |
tr_coverage_report | Progress toward coverage targets. |
tr_test_map | Map tests to journeys and code nodes. |
tr_fetch_cached | Retrieve a large payload by cache_key. |
creation
| Tool | Purpose |
|---|
tr_plan_test | Markdown plan from a journey or goal. |
tr_generate_test | Runnable test code from a plan. |
tr_dry_run_test | Typecheck / list tests on generated output. |
tr_generate_assertion | Stable assertion snippet for a step. |
tr_list_templates | Available framework templates. |
healing
| Tool | Purpose |
|---|
tr_heal_run | Proposed patch for a failing run. |
tr_suggest_locator | Prefer stable locators over brittle selectors. |
tr_replay_failure | Artefacts and steps to reproduce offline. |
impact
| Tool | Purpose |
|---|
tr_analyze_diff | Blast radius and tests touched by a diff. |
tr_risk_score | Lightweight risk signal from journey usage. |
tr_select_tests | MUST / SHOULD / OPTIONAL buckets for testing. |
triage
| Tool | Purpose |
|---|
tr_diagnose_run | Compact failure summary for a run. |
tr_compare_runs | Diff two runs for regressions or fixes. |
tr_flaky_audit | Rank flaky tests over a window. |
tr_search_failures | Text search across failures. |
tr_ai_rca | Root-cause narrative when available. |
tr_suggest_fix | Platform suggestion for a failing test. |
tr_create_jira | Create or dedupe a Jira issue. |
tr_dismiss_flaky | Mark known-flaky with a reason. |
signals
| Tool | Purpose |
|---|
tr_user_impact | Correlate a run with user- and log-based impact. |
tr_production_signal | Query production logs (LogQL) in a window. |
tr_affected_sessions | Sessions cohort for comms or rollback. |
| Tool | Purpose |
|---|
tr_project_trends | Pass rate, duration, flakiness trends. |
tr_active_alerts | Active platform alerts. |
tr_index_repo | Index a local checkout for semantic search. |
tr_search_code | Vector search over indexed code. |
tr_cache_stats | Cache layer counters for debugging. |
Enable with --caps ai. Exposes the Ask-AI tool catalog, a single-turn agent, conversation management, and artifact generators.
| Tool | Purpose |
|---|
tr_ai_catalog | Browse the Ask-AI tool catalog. |
tr_ai_ask | Run a single-turn Ask-AI agent request. |
tr_ai_conversations | List and manage Ask-AI conversations. |
tr_ai_generate_artifact | Generate dashboards, reports, test plans, presentations, or navigation paths. |
marketplace
Enable with --caps marketplace. First-class testing integrations (Jira, GitHub Actions, BrowserStack, LambdaTest, Sentry, Amplitude, Grafana Loki).
| Tool | Purpose |
|---|
tr_marketplace_catalog | List available testing integrations. |
tr_marketplace_connect | Validate / connect or start an OAuth flow for an integration. |
tr_marketplace_disconnect | Disconnect a connected integration. |
tr_marketplace_invoke | Unified invoke against a connected integration. |
apps
Enable with --caps apps. Generic action runner for connected apps (Slack, Notion, Linear, HubSpot, Google Calendar, …).
| Tool | Purpose |
|---|
tr_apps_list | List connected apps. |
tr_apps_actions | List the actions available for an app. |
tr_apps_connect | Connect or disconnect an app via OAuth. |
tr_apps_execute | Universal execute of an action on a connected app. |
artifacts
Enable with --caps artifacts. Manage artifacts produced by the Ask-AI agent.
| Tool | Purpose |
|---|
tr_artifacts_list | List artifacts produced by the Ask-AI agent. |
tr_artifacts_get | Fetch a single artifact. |
tr_artifacts_export | Export an artifact (PNG, PDF). |
tr_artifacts_save | Save an artifact to a file. |
sessions
Enable with --caps sessions. Cloud test session workspaces (BrowserStack / LambdaTest).
| Tool | Purpose |
|---|
tr_sessions_search | Search cloud test sessions. |
tr_sessions_video | Retrieve session video. |
tr_sessions_screenshots | Retrieve session screenshots. |
tr_sessions_logs | Retrieve session logs. |
tr_sessions_workspace | Render a multi-pane session workspace. |
Security
Disclosure and versioning policy for the upstream project: SECURITY.md.