MCP server for Test Ledger - analyze flaky tests with Claude Code
npm install @testledger/mcpMCP (Model Context Protocol) server for Test Ledger that enables Claude Code to analyze flaky tests, find failure patterns, suggest fixes and more.
No installation required! Just add the configuration to Claude Code.
Log into testledger.dev and go to Settings → API Keys to generate a key.
Add this to your Claude Code MCP config:
Location: ~/.claude.json (global) or .mcp.json (project)
``json`
{
"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.
That's it! Claude Code now has access to your test results.
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?"
For the best experience, add the fix-flaky-test slash command to your project:
`bash`
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
`
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 |
| 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 |
`json``
{
"mcpServers": {
"test-reporter": {
"command": "npx",
"args": ["-y", "@testledger/mcp"],
"env": {
"TEST_LEDGER_API_KEY": "tr_live_abc123",
"TEST_LEDGER_PROJECT_ID": "42"
}
}
}
}
1. Restart Claude Code after updating config
2. Check for JSON syntax errors in your config file
3. Verify your API key is valid
Your API key is invalid or expired. Generate a new one from the dashboard.
Your API key doesn't have access to the requested project. Check project permissions.
- Documentation: testledger.dev
- Issues: GitHub Issues