B

Blacksmith

@grahamnotgrant

About Blacksmith

Connect Claude to your Blacksmith CI data. Query workflow runs, analyze test failures, detect flaky tests, compare test regressions between branches, and monitor usage—all through natural conversation. Features 21 tools including test analytics, cache stats, and log search. Zero-

#ci-cd #github-actions #testing #analytics #devops #blacksmith

Basic information

Category

Developer Tools

Transports

stdio

Publisher

grahamnotgrant

Submitted by

Graham Huber

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "blacksmith": {
      "command": "npx",
      "args": [
        "blacksmith-mcp"
      ],
      "env": {
        "BLACKSMITH_ORG": "<YOUR_ORG_NAME>"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Blacksmith?

Blacksmith is an MCP server that connects Claude to GitHub Actions CI/CD analytics and monitoring. It enables developers to debug CI failures, detect flaky tests, and monitor workflow runs directly through natural language queries.

How to use Blacksmith?

Install via Claude: claude mcp add blacksmith -- npx blacksmith-mcp, then set the environment variable BLACKSMITH_ORG=your-org-name. After setup, you can ask Claude questions such as "Why did the last CI run fail?" or "Which tests are flaky this week?"

Key features of Blacksmith

Flaky test detection and trend analysis
Test failure comparison between branches
Error pattern grouping by message
Slow test finder with duration thresholds
Workflow run listing and filtering by status, branch, actor, or PR
Job detail inspection including steps and timing
Log search across all jobs
Core usage and billing monitoring
Cache statistics per repository
Zero-config authentication via Chrome cookies

Use cases of Blacksmith

Determine why the latest CI run failed and which tests are affected
Identify flaky tests that intermittently fail over time
Compare test failure rates between branches to catch regressions
Monitor workflow performance and detect slow jobs or steps
Track billing and resource usage for GitHub Actions

FAQ from Blacksmith

What do I need to run Blacksmith?

You need a Blacksmith organization name, set as the BLACKSMITH_ORG environment variable. The server is run via npx blacksmith-mcp.

How does authentication work?

Blacksmith automatically extracts your session from Chrome cookies, eliminating the need to copy tokens manually.

What can I ask Claude to do with Blacksmith?

You can ask about CI pipeline status, flaky tests, test comparisons between branches, detailed job logs, and usage/cache statistics.

Does Blacksmith require any additional setup beyond the environment variable?

No other setup is mentioned. The zero-config auth uses existing Chrome cookies, so no token generation is needed.

Comments

More Developer Tools MCP servers

MCP Framework

The Typescript MCP Framework

sentry-mcp

An MCP server for interacting with Sentry via LLMs.

OpenSumi

A framework helps you quickly build AI Native IDE products. MCP Client, supports Model Context Protocol (MCP) tools via MCP server.

Serena

A powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent

FastAPI-MCP

Expose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!