MCPVault

get_components

MCP tool from MCP Zuul by imatza-rh

System components — schedulers, executors, mergers, web servers with state and version.

How to use it

get_components is exposed by the MCP Zuul MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the get_components tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.

Install MCP Zuul

$claude mcp add zuul -e ZUUL_URL=https://your-zuul.example.com -- uvx mcp-zuul
FULL MCP ZUUL LISTING

Other tools in MCP Zuul (39)

browse_build_logs

List log directory contents or fetch specific files (inventory, artifacts, must-gather). Max 512KB per file. Accepts url or uuid.

check_health

Test API connectivity, auth status, and config. Triggers re-auth automatically if the Kerberos session expired.

diagnose_build

One-call failure diagnosis. Combines structured failures from job-output.json with targeted log context (fatal/FAILED lines with surrounding context from job-output.txt). Use instead of calling getbuildfailures + getbuildlog separately. Accepts url or uuid.

enqueue

Enqueue a change or ref into a pipeline. Supports both change-based (check/gate) and ref-based (periodic) enqueue.

find_flaky_jobs

Analyze recent build history for intermittent failures. Computes pass/fail rate and flags jobs as flaky (>20% failure with mixed results).

get_autohold

Full details of a specific autohold request — held nodes, timing, project/job.

get_badge

CI status badge URL (SVG) for a project — embeddable in READMEs with Markdown snippet.

get_build

Full build details — nodeset, log URL, artifacts, error detail. Accepts url or uuid.

get_build_failures

Start here for failures. Structured task-level data from job-output.json — failed play, task, host, msg, rc, stderr/stdout. Accepts url or uuid.

get_build_log

Read and search log files. Modes: summary (tail + error lines), full (paginated), grep (regex + context), startline/endline (exact range). Supports logname for any file. Accepts url or uuid.

get_build_times

Build duration trends with avg/min/max stats. Detect performance regressions or timeout-prone jobs.

get_buildset

Full buildset with all builds and events. Accepts url or uuid.

get_change_status

Status for a change/PR/MR. In pipeline: live jobs with elapsed times. Not in pipeline: auto-fetches latest completed buildset. Accepts url or change.

get_config_errors

Check this when jobs aren't running. Configuration errors, missing refs, broken configs. Filterable by project.

get_connections

Configured source connections — Gerrit, GitHub, GitLab instances with driver and hostname.

get_freeze_job

Resolved job config after inheritance. Final merged nodeset, playbooks, variables, and timeout for a specific job. Answers "what will this job actually do?"

get_freeze_jobs

Resolved job dependency graph for a pipeline/project/branch. Shows exactly which jobs will run with inheritance resolved.

get_job

Job configuration — parent, nodeset, timeout, variants, source project.

get_job_durations

Batch avg/min/max duration for multiple jobs in one call. Designed for monitoring an entire pipeline chain without N separate calls.

get_project

Which pipelines and jobs are configured for a project.

get_status

Live pipeline status — what's queued, running, with job progress and ETA. Filterable by pipeline and project.

get_tenant_info

Tenant capabilities — auth realms, job history support, websocket URL.

list_autoholds

Active autohold requests — nodes held after failure for debugging.

list_builds

Search builds by project, pipeline, job, change, result. Includes buildsetuuid for cross-referencing.

list_buildsets

Search buildsets. Use includebuilds=true to inline full build details (saves round-trips).

list_images

Nodepool disk images with build status and provider upload state.

list_jobs

List jobs with optional name filter.

list_labels

Available nodepool labels — what node types jobs can request.

list_nodes

Nodepool nodes with state (ready, in-use, building), provider, and label. Includes state summary.

list_pipelines

All pipelines with their trigger types.

list_projects

List all projects in a tenant with optional name filter.

list_providers

Nodepool cloud providers with flavors (VM sizes), images, and labels.

list_semaphores

Resource locks with current holders and max capacity. Check when jobs wait unexpectedly.

list_system_events

System events — config updates, reconfigurations, pipeline changes. Useful for "why did my job stop running?"

list_tenants

All tenants with project counts.

promote

Promote changes to the top of a pipeline queue. Use for urgent fixes when gate has a long queue.

reenqueue_buildset

Re-enqueue a buildset — reads project/pipeline/ref from a previous buildset and enqueues it again.

stream_build_console

Live console from RUNNING builds. Connects to Zuul WebSocket, returns last N lines (tail). For completed builds, use tailbuildlog. Optional — requires pip install mcp-zuul[console].

tail_build_log

Fastest failure check. Last N lines of a log (default 50, max 500). More token-efficient than getbuildlog summary mode. Accepts url or uuid.