Blacksmith MCP server
io.github.grahamnotgrant/blacksmith·v0.1.1·5 starsMCP server for Blacksmith CI - query runs, analyze test failures, detect flaky tests.
5 stars563 downloads/wk
Reviews
Write oneNobody has reviewed Blacksmith yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Blacksmith tools (11)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
compare_test_runsCompare test failures between two runs to identify regressions. Shows new failures, fixed tests, and persistent failures. If base_run_id not provided, compares against most recent prior run.
get_cache_entriesGet detailed cache entries for a repository. Shows cache keys, sizes, scopes (branches), and last hit times. Useful for debugging cache issues.
get_cache_statsGet Blacksmith cache statistics: total size, hit rate, entries by repository. Shows how effectively caching is being used.
get_current_usageGet current core usage snapshot (active cores vs max cores).
get_flaky_testsDetect flaky tests by analyzing pass/fail patterns across recent runs. Returns tests that fail intermittently (e.g., "failed 3 of 10 runs"). Killer feature for CI stability.
get_invoice_amountGet the current billing period invoice amount.
get_slow_testsFind tests exceeding a duration threshold. Shows slowest tests, their percentage of total test time, and average duration stats.
get_test_historyGet the failure history for a specific test across recent runs. Shows when it passed/failed, on which branches, and error messages for failures.
get_trendsTrack metrics over time: duration (are tests getting slower?), failure_rate (are tests getting flakier?), test_count (are we adding tests?). Returns trend analysis with data points.
get_usage_summaryGet usage summary showing billable minutes vs free tier allowance. Shows remaining free minutes and overage.
search_logsSearch logs across all jobs. Filter by query (e.g., "error", "timeout"), log level (INFO/WARN/ERROR/DEBUG), and time range. Great for finding issues across runs.
Public scan report
scanner v0.1.10 · 2026-10-01 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 154 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Blacksmith compares
Against every graded Developer tools MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 33% of 1,119 Developer tools servers
- Tools
- 11
- the typical Developer tools server has 7
- Tools that change things
- 0%
- typical: 5%. Fewer write tools means less an agent can break
- GitHub stars
- 5
- more than 78% of 855 Developer tools servers
- Downloads a week
- 563
- more than 86% of 436 Developer tools servers with a package
What its tools let an agent do: 11 read
Install Blacksmith in Claude Code, Cursor or VS Code
Runs npx -y blacksmith-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add blacksmith -- npx -y blacksmith-mcp
What the publisher says
From the Blacksmith repository's README, as published. We do not edit it. Read it on GitHub
Blacksmith MCP
An MCP server that connects Claude to your Blacksmith CI data. Query workflow runs, analyze test failures, detect flaky tests, and monitor usage—all through natural conversation.
Why?
Debugging CI failures usually means clicking through dashboards, copying run IDs, and piecing together information across multiple pages. With this MCP, you can just ask:
- "Why did the last CI run fail?"
- "Which tests are flaky this week?"
- "Compare test failures between main and my PR"
- "What's using the most cache storage?"
Claude handles the API calls and gives you actionable insights.
Quick Start
Zero-config if you're logged into Blacksmith in Chrome:
# Add to Claude Code
claude mcp add blacksmith -- npx blacksmith-mcp
# Set your org (run once)
export BLACKSMITH_ORG="your-org-name"The MCP automatically extracts your session from Chrome cookies. No manual token copying needed.
Installation
Option 1: Claude Code CLI
claude mcp add blacksmith -- npx blacksmith-mcpOption 2: Project Configuration
Add to your .mcp.json:
{
"mcpServers": {
"blacksmith": {
"type": "stdio",
"command": "npx",
"args": ["blacksmith-mcp"],
"env": {
"BLACKSMITH_ORG": "your-org-name"
}
}
}
}Option 3: Global Install
npm install -g blacksmith-mcpConfiguration
Authentication
Automatic (recommended): Log into app.blacksmith.sh in Chrome. The MCP extracts your session cookie automatically.
Manual: Set BLACKSMITHSESSIONCOOKIE environment variable with your session cookie value.
Environment Variables
Available Tools
Workflow Runs
Test Analytics
Usage & Billing
Organization
Example Conversations
Debug a Failed Run
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Blacksmith: common questions
- Is Blacksmith MCP server safe?
- Mostly: it is graded B (72/100). Read the Blacksmith safety report
- How do I install Blacksmith?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Blacksmith need an API key?
- Yes. The registry entry asks for
BLACKSMITH_SESSION_COOKIE. - Is Blacksmith maintained?
- The last commit was 188 days ago (2026-04-30). The latest release is v0.1.1.
- What can I use instead of Blacksmith?
- Servers from other publishers that do the same job: Notion MCP server, RepoPilot MCP server and OctoCounts MCP Server.
- How does Blacksmith compare with other Developer tools MCP servers?
- safety score 72/100 (higher than 33% of 1,119 Developer tools servers); tools 11 (the typical Developer tools server has 7); tools that change things 0% (typical: 5%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Blacksmith
Same job from other publishers: the closest match first, then the best rated.
- NotionToken-auth Notion MCP: pages, databases, blocks, comments, files. Runs headless in CI and agents.not reviewedEstablishedB
- RepoPilotLocal, deterministic review of Git changes: weakened tests and CI gates, risky flows, blast radius.not reviewedGrowingA
- OctoCounts MCP ServerAnalyze and compare public GitHub repo line counts (SLOC) via OctoCounts, from any MCP client.not reviewedGrowingA
- SuvaduLocal shell history and AI agent sessions over MCP: search commands, failures, risk and git changesnot reviewedGrowingA
MergetrainQueue parallel-agent worktree branches, test together, serialize and recover Git pushes.not reviewedGrowingA