TestRx MCP Server

A Model Context Protocol (MCP) server that connects TestRx to AI agents like Claude and Cursor. Interact with your test cases and test runs through natural language.

What Can You Do With It?

Once configured, ask your AI agent things like:

• "What's the latest test result for PROJ-42?"
• "Record a passing test run for APP-99 — scenario 'User login', executed by CI"
• "Show me the test case for JIRA-7"
• "Generate a BDD test case for PROJ-55 and save it to TestRx"
• "Analyze the test history for FEAT-10 — is it flaky?"

Available Tools

| Tool | What it does | |------|-------------| | health | Verify your API key and connection | | get_latest_run | Get the most recent test run for a Jira issue | | record_run | Record a new test run result (Pass/Fail/Skip) | | get_test_case | Fetch the stored BDD/checklist test case for an issue | | upsert_test_case | Create or update a test case in TestRx | | analyze_test_history | Analyze pass/fail patterns and suggest fixes | | generate_test_case | AI-generate a BDD Gherkin test case (optionally save it) |

Quick Start

1. Get Your TestRx API Key

1. Log in to TestRx
2. Go to Settings → API Keys
3. Click Generate New Key
4. Copy the key — it is shown only once

2. Configure Claude Desktop

Open (or create) ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows.

Option A — via npx (recommended, no install needed):

{
  "mcpServers": {
    "TestRx": {
      "command": "npx",
      "args": ["-y", "testrx-mcp"],
      "env": {
        "TESTRX_API_KEY": "trx_your_api_key_here"
      }
    }
  }
}

Option B — global install:

npm install -g testrx-mcp

{
  "mcpServers": {
    "TestRx": {
      "command": "testrx-mcp",
      "env": {
        "TESTRX_API_KEY": "trx_your_api_key_here"
      }
    }
  }
}

3. Configure Cursor

Edit ~/.cursor/mcp.json (or .cursor/mcp.json in your project root):

{
  "mcpServers": {
    "TestRx": {
      "command": "npx",
      "args": ["-y", "testrx-mcp"],
      "env": {
        "TESTRX_API_KEY": "trx_your_api_key_here"
      }
    }
  }
}

4. Restart and Verify

Restart your AI client, then ask: "Check TestRx health". You should see a success message.

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | TESTRX_API_KEY | ✅ Yes | — | Your TestRx API key | | TESTRX_BASE_URL | No | https://api.testrxapp.com | Override the API endpoint |

Self-Hosted / Local Development

If running the TestRx API locally:

{
  "env": {
    "TESTRX_API_KEY": "trx_your_key",
    "TESTRX_BASE_URL": "http://localhost:3000"
  }
}

Tool Reference

health

Verify your API key is valid and the server is reachable.

"Check if my TestRx connection is working"

get_latest_run

Get the most recent test result for a Jira issue.

"What's the latest run for PROJ-123?"
"Did APP-42 pass or fail last time?"

Parameters:

• issueKey (required) — Jira issue key, e.g. "PROJ-123"

record_run

Record a new test execution result.

"Record a failing run for PROJ-123 — scenario 'Checkout flow', run by CI, project MyApp"

Parameters:

• issueKey (required) — Jira issue key
• scenario (required) — Test scenario name
• executedBy (required) — Who/what ran the test (user, CI system, etc.)
• result (required) — "Pass", "Fail", or "Skip"
• projectName (required) — Project name in TestRx
• steps (optional) — Array of { step, status, notes? }

get_test_case

Fetch the test case text stored in TestRx for an issue.

"Show me the test case for APP-7"
"What's the BDD scenario for FEAT-99?"

Parameters:

• issueKey (required) — Jira issue key

upsert_test_case

Create or update a test case in TestRx.

"Save this BDD scenario to TestRx for PROJ-5: Feature: Login..."

Parameters:

• issueKey (required) — Jira issue key
• testCaseText (required) — Full test case text (BDD or checklist)
• projectName (optional) — Project name
• projectKey (optional) — Jira project key (e.g. "PROJ")
• jiraDescription (optional) — Jira issue description

analyze_test_history

Analyze the test history for an issue and get AI-friendly debugging guidance.

"Analyze PROJ-123 — why is it failing?"
"Is APP-42 flaky? What are the patterns?"

Parameters:

• issueKey (required) — Jira issue key

generate_test_case

Generate a BDD Gherkin test case for an issue, optionally saving it.

"Generate a test case for PROJ-55"
"Write BDD scenarios for APP-10 and save them to TestRx"
"Generate tests for FEAT-3, context: users can reset their password via email"

Parameters:

• issueKey (required) — Jira issue key
• context (optional) — Additional context (acceptance criteria, user story, etc.)
• save (optional, default false) — Auto-save the generated case to TestRx
• projectName (optional) — Used when saving

Requirements

• Node.js 18+
• TestRx account with API access
• An MCP-compatible AI client (Claude Desktop, Cursor, etc.)

License

MIT