Blacksmith MCP Server

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. Its 21 documented tools cover tests, job, runs, logs. It runs locally over stdio via the published package.

People connecting DevOps & monitoring tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-04-30 · ★ 4 · #86 OF 101 MAINTAINED DEVOPS & MONITORING · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Blacksmith

before you install - you'll need

BLACKSMITH_ORG

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add grahamnotgrant-blacksmith-mcp -- npx -y blacksmith-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "grahamnotgrant-blacksmith-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "blacksmith-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package blacksmith-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.grahamnotgrant is GitHub-verified and matches the repo owner

03 · What Blacksmith can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list workflow runs with filters (status, branch, workflow, actor, PR), get run details including all jobs, list jobs for a workflow run, and get job details (steps, timing, runner info).

Capability map

Tools grouped from the project's README - what Blacksmith lets an agent do.

read & search

15 tools - e.g. List workflow runs with filters (status, branch, workflow, actor, PR); Get run details including all jobs; List jobs for a workflow run

list_runs · get_run · list_jobs · get_failed_tests · get_failures_by_pattern · get_flaky_tests…

Job

3 tools - e.g. Get job details (steps, timing, runner info); Get raw log output for a job; Get all test results for a job

get_job · get_job_logs · get_job_tests

Cache

2 tools - e.g. Cache size, entries by repository; Detailed cache entries for a repo

get_cache_stats · get_cache_entries

Compare

1 tool - e.g. Compare failures between two runs (find regressions)

compare_test_runs

04 · Who maintains Blacksmith

blacksmith is maintained by grahamnotgrant. It's the only MCP server we track from this author; the repo dates to Jan 2026.

05 · Facts

repository: github.com/grahamnotgrant/blacksmith-mcp
category: DevOps & monitoring - ranked #86 of 101 actively-maintained DevOps & monitoring servers as of 2026-08-25.
registry: io.github.grahamnotgrant/blacksmith (active, first published 2026-01-20)
packages: npm:blacksmith-mcp

06 · Blacksmith FAQ

Is Blacksmith still maintained?

Yes - as of 2026-08-25, its last commit was 2026-04-30. We re-verify nightly.

What can Blacksmith do?

How do I install Blacksmith?

Run `npx -y blacksmith-mcp`. The README documents one environment variable (BLACKSMITH_ORG) to set first. You can also paste the ready-made client config above.

Does Blacksmith run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Blacksmith

Alternatives to Blacksmith

Maintained DevOps & monitoring servers if Blacksmith isn't the fit.

Pairs well with

Servers that cover what Blacksmith doesn't - only shown when the pairing reason fits the companion.

More DevOps & monitoring MCP servers · Greptimedb MCP Server · Arduino MCP Server (hardware-mcp) · Homebutler · Zuul · Iris Eval MCP Server

More TypeScript MCP servers · Graph Pilot · Astronomy Oracle · Brewers Almanack · Dnd Oracle · Godot Forge · see all