MCP Server — gaffer-sh/mcp

MCP server for Gaffer test history - give your AI assistant memory of your tests

Local serverstdio

What is the MCP Server?

MCP server for Gaffer test history - give your AI assistant memory of your tests

What it actually does

This MCP server connects AI coding assistants like Claude Code and Cursor to your Gaffer test history and coverage data. It allows AI to:

Configuration

  1. A Gaffer account with test results uploaded 2. An API Key from Account Settings > API Keys

Recorded tools

  • list_projects — List all projects you have access to
  • get_project_health — Get health metrics (pass rate, flaky count, trends)
  • list_test_runs — List recent test runs with optional filtering
  • get_test_run_details — Get parsed test results for a specific test run
  • get_report — Get report file URLs for a test run
  • get_report_browser_url — Get a browser-navigable URL for viewing reports
  • get_test_history — Get pass/fail history for a specific test
  • get_flaky_tests — Get tests with high flip rates (pass↔fail)
  • get_slowest_tests — Get slowest tests by P95 duration
  • compare_test_metrics — Compare test performance between commits
  • get_failure_clusters — Group failed tests by root cause (error similarity)
  • get_upload_status — Check if CI results are uploaded and processed
  • get_coverage_summary — Get overall coverage metrics and trends
  • get_coverage_for_file — Get coverage for specific files or paths

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_projectsList all projects you have access to
get_project_healthGet health metrics (pass rate, flaky count, trends)
list_test_runsList recent test runs with optional filtering
get_test_run_detailsGet parsed test results for a specific test run
get_reportGet report file URLs for a test run
get_report_browser_urlGet a browser-navigable URL for viewing reports
get_test_historyGet pass/fail history for a specific test
get_flaky_testsGet tests with high flip rates (pass↔fail)
get_slowest_testsGet slowest tests by P95 duration
compare_test_metricsCompare test performance between commits
get_failure_clustersGroup failed tests by root cause (error similarity)
get_upload_statusCheck if CI results are uploaded and processed
get_coverage_summaryGet overall coverage metrics and trends
get_coverage_for_fileGet coverage for specific files or paths

How to install the MCP Server

{
  "mcpServers": {
    "gaffer": {
      "command": "npx",
      "args": [
        "-y",
        "@gaffer-sh/mcp"
      ],
      "env": {
        "GAFFER_API_KEY": "YOUR_GAFFER_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  1. A Gaffer account with test results uploaded 2. An API Key from Account Settings > API Keys
VariableDescriptionRequired
GAFFER_API_KEYDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use MCP to list projects.”
  • “Use MCP to get project health.”
  • “Use MCP to list test runs.”

Frequently asked questions

MCP server for Gaffer test history - give your AI assistant memory of your tests Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.