Gaffer
Gives AI coding assistants read access to your test history, flaky tests and coverage
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.10.2
- Listing updated
- today
Similar MCP servers
About Gaffer
Gaffer is a freemium MCP server for developer tools. It can run locally on your machine or as a hosted remote server.
The README and docs describe Gaffer's MCP server as a bridge between an AI coding assistant and a team's test analytics. Once connected, the assistant can pull pass rates, flaky-test lists, per-test history, failure groupings and coverage figures from Gaffer rather than relying on pasted CI logs. The server runs in code mode: it exposes three MCP tools, and the assistant chains calls to 18 analytics functions inside a single JavaScript execution.
Connection is either a hosted endpoint, where Claude Code, claude.ai and Claude Desktop sign in through OAuth and get read-only access to one organization, or a local npm package that reads a user API key or project token from an environment variable. Uploads of test results are only possible with a key or token, and the docs note a rate limit of 300 uploads per hour per project.
The server suits developers and QA teams who already upload results to Gaffer and want to ask an assistant about test health, debugging a failing run, or where coverage is thinnest.
Install
Run in a terminal
claude mcp add --transport http mcp https://app.gaffer.sh/mcpAdd to Settings → Connectors → Add custom connector
https://app.gaffer.sh/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://app.gaffer.sh/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://app.gaffer.sh/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"serverUrl": "https://app.gaffer.sh/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"type": "http",
"url": "https://app.gaffer.sh/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
GAFFER_API_KEYAPI key from Account Settings > API Keys. gaf_ user key or gfr_ project token.RequiredGAFFER_API_URLOverride the Gaffer API base URL. Defaults to https://app.gaffer.sh
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- execute_code
- Runs JavaScript against codemode functions, with a maximum of 20 API calls and a 30 second timeout.
- search_tools
- Finds available analytics functions by keyword.
- list_projects
- Lists projects available to the credential.
What it does
- Test health insights
- Returns a 0-100 health score, pass rate, run count, flaky count and trend for a project.
- Flaky test detection
- Lists tests with high flip rates between pass and fail, with per-test history lookups.
- Failure clustering
- Groups failed tests in a run by error-message similarity to surface shared root causes.
- Coverage analysis
- Reports line, branch and function coverage, lists untested files and flags low-coverage areas with failures.
- Report file access
- Provides report file URLs and signed browser links valid for 30 minutes.
- Read-only hosted sign-in
- Hosted endpoint supports OAuth sign-in with read-only access scoped to one organization.
Good for
- Asking an assistant why a CI run failed and which failures share a cause
- Checking whether a specific test has been flaky over recent runs
- Finding the slowest tests in a CI pipeline
- Locating untested files that also have recent failures
- Confirming whether a fix made a test faster or changed its status between commits
Pricing
Freemium
Free plan with 500 MB storage and 30-day analytics; Pro and Team are paid tiers. The MCP server itself is MIT-licensed.
Prices change. Check gaffer.sh before you buy.
Gaffer FAQ
Does the hosted endpoint need an API key?
No. Claude Code, claude.ai and Claude Desktop can sign in with OAuth. Cursor, CI and the npm package use an API key.
Can an assistant upload results through the sign-in connection?
No. A signed-in connection is read-only and cannot call upload_test_results. A user API key or project token is needed for uploads.
What are the request limits?
Each credential is limited to 1,000 requests per hour on the hosted endpoint. Uploads are limited to 300 per hour per project.
Which analytics window applies?
Requests default to 30 days and accept up to 365, but the server caps the window at the plan's analytics range: 30 days on Free, 90 on Pro and 180 on Team.
Is Gaffer free?
Gaffer has a free plan, with paid plans for more usage or features.
How do I add Gaffer to Claude Code?
Run this command in your terminal: claude mcp add --transport http mcp https://app.gaffer.sh/mcp
What are the best alternatives to Gaffer?
The closest alternatives to Gaffer are Codecov MCP by usefulapi, Testiny Test Management, Northflank MCP by usefulapi, Api Test MCP and simplify3x-connect.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.
