Zuul MCP Server - install, status & alternatives [2026]

01 · Install Zuul

before you install - you'll need

Set ZUUL_USE_KERBEROS, ZUUL_VERIFY_SSL, ZUUL_AUTH_TOKEN before connecting. ZUUL_URL, ZUUL_DEFAULT_TENANT are optional or environment-specific per the README.

Claude Code

claude mcp add imatza-rh-mcp-zuul -- uvx mcp-zuul

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "imatza-rh-mcp-zuul": {
      "command": "uvx",
      "args": [
        "mcp-zuul"
      ]
    }
  }
}

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 Apache-2.0 - declared in the repository

pypi package mcp-zuul - check the name against the project README before installing (PyPI has no namespace ownership)

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

03 · What Zuul 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 search builds by project, pipeline, job, change, result. Includes buildset_uuid for cross-referencing, list log directory contents or fetch specific files (inventory, artifacts, must-gather). Max 512KB per file. Accepts url or uuid, search buildsets. Use include_builds=true to inline full build details (saves round-trips), and list jobs with optional name filter.

Capability map

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

read & search

24 tools - e.g. Search builds by project, pipeline, job, change, result. Includes buildset_uuid for cross-referencing.; Search buildsets. Use include_builds=true to inline full build details (saves round-trips).; Full…

list_builds · list_buildsets · get_buildset · get_status · get_change_status · list_pipelines…

Build

8 tools - e.g. Full build details - nodeset, log URL, artifacts, error detail. Accepts url or uuid.; Start here for failures. Structured task-level data from job-output.json - failed play, task, host, msg, rc…

get_build · get_build_failures · diagnose_build · get_build_log · tail_build_log · browse_build_logs…

Job

3 tools - e.g. Job configuration - parent, nodeset, timeout, variants, source project.; Resolved job config after inheritance. Final merged nodeset, playbooks, variables, and timeout for a specific job. Answers "what…

get_job · get_freeze_job · get_job_durations

Freeze

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

get_freeze_jobs

Check

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

check_health

Enqueue

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

enqueue

Promote

1 tool - e.g. Promote changes to the top of a pipeline queue. Use for urgent fixes when gate has a long queue.

promote

Reenqueue

1 tool - e.g. Re-enqueue a buildset - reads project/pipeline/ref from a previous buildset and enqueues it again.

reenqueue_buildset

Latest releases

v0.11.0 · 2026-08-16

[FEATURE] Migrate to MCP SDK v2 · Bump actions/checkout from 4 to 7 · Bump actions/deploy-pages from 4 to 5 · Bump actions/upload-pages-artifact from 3 to 5 · Bump actions/setup-python from 5 to 7 · restore CI lint and…

v0.10.0 · 2026-07-31

Added · batch_diagnose tool - classify multiple failed builds in one call, returns a compact triage table (parallel diagnose_build(brief=True) for up to 20 UUIDs) · diagnose_and_test tool - combines diagnose_build and…

v0.9.0 · 2026-07-12

Added · check_health tool - test API connectivity, auth status, and config in one call; triggers Kerberos re-auth automatically via the api() wrapper · Startup Kerberos auth retry with backoff (3 attempts, 5s/10s…

04 · Who maintains Zuul

mcp-zuul is maintained by imatza-rh. It's the only MCP server we track from this author; the repo dates to Mar 2026.

05 · Facts

repository: github.com/imatza-rh/mcp-zuul
category: DevOps & monitoring - ranked #27 of 101 actively-maintained DevOps & monitoring servers as of 2026-08-25.
release cadence: 5 releases in the last 90 days (latest 2026-08-16)
registry: io.github.imatza-rh/mcp-zuul (active, first published 2026-03-21 · 21 versions)
packages: pypi:mcp-zuul

06 · Zuul FAQ

Is Zuul still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-22 and it shipped 5 releases in the last 90 days. We re-verify nightly.

What can Zuul do?

With this server connected, an agent can search builds by project, pipeline, job, change, result. Includes buildset_uuid for cross-referencing, list log directory contents or fetch specific files (inventory, artifacts, must-gather). Max 512KB per file. Accepts url or uuid, search buildsets. Use include_builds=true to inline full build details (saves round-trips), and list jobs with optional name filter.

How do I install Zuul?

Run `uvx mcp-zuul`. The README documents 5 environment variables (ZUUL_URL, ZUUL_DEFAULT_TENANT, ZUUL_USE_KERBEROS…) to set first. Set ZUUL_USE_KERBEROS, ZUUL_VERIFY_SSL, ZUUL_AUTH_TOKEN before connecting. ZUUL_URL, ZUUL_DEFAULT_TENANT are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Zuul run locally?

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

07 · Alternatives to Zuul

Alternatives to Zuul

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

Pairs well with

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

More DevOps & monitoring MCP servers · Iris Eval MCP Server · Marktplaats MCP · Forge Craft · Thoughtbox · Mushi Mushi

More Python MCP servers · Apple Mail MCP (imdinu) · ClaudeR - RStudio MCP Server · Mitre Attack MCP Server · Memograph · InsideDCPulse World Model · see all