Skip to main content
Glama
jenkins-http-mcp-server

jenkins-http-mcp-server

Jenkins HTTP MCP Server

CI Coverage: 100% Release Python 3.14+ Jenkins 2.579 License: MIT

Jenkins HTTP MCP Server: Jenkins automation for Codex CLI and Gemini CLI

An external Python Model Context Protocol (MCP) server for Jenkins that uses standard Jenkins HTTP APIs. It works with Codex CLI and Gemini CLI, defaults to read-only, and requires neither Jenkins administrator access nor plugin installation.

IMPORTANT

This project does not require Jenkins administrator access or plugin installation and does not depend on the official Jenkins MCP Server Plugin. Its endpoint behavior is source-validated against Jenkins 2.579.

Quick start | Client setup | Tools | Downloads | Safety | Documentation

At a Glance

Property

Value

MCP transport

STDIO

Jenkins connection

HTTP(S) Remote Access API

Authentication

Jenkins username and API token, or anonymous access

Default mode

Read-only

Jenkins admin access

Not required

Jenkins plugin installation

Not required

Source validation

Jenkins core 2.579

Runtime

Python 3.14 or newer; tested with Python 3.14.7

MCP surface

40 tools and one safety resource

Local downloads

Explicitly gated workspace and artifact directories

Related MCP server: Jenkins MCP Server

Quick Start

1. Install

Clone the current release and install it into a Python 3.14 environment:

git clone --branch v2.0.0 --depth 1 \
  https://github.com/mdtahmidhossain/jenkins-http-mcp-server.git
cd jenkins-http-mcp-server

python3.14 -m venv .venv
source .venv/bin/activate
python -m pip install .

Prebuilt wheel and source archives are also attached to the latest GitHub release. This project is not published to PyPI.

2. Configure Jenkins

Set credentials in the shell that starts your MCP client. Do not put a real token in a committed configuration file.

export JENKINS_URL="https://jenkins.example.com/"
export JENKINS_USER="your-user"
export JENKINS_API_TOKEN="your-api-token"

JENKINS_URL is required. Set both credential variables or neither; leaving both unset uses Jenkins anonymous access. Jenkins remains the authority for every permission check.

Client Setup

The client should launch the interpreter from the environment where the package is installed:

python -c 'import sys; print(sys.executable)'

Use that absolute interpreter path with -m jenkins_mcp_server:

To run the STDIO server directly:

python -m jenkins_mcp_server

The installed console command is equivalent:

jenkins-mcp-server

Example Requests

Once the client is connected, agents can handle requests such as:

  • "List the Jenkins jobs I can access and show the latest build result for each."

  • "Inspect build 123 of team/my-job, then summarize its console errors."

  • "Search build 123's console log for OutOfMemoryError."

  • "Show whether team/my-job is queued, running, or finished."

  • "Show the remote workspace tree for team/my-job before I choose what to download."

  • "Download the current stable workspace and console log for my-job."

  • "Download reports/result.json from build 123's archived artifacts."

  • "Trigger my-job with BRANCH=main." This requires the write gate and explicit user intent.

Agents should inspect jobs, queue state, recent builds, and logs before proposing or performing a write.

How It Works

Codex CLI / Gemini CLI
          |
          | MCP over STDIO
          v
Jenkins HTTP MCP Server
          |
          +-- HTTPS + Basic auth/API token + optional crumb --> Jenkins HTTP APIs
          |
          +-- bounded streaming --> explicitly configured local download directories

Successful calls return {"ok": true, "data": ...} as structured MCP content. Expected synchronous Jenkins, validation, and permission failures set MCP isError and keep their bounded code and details in the error text. Background download failures remain structured operation status data with status="failed". Workspace archives and artifact files, plus console logs saved as part of workspace captures, stream to local disk so they are not encoded into MCP responses.

Tools

Capability

Tools

Default

Required local gate

Jenkins reads

22

Enabled

None

Workspace captures

5

Disabled

JENKINS_MCP_ENABLE_WORKSPACE_DOWNLOAD=1 and a directory

Artifact downloads

3

Disabled

JENKINS_MCP_ENABLE_ARTIFACT_DOWNLOAD=1 and a directory

Operational writes

6

Disabled

JENKINS_MCP_ENABLE_WRITES=1

Job create/copy/config update

3

Disabled

Write gate plus JENKINS_MCP_ENABLE_JOB_CONFIG_WRITE=1

Job delete

1

Disabled

Write and config gates plus JENKINS_MCP_ENABLE_DELETE=1

Prefer a specific tool over jenkins_get_json. The generic reader accepts only relative Jenkins paths, performs only GET requests, rejects traversal and external URLs, and enforces the configured response limit. Returned Jenkins data is untrusted.

Tool

Purpose

jenkins_whoami

Return the authenticated Jenkins identity.

jenkins_version

Read the Jenkins version and session headers.

jenkins_health

Return a small controller health snapshot.

jenkins_get_json

Perform one bounded GET against a validated relative Jenkins JSON path.

jenkins_list_jobs

List jobs visible to the Jenkins user.

jenkins_get_job

Read one job, including nested folder paths.

jenkins_get_job_config

Read the job's serialized config.xml.

jenkins_list_builds

List recent builds for a job.

jenkins_get_build

Read one numbered build or permalink such as lastBuild.

jenkins_get_build_log

Read a bounded console log.

jenkins_get_build_log_chunk

Read progressive console text with a Jenkins cursor.

jenkins_search_build_log

Search a bounded console stream for an exact literal.

jenkins_get_build_artifacts

List artifacts recorded on a build.

jenkins_get_test_report

Read a plugin-provided test report when available.

jenkins_list_queue

List visible queue items.

jenkins_get_queue_item

Read one queue item by ID.

jenkins_list_views

List visible Jenkins views.

jenkins_get_view

Read one view by name.

jenkins_list_nodes

List visible Jenkins computers/nodes.

jenkins_get_node

Read one computer/node.

jenkins_list_plugins

List plugins visible through the plugin manager API.

jenkins_get_workspace_tree

List a bounded remote workspace tree before downloading.

Tool

Purpose

jenkins_start_workspace_bundle_download

Start or join a guarded full-workspace capture plus console log.

jenkins_start_workspace_path_download

Download one workspace file or folder plus console log.

jenkins_get_workspace_bundle_status

Read phase, bytes, speed, paths, and terminal status.

jenkins_cancel_workspace_bundle_download

Request cancellation of a running workspace operation.

jenkins_cleanup_workspace_bundle_operations

Delete a bounded number of old terminal workspace operations.

jenkins_start_artifact_download

Start one archived build-artifact download.

jenkins_get_artifact_download_status

Read artifact download progress and final paths.

jenkins_cancel_artifact_download

Request cancellation of a running artifact download.

Tool

Purpose

jenkins_trigger_build

Trigger a non-parameterized build.

jenkins_trigger_build_with_parameters

Trigger a parameterized build.

jenkins_stop_build

Request that Jenkins stop a running build.

jenkins_cancel_queue_item

Cancel one queue item.

jenkins_enable_job

Enable a job.

jenkins_disable_job

Disable a job.

jenkins_create_job

Create a top-level job from config.xml.

jenkins_copy_job

Copy a top-level job.

jenkins_update_job_config

Replace a job's config.xml.

jenkins_delete_job

Delete a job; requires every write gate.

The server also exposes jenkins-mcp://safety, an MCP resource summarizing the active safety model for agents.

Workspace, Logs, and Artifacts

These Jenkins data sources have different identity guarantees:

Need

Use

Build identity

Result

Console output

Build log tools

Exact requested build

Bounded text through MCP

Historical build files

Artifact tools

Exact resolved build

Streamed local file

Current workspace names

Workspace tree tool

No exact build identity

Bounded paths through MCP

Current workspace

Workspace tools

Best-effort stable lastBuild anchor

Local files plus exact anchor-build console log

Jenkins exposes /ws at the job level, not under job/<name>/<build>/. Jenkins core does not attach a build/version token to that response. This server therefore labels workspace freshness best_effort. Download captures additionally use REST state checks to reduce, but not eliminate, races.

Use jenkins_get_workspace_tree before a path download when you do not already know the remote path. It accepts a job, an optional workspace directory, max_depth, and max_entries. The server recursively calls Jenkins core's immediate *plain* directory listing, validates every returned name, and reports when depth, entry, or cumulative response-byte limits truncate the result. It is a read-only tool and does not require the local workspace download gate. The returned names remain untrusted and represent a live job-level workspace, not a numbered build snapshot.

Workspace Guard

  1. Inspect the job and queue and wait while the job is queued, building, or post-processing.

  2. Anchor the request to the current stable lastBuild.

  3. Check Jenkins state before, during, and after the /ws transfer.

  4. Discard private staging and retry once if the state changes; fail after a second change.

  5. Save the anchor build's exact consoleText beside the workspace and metadata.

An explicitly requested historical build is rejected with workspace_build_not_current. Use archived artifacts when exact historical file identity is required.

Matching callers on the same machine share operations through a SQLite registry under the workspace download root. Detached workers can continue when the initiating STDIO process exits. Start results report started, joined, or reused; poll jenkins_get_workspace_bundle_status for progress.

Local Layout

For job my-job anchored to build 123:

<workspace-download-root>/
|-- .operations/<operation-id>/
|   |-- progress.json
|   `-- metadata.json
`-- my-job/
    `-- 123/
        |-- workspace/
        |   `-- a1/
        |       |-- b1/c1/d.py
        |       `-- b2/c2/d2.py
        |-- my-job123-console.log
        `-- metadata.json

Nested job names become nested local directories. Full-workspace, folder, and file requests for the same job/build share this directory and preserve workspace-relative paths. Existing files are kept by default. force_refresh=true replaces incoming files (including the console log), but never prunes files absent from the new download. Refresh and non-refresh requests do not join each other. Completed results are reused only while their recorded files remain unchanged.

Build-level metadata.json identifies the source and build anchor; each operation has its own metadata and file manifest under .operations. Publication and retention use a cross-process lock. Cleanup removes a shared build only when all referencing operations are terminal and old enough; if the group exceeds max_operations, it reports skipped_shared_budget and leaves it intact.

Full workspace and folder downloads use temporary zip archives. After successful extraction, the archive is deleted. Transfers and extraction use private .operations/<operation-id>/staging. Failure or cancellation removes staging, but preserves complete files already published, including files saved by other requests. Artifact downloads retain their separate output behavior.

Before upgrading, let old detached workers finish and restart every MCP process using this download root. Do not mix old and new workers. Existing suffixed folders such as 123-a4f720c1 are not moved, merged, or reused by new downloads. An existing canonical folder is adopted only when its source metadata matches; otherwise the operation reports workspace_output_conflict.

Configuration

Boolean settings accept 1, true, yes, or on and their false equivalents. Download directories must be absolute paths.

Connection and Response Limits

Variable

Required

Default

Purpose

JENKINS_URL

Yes

None

Absolute Jenkins HTTP(S) base URL without credentials, query, or fragment.

JENKINS_USER

No

Anonymous

Jenkins username; set together with the API token.

JENKINS_API_TOKEN

No

Anonymous

Jenkins API token; set together with the username.

JENKINS_VERIFY_SSL

No

true

Verify Jenkins TLS certificates.

JENKINS_TIMEOUT_SECONDS

No

30

HTTP request timeout.

JENKINS_MCP_MAX_RESPONSE_BYTES

No

2000000

Maximum normal HTTP response size.

JENKINS_MCP_MAX_LOG_BYTES

No

200000

Maximum console bytes returned by one log call.

JENKINS_MCP_MAX_LOG_SCAN_BYTES

No

1200000000

Maximum console bytes scanned by log search.

Workspace Downloads

Variable

Default

Purpose

JENKINS_MCP_ENABLE_WORKSPACE_DOWNLOAD

false

Enable workspace operations.

JENKINS_MCP_WORKSPACE_DOWNLOAD_DIR

None

Absolute workspace output root; required when enabled.

JENKINS_MCP_MAX_WORKSPACE_ARCHIVE_BYTES

6000000000

Maximum downloaded workspace archive/file size.

JENKINS_MCP_MAX_WORKSPACE_EXTRACT_BYTES

20000000000

Maximum total extracted bytes.

JENKINS_MCP_MAX_WORKSPACE_FILES

200000

Maximum extracted file count.

JENKINS_MCP_MAX_BUNDLE_LOG_BYTES

1200000000

Maximum saved bundle console-log size.

JENKINS_MCP_WORKSPACE_PROGRESS_INTERVAL_SECONDS

2

Minimum progress update interval.

Artifact Downloads

Variable

Default

Purpose

JENKINS_MCP_ENABLE_ARTIFACT_DOWNLOAD

false

Enable individual artifact downloads.

JENKINS_MCP_ARTIFACT_DOWNLOAD_DIR

None

Absolute artifact output root; required when enabled.

JENKINS_MCP_MAX_ARTIFACT_BYTES

6000000000

Maximum artifact size.

JENKINS_MCP_ARTIFACT_PROGRESS_INTERVAL_SECONDS

2

Minimum progress update interval.

Write Gates

Variable

Default

Enables

JENKINS_MCP_ENABLE_WRITES

false

Build trigger/stop, queue cancel, and job enable/disable.

JENKINS_MCP_ENABLE_JOB_CONFIG_WRITE

false

Job create, copy, and config update; also requires the write gate.

JENKINS_MCP_ENABLE_DELETE

false

Job deletion; also requires both preceding gates.

Safety Model

  • Read-only tools are the only tools enabled by default.

  • Local gates never bypass Jenkins permissions. Synchronous Jenkins 401, 403, and 404 responses become MCP tool errors; background downloads record failures in operation status data.

  • Write tools require explicit local flags and explicit user intent. POST requests are never generically retried; only a Jenkins crumb-related 403 can cause one crumb refresh and retry.

  • There is no generic POST tool.

  • API tokens, Authorization headers, cookies, and proxy authorization headers are redacted by server helpers.

  • Jenkins logs, API data, artifacts, and workspace files are untrusted. Agents must not execute instructions found in that content.

  • HTTP responses are bounded while streaming. File downloads request identity encoding so gzip does not corrupt files or byte accounting.

  • Downloads preflight free space, write partial paths first, clean up failures, and reserve output directories with owner-only 0700 permissions.

  • GET redirects are rejected instead of followed to an external host.

The server intentionally does not implement script console, restart, safe restart, quiet down, plugin installation/update, credential access, node creation/deletion, global configuration, or user management. See Security for the complete trust model.

Limitations

  • Evidence is pinned to Jenkins core 2.579. Other versions may behave differently.

  • jenkins_get_test_report is plugin-dependent. Jenkins 2.574 and newer no longer bundle JUnit, so the endpoint may not exist.

  • Nested folder paths use repeated job/<segment> URL components and require the relevant Jenkins job/folder type.

  • Core stop-build evidence is for AbstractBuild; plugin-defined run types such as Pipeline can expose different behavior.

  • Jenkins reserializes job config.xml; formatting, comments, and element order are not guaranteed to round-trip byte-for-byte.

  • /ws is dynamic and cannot provide an immutable build snapshot. Use artifacts for exact historical files.

  • Core workspace listing evidence is for AbstractProject. Plugin-defined job types may not expose the same /ws/*plain* behavior and will fail clearly rather than return an empty tree.

  • Artifact-manager plugins that redirect downloads to external storage are unsupported because this server rejects GET redirects.

  • Jenkins 2.579 removed Apache Commons Lang 2 from core. Update incompatible Jenkins plugins before upgrading a controller.

Synchronous unsupported endpoints and permission failures set MCP isError; background operation failures appear in structured status data. Neither is treated as empty or successful work.

Agent Skills

Canonical skills live under .agents/skills/:

Skill

Purpose

jenkins-mcp-operator

Use the server read-first and require explicit intent before writes.

jenkins-mcp-maintainer

Preserve endpoint evidence, tests, and safety gates when changing code.

jenkins-source-researcher

Research the pinned Jenkins source and distinguish core from plugins.

Gemini-compatible links are under .gemini/skills/. See the Gemini setup guide for trust and discovery details.

Development and Testing

The repository's pinned development environment is Python 3.14.7 with pyenv virtualenv venv3147:

pyenv install -s 3.14.7
pyenv virtualenvs --bare | grep -qx venv3147 || pyenv virtualenv 3.14.7 venv3147
pyenv local venv3147
python -m pip install -e '.[dev]'

Run the normal verification suite without a live Jenkins controller:

python -m pytest
python -m compileall src
ruff check

Tests enforce 100% production source-line coverage. tests/test_mcp_stdio_e2e.py launches the real server subprocess, connects with the official MCP client over STDIO, calls all 40 tools, reads the safety resource, and verifies HTTP behavior against a deterministic local Jenkins fixture.

Optional live integration tests run only when explicitly enabled:

export JENKINS_INTEGRATION_TESTS=1
export JENKINS_URL="https://jenkins.example.com/"
export JENKINS_USER="your-user"
export JENKINS_API_TOKEN="your-api-token"
python -m pytest tests/test_integration.py

Documentation

Document

Contents

Codex setup

Verified Codex CLI STDIO configuration and environment forwarding.

Gemini setup

Verified Gemini CLI configuration and Agent Skills discovery.

Security

Credentials, gates, untrusted data, downloads, and network behavior.

Architecture decision

Why this project is an external HTTP API server.

Tool evidence

Endpoint and permission evidence for every implemented tool.

Source truth

Jenkins tag, commit, version evidence, and inspected files.

Source skills check

Search for existing skills in the pinned Jenkins source.

Existing research

Official documentation and third-party projects evaluated.

Releasing

GitHub-only release process; no PyPI publishing.

Release and License

Releases are published on GitHub with wheel and source archives. Nothing is published to PyPI.

Licensed under the MIT License. Report security issues using the repository's security policy.

Available Tools

40 tools
jenkins_cancel_artifact_downloadA
Destructive

Request cancellation of a running artifact download.

Inputs: operation_id (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_cancel_queue_itemA
Destructive

Cancel a Jenkins queue item. Requires JENKINS_MCP_ENABLE_WRITES=1.

Inputs: item_id (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_cancel_workspace_bundle_downloadB
Destructive

Request cancellation of a running workspace bundle operation.

Inputs: operation_id (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_cleanup_workspace_bundle_operationsA
Destructive

Delete bounded, terminal local workspace operations older than the requested age.

Inputs: max_operations, older_than_days. Returns: Structured content returned by successful Jenkins tools.

jenkins_copy_jobB

Copy a top-level job. Requires write and job-config flags.

Inputs: from_job (required), new_name (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_create_jobA

Create a top-level job from config.xml. Requires write and job-config flags.

Inputs: name (required), config_xml (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_delete_jobA
Destructive

Delete a job. Requires write, job-config, and delete flags.

Inputs: job (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_disable_jobB
Destructive

Disable a job. Requires JENKINS_MCP_ENABLE_WRITES=1.

Inputs: job (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_enable_jobA
Destructive

Enable a job. Requires JENKINS_MCP_ENABLE_WRITES=1.

Inputs: job (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_get_artifact_download_statusC
Destructive

Get artifact download bytes, speed, paths, and final status.

Inputs: operation_id (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_get_buildA
Read-only

Get a build by number or Jenkins permalink such as lastBuild.

Inputs: job (required), build (required), tree. Returns: Structured content returned by successful Jenkins tools.

jenkins_get_build_artifactsB
Read-only

List artifacts exported on a build JSON API response.

Inputs: job (required), build (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_get_build_logA
Read-only

Get consoleText for a build, truncated by JENKINS_MCP_MAX_LOG_BYTES.

Inputs: job (required), build (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_get_build_log_chunkA
Read-only

Read one progressive log response and return Jenkins' next safe cursor.

Inputs: job (required), build (required), start. Returns: Structured content returned by successful Jenkins tools.

jenkins_get_jobA
Read-only

Get one job by Jenkins job path. Nested paths use slash-separated names or a list.

Inputs: job (required), tree. Returns: Structured content returned by successful Jenkins tools.

jenkins_get_job_configA
Read-only

Read serialized job config.xml; secrets may be redacted without Configure permission.

Inputs: job (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_get_jsonB
Read-only

GET a relative Jenkins JSON API path. Rejects external URLs and traversal.

Inputs: path (required), query. Returns: Structured content returned by successful Jenkins tools.

jenkins_get_nodeA
Read-only

Get one Jenkins computer/node by name. Use (built-in) for the built-in node.

Inputs: node (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_get_queue_itemA
Read-only

Get one Jenkins queue item by ID.

Inputs: item_id (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_get_test_reportA
Read-only

Get /testReport/api/json when a test-report plugin such as JUnit provides it.

Inputs: job (required), build (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_get_viewA
Read-only

Get one Jenkins view by name.

Inputs: view (required), tree. Returns: Structured content returned by successful Jenkins tools.

jenkins_get_workspace_bundle_statusB
Destructive

Get download/extract/log progress, bytes, speed, paths, and final status.

Inputs: operation_id (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_get_workspace_treeA
Read-only

List a bounded live workspace tree. Paths are not bound to a build number.

Inputs: job (required), max_depth, max_entries, workspace_path. Returns: Structured content returned by successful Jenkins tools.

jenkins_healthA
Read-only

Return a small health snapshot from top-level Jenkins JSON and version headers.

Inputs: no named parameters. Returns: Structured content returned by successful Jenkins tools.

jenkins_list_buildsA
Read-only

List recent builds for a job.

Inputs: job (required), tree. Returns: Structured content returned by successful Jenkins tools.

jenkins_list_jobsB
Read-only

List jobs visible to the Jenkins user.

Inputs: tree, depth. Returns: Structured content returned by successful Jenkins tools.

jenkins_list_nodesA
Read-only

List Jenkins computers/nodes visible to the user.

Inputs: tree. Returns: Structured content returned by successful Jenkins tools.

jenkins_list_pluginsB
Read-only

List installed Jenkins plugins visible through pluginManager/api/json.

Inputs: tree. Returns: Structured content returned by successful Jenkins tools.

jenkins_list_queueB
Read-only

List visible Jenkins queue items.

Inputs: tree. Returns: Structured content returned by successful Jenkins tools.

jenkins_list_viewsB
Read-only

List Jenkins views visible to the user.

Inputs: tree. Returns: Structured content returned by successful Jenkins tools.

jenkins_search_build_logA
Read-only

Stream and search bounded consoleText for an exact, case-sensitive literal.

Inputs: job (required), build (required), pattern (required), max_matches, +1 more. Returns: Structured content returned by successful Jenkins tools.

jenkins_start_artifact_downloadB

Start a gated async download of one archived build artifact to local disk.

Inputs: job (required), artifact_path (required), build. Returns: Structured content returned by successful Jenkins tools.

jenkins_start_workspace_bundle_downloadC
Destructive

Start or join a guarded workspace capture plus exact build console log.

Inputs: job (required), build, force_refresh. Returns: Structured content returned by successful Jenkins tools.

jenkins_start_workspace_path_downloadC
Destructive

Start or join a guarded workspace file/folder capture plus exact console log.

Inputs: job (required), kind (required), workspace_path (required), build, +1 more. Returns: Structured content returned by successful Jenkins tools.

jenkins_stop_buildB
Destructive

Stop a running build. Requires JENKINS_MCP_ENABLE_WRITES=1.

Inputs: job (required), build (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_trigger_buildA
Destructive

Trigger a non-parameterized job build. Requires JENKINS_MCP_ENABLE_WRITES=1.

Inputs: job (required), delay. Returns: Structured content returned by successful Jenkins tools.

jenkins_trigger_build_with_parametersA
Destructive

Trigger a parameterized job build. Requires JENKINS_MCP_ENABLE_WRITES=1.

Inputs: job (required), parameters (required), delay. Returns: Structured content returned by successful Jenkins tools.

jenkins_update_job_configA
Destructive

Replace job config.xml; Jenkins reserializes it. Requires job-config write gates.

Inputs: job (required), config_xml (required). Returns: Structured content returned by successful Jenkins tools.

jenkins_versionA
Read-only

Return Jenkins version from the X-Jenkins response header.

Inputs: no named parameters. Returns: Structured content returned by successful Jenkins tools.

jenkins_whoamiA
Read-only

Return the authenticated Jenkins identity from /whoAmI/api/json.

Inputs: no named parameters. Returns: Structured content returned by successful Jenkins tools.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 40 tools

    Disambiguation4/5

    Most tools map cleanly to a distinct resource and action, such as list_jobs, get_build, trigger_build, delete_job. A few boundary cases—generic get_json versus named getters, the three build-log retrieval tools, and the workspace/artifact download variants—could cause mnisselection but are resolvable from descriptions.

    Naming Consistency4/5

    All tools share the jenkins_ prefix and use snake_case, with a mostly consistent verb_noun pattern: list_jobs, get_job, trigger_build, delete_job, cancel_queue_item. Minor deviations such as jenkins_version, jenkins_health, and jenkins_whoami being noun-only or nonstandard keep it from a perfect 5.

    Tool Count2/5

    40 tools is well above the 25+ threshold for a bloated tool surface. While Jenkins is a large domain, many of these could be consolidated—particularly the multiple download/status/cancel/cleanup bundles—making the set feel heavier than necessary for an MCP server.

    Completeness4/5

    The set covers core Jenkins workflows well: job create/read/update/delete/enable/disable, build trigger/stop/log/artifacts/test reports, queue management, and workspace/artifact retrieval. Minor gaps exist—node and view management are read-only, and there is no credential or plugin administration—but the generic get_json tool helps fill some edge cases.

    Maintenance

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Jenkins to manage jobs, trigger builds with parameters, and monitor build queues. It provides comprehensive access to build histories, console logs, and organizational folder structures via the Jenkins REST API.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Jenkins instances to manage jobs, builds, and nodes through the Model Context Protocol. It provides capabilities to trigger builds, read console outputs, and search log sections using regular expressions.
      ISC