List all Blacksmith organizations accessible to your account. Use this first to see available orgs.

Get the status of the current organization (personal org, onboarding, runner region).

Get all organization settings: email, alerts, timeouts, feature flags (Docker caching, SSH, branch protection, log ingestion), and PR comment config.

Get users who have triggered workflow runs. Useful for filtering runs by actor.

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.

Get details of a specific workflow run by ID. Includes list of 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.

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 workflow run duration distribution as a histogram. Shows how long runs typically take.

Get test results for an entire run (all jobs). Simpler than calling get_job_tests per job. Truncates at 500 tests.

Get details of a specific job including steps, runner info, and timing.

Get the logs for a specific job. Returns raw log output.

Get test results for a job. Optionally filter by status (pass/fail/skip).

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).

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.

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.

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.

Find tests exceeding a duration threshold. Shows slowest tests, their percentage of total test time, and average duration stats.

Get the failure history for a specific test across recent runs. Shows when it passed/failed, on which branches, and error messages for failures.

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 current core usage snapshot (active cores vs max cores).

Get the current billing period invoice amount.

Get usage summary showing billable minutes vs free tier allowance. Shows remaining free minutes and overage.

Get Blacksmith cache statistics: total size, hit rate, entries by repository. Shows how effectively caching is being used.

Get detailed cache entries for a repository. Shows cache keys, sizes, scopes (branches), and last hit times. Useful for debugging cache issues.

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 alerting/monitoring rules configured for the organization. Shows active monitors and their timeline history.

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.

Get available filter values for log search (e.g., job names, log levels). Use before search_logs to discover valid filter values.

Get log volume over time as a histogram. Useful for spotting error spikes or unusual activity patterns.

Get daily job metrics: counts, durations, and failure rates per day. Great for spotting trends. Defaults to last 7 days.

Get aggregate job statistics for a period: total jobs, total duration, average duration, failure rate. The big picture view.

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 runner types used for CI jobs in a period. Shows what machine types are being used.

Get repositories with CI activity in a period. Shows which repos are actively running workflows.

Get branches with CI activity. Optionally filter by repository.

Get job duration distribution with percentile breakdowns (P50/P90/P95/P99/Max). Shows histogram of how long jobs take and identifies outliers.