Blacksmith

MCP server for Blacksmith CI - query runs, analyze test failures, detect flaky tests.

Connector by grahamnotgrant · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 6

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/grahamnotgrant-blacksmith

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

MCP server for Blacksmith CI - query runs, analyze test failures, detect flaky tests.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools: 37 read · 0 write · 0 deleteRead-only
Secrets: 1 (API keys, tokens or passwords)
Install scripts: Not scanned yet
Runs as: Node.js package

Tools by what they do 37

Read from the source code; the running server may list different tools.

Read 37 · Look things up without changing anything.

compare_test_runs
get_active_branches
get_active_repositories
get_actors
get_cache_entries
get_cache_stats
get_core_usage_timeseries
get_current_usage
get_failed_tests
get_failures_by_pattern
get_flaky_tests
get_invoice_amount

Show 25 more tools

get_job
get_job_duration_distribution
get_job_logs
get_job_tests
get_jobs_by_dimension
get_jobs_daily
get_jobs_summary
get_log_filter_options
get_log_histogram
get_monitors
get_org_settings
get_org_status
get_run
get_run_filter_options
get_run_histogram
get_run_tests
get_runner_types
get_slow_tests
get_test_history
get_trends
get_usage_summary
list_jobs
list_orgs
list_runs
search_logs

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

BLACKSMITH_SESSION_COOKIE

Other settings (environment variables or headers).

BLACKSMITH_ORG

Tools (37)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

compare_test_runs
Compare 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_active_branches
Get branches with CI activity. Optionally filter by repository.
get_active_repositories
Get repositories with CI activity in a period. Shows which repos are actively running workflows.
get_actors
Get users who have triggered workflow runs. Useful for filtering runs by actor.
get_cache_entries
Get detailed cache entries for a repository. Shows cache keys, sizes, scopes (branches), and last hit times. Useful for debugging cache issues.
get_cache_stats
Get Blacksmith cache statistics: total size, hit rate, entries by repository. Shows how effectively caching is being used.
get_core_usage_timeseries
Get core usage over time. Shows how many cores are being used at each interval. Defaults to last 24 hours with 15-minute intervals.
get_current_usage
Get current core usage snapshot (active cores vs max cores).
get_failed_tests
Get failed tests for a job with full error details. Use error_lines param to control stack trace length. Returns all failures by default (no limit).
get_failures_by_pattern
Group failed tests by error pattern (e.g., "is not a function", "Cannot read properties"). Shows count, affected suites/files, and sample error for each pattern. Best for quickly identifying root causes.
get_flaky_tests
Detect 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_amount
Get the current billing period invoice amount.
get_job
Get details of a specific job including steps, runner info, and timing.
get_job_duration_distribution
Get job duration distribution with percentile breakdowns (P50/P90/P95/P99/Max). Shows histogram of how long jobs take and identifies outliers.
get_job_logs
Get the logs for a specific job. Returns raw log output.

Show 22 more tools

get_job_tests
Get test results for a job. Optionally filter by status (pass/fail/skip).
get_jobs_by_dimension
Break down job metrics by dimension: repository, workflow, branch, or runner_type. Shows which repos/workflows consume the most CI time. Example: get_jobs_by_dimension(dimension="repository", metric="duration")
get_jobs_daily
Get daily job metrics: counts, durations, and failure rates per day. Great for spotting trends. Defaults to last 7 days.
get_jobs_summary
Get aggregate job statistics for a period: total jobs, total duration, average duration, failure rate. The big picture view.
get_log_filter_options
Get available filter values for log search (e.g., job names, log levels). Use before search_logs to discover valid filter values.
get_log_histogram
Get log volume over time as a histogram. Useful for spotting error spikes or unusual activity patterns.
get_monitors
Get alerting/monitoring rules configured for the organization. Shows active monitors and their timeline history.
get_org_settings
Get all organization settings: email, alerts, timeouts, feature flags (Docker caching, SSH, branch protection, log ingestion), and PR comment config.
get_org_status
Get the status of the current organization (personal org, onboarding, runner region).
get_run
Get details of a specific workflow run by ID. Includes list of jobs.
get_run_filter_options
Get available filter values for workflow runs: statuses, repositories, branches, workflows, and users. Use this to discover valid filter values before calling list_runs.
get_run_histogram
Get workflow run duration distribution as a histogram. Shows how long runs typically take.
get_run_tests
Get test results for an entire run (all jobs). Simpler than calling get_job_tests per job. Truncates at 500 tests.
get_runner_types
Get runner types used for CI jobs in a period. Shows what machine types are being used.
get_slow_tests
Find tests exceeding a duration threshold. Shows slowest tests, their percentage of total test time, and average duration stats.
get_test_history
Get the failure history for a specific test across recent runs. Shows when it passed/failed, on which branches, and error messages for failures.
get_trends
Track 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_summary
Get usage summary showing billable minutes vs free tier allowance. Shows remaining free minutes and overage.
list_jobs
List all jobs for a specific workflow run. Use this to get job IDs for get_job, get_job_logs, and get_job_tests.
list_orgs
List all Blacksmith organizations accessible to your account. Use this first to see available orgs.
list_runs
List workflow runs with filtering. Filter by status (success/failure/cancelled/skipped/in_progress), branch, workflow name, actor, or PR number. Example: list_runs(status="failure") to find failed runs.
search_logs
Search 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.

Signals

Stars: 6
Forks: 4
Open issues: 0
Last commit: Apr 30, 2026 (6 months ago)
Last release: Jan 20, 2026 (9 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name: io.github.grahamnotgrant/blacksmith
Version: 0.1.1
Auth: API key
Packages: npm blacksmith-mcp
License: MIT
Repository: github.com/grahamnotgrant/blacksmith-mcp
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql

Cite this page

Blacksmith MCP server. Agent Mart. https://agentmart.dev/connectors/grahamnotgrant-blacksmith (last updated 2026-10-24)