Test Reporter Server

MCP (Model Context Protocol) server for Test Ledger that enables Claude Code to analyze flaky tests, find failure patterns, suggest fixes and more.

Installation

No installation required! Just add the configuration to Claude Code.

Quick Start

1. Get your API key

Log into testledger.dev and go to Settings → API Keys to generate a key.

2. Configure Claude Code

Add this to your Claude Code MCP config:

Location: ~/.claude.json (global) or .mcp.json (project)

{
  "mcpServers": {
    "test-reporter": {
      "command": "npx",
      "args": ["-y", "@testledger/mcp@latest"],
      "env": {
        "TEST_LEDGER_API_KEY": "your-api-key-here"
      }
    }
  }
}

Tip: Using @latest ensures you always get the newest version with bug fixes.

3. Restart Claude Code

That's it! Claude Code now has access to your test results.

Usage

Once configured, you can ask Claude Code things like:

• "Why is checkout.spec.js flaky?"
• "What tests have been failing the most this week?"
• "Show me recent test failures"
• "Are there any tests that always fail together?"

With the /fix-flaky-test command

For the best experience, add the fix-flaky-test slash command to your project:

mkdir -p .claude/commands
curl -o .claude/commands/fix-flaky-test.md https://raw.githubusercontent.com/your-company/test-reporter-mcp/main/commands/fix-flaky-test.md

Then use it:

/fix-flaky-test

Test: LoginPage.should allow user to login with valid credentials
Error: element ("#submit-btn") still not clickable after 3000ms
  at login.spec.js:42:24

Available Tools

The MCP server provides these tools to Claude:

Tool	Description
get_test_history	Pass/fail/flaky statistics for a test
get_failure_patterns	Time-of-day, browser, and version patterns
get_correlated_failures	Tests that fail together (shared setup issues)
get_flaky_tests	Project-wide flaky test leaderboard
get_recent_failures	Recent failures for quick triage
get_test_trend	Failure rate over time

Configuration Options

Environment Variable	Required	Description
TEST_LEDGER_API_KEY	Yes	Your API key from the dashboard
TEST_LEDGER_API_URL	No	Custom API URL (default: https://app-api.testledger.dev)
TEST_LEDGER_PROJECT_ID	No	Default project ID to use for queries

Example with all options

{
  "mcpServers": {
    "test-reporter": {
      "command": "npx",
      "args": ["-y", "@testledger/mcp"],
      "env": {
        "TEST_LEDGER_API_KEY": "tr_live_abc123",
        "TEST_LEDGER_PROJECT_ID": "42"
      }
    }
  }
}

Troubleshooting

"Tool not found" errors

1. Restart Claude Code after updating config
2. Check for JSON syntax errors in your config file
3. Verify your API key is valid

"API error 401"

Your API key is invalid or expired. Generate a new one from the dashboard.

"API error 403"

Your API key doesn't have access to the requested project. Check project permissions.

Support

• Documentation: testledger.dev
• Issues: GitHub Issues