Which integrations are available for this server?

Provides tools for interacting with Jenkins, enabling management and inspection of items/jobs, builds, nodes, queues, views, plugins, artifacts, pipeline inputs, and Groovy script execution.

How do I use MCP Jenkins?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Jenkins trigger the deploy-prod job and show me its build status" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MCP Jenkins

by deborahabdullah

Overview Schema Source Related Servers Discussions Admin

Python

Hybrid

MCP Jenkins

PyPI Version PyPI Downloads test codecov License

The Model Context Protocol (MCP) is an open-source implementation that bridges Jenkins with AI language models following Anthropic's MCP specification. This project enables secure, contextual AI interactions with Jenkins tools while maintaining data privacy and security.

Installation

Choose one of these installation methods:

# Using uv (recommended)
pip install uv
uvx mcp-jenkins

# Using pip
pip install mcp-jenkins
mcp-jenkins

# Docker
docker pull ghcr.io/lanbaoshen/mcp-jenkins:latest
docker run -p 9887:9887 --rm ghcr.io/lanbaoshen/mcp-jenkins:latest --transport streamable-http

Related MCP server: Jenkins MCP Server

Line Arguments

When using command line arguments, you can specify the Jenkins server details as follows:

# Simple streamable-http example
uvx mcp-jenkins --transport streamable-http

Argument	Description	Required
`--env-file`	Path to a `.env` file to load configuration from. See Environment Variables / .env file below.	No
`--jenkins-url`	The URL of the Jenkins server. (Http app can set it via headers `x-jenkins-url`)	No
`--jenkins-username`	The username for Jenkins authentication. (Http app can set it via headers `x-jenkins-username`) Set it together with the password, or leave both unset to access Jenkins anonymously.	No
`--jenkins-password`	The password or API token for Jenkins authentication. (Http app can set it via headers `x-jenkins-password`) Set it together with the username, or leave both unset to access Jenkins anonymously: what the server can then do is decided by the anonymous user's permissions in Jenkins.	No
`--jenkins-timeout`	Timeout for Jenkins API requests in seconds. Default is `5` seconds.	No
`--jenkins-verify-ssl/--no-jenkins-verify-ssl`	Whether to verify SSL certificates when connecting to Jenkins. Default is to verify.	No
`--jenkins-session-singleton/--no-jenkins-session-singleton`	Whether to use a singleton Jenkins client for all requests in the same session. Default is True.	No
`--read-only`	Whether to enable read-only mode. Default is False	No
`--transport`	Transport method to use for communication. Options are `stdio`, `sse` or `streamable-http`. Default is `stdio`.	No
`--host`	Host address for `streamable-http` transport. Default is `0.0.0.0`	No
`--port`	Port number for `streamable-http` transport. Default is `9887`.	No

Environment Variables / .env file

Instead of passing credentials on the command line, you can set them as environment variables, or put them in a .env file:

JENKINS_URL=https://jenkins.example.com
JENKINS_USERNAME=alice
JENKINS_PASSWORD=xxxx
JENKINS_TIMEOUT=5
JENKINS_VERIFY_SSL=true

If a .env file is present in the current directory (or a parent directory), it is loaded automatically — no flag needed:

uvx mcp-jenkins --transport streamable-http

To load a .env file from a specific location, use --env-file:

uvx mcp-jenkins --env-file /path/to/.env --transport streamable-http

Values already set in the real environment take precedence over the .env file, and any --jenkins-* CLI flag takes precedence over both.

Configuration and Usage

Jetbrains Github Copilot

Open Jetbrains Settings
Navigate to Github Copilot > MCP > Configure
Add the following configuration:

{
  "servers": {
    "my-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-jenkins",
        "--jenkins-url=xxx",
        "--jenkins-username=xxx",
        "--jenkins-password=xxx"
      ]
    }
  }
}

VSCode Copilot Chat

Create .vscode folder with mcp.json file in you workspace for local setup or edit settings.json trough settings menu.
Insert the following configuration:

SSE mode

{
    "servers": {
        "jenkins": {
            "url": "http://localhost:9887/sse",
            "type": "sse"
        }
    }
}

Streamable-Http mode

{
    "servers": {
        "mcp-jenkins-mcp": {
            "autoApprove": [],
            "disabled": false,
            "timeout": 60,
            "type": "streamableHttp",
            "url": "http://localhost:9887/mcp"
        }
    }
}

Run the Jenkins MCP server with the following command:

uvx mcp-jenkins \
  --jenkins-url xxx \
  --jenkins-username xxx  \
  --jenkins-password xxx \
  --transport sse

Health Check Endpoint

When running with --transport streamable-http or --transport sse, the server exposes a plain HTTP liveness endpoint:

GET /healthz  ->  200 OK

It always returns 200 and bypasses the x-jenkins-* auth headers, so it is safe to use directly as a Kubernetes liveness/readiness probe without any Jenkins credentials. Example probe:

livenessProbe:
  httpGet:
    path: /healthz
    port: 9887
  initialDelaySeconds: 5
  periodSeconds: 10

Note: this is a liveness check only — it does not verify connectivity to the upstream Jenkins server.

Available Tools

Tool	Description
`get_item`	Get a specific item by name.
`get_item_config`	Get the configuration of a specific item.
`get_item_parameters`	Get the parameters of a specific item.
`get_all_items`	Get all items in Jenkins.
`query_items`	Query items based on pattern.
`build_item`	Build a item.
`get_all_nodes`	Get all nodes in Jenkins.
`get_node`	Get a specific node by name.
`get_node_config`	Get the configuration of a specific node.
`get_all_queue_items`	Get all queue items in Jenkins.
`get_queue_item`	Get a specific queue item by ID.
`cancel_queue_item`	Cancel a specific queue item by ID.
`get_build`	Get a specific build by job name and build number.
`get_build_scripts`	Get scripts associated with a specific build.
`get_build_console_output`	Get the console output of a specific build.
`get_build_parameters`	Get the parameters of a specific build.
`get_build_test_report`	Get the test report of a specific build.
`get_build_test_failures`	Get the failing tests of a specific build.
`get_running_builds`	Get all currently running builds in Jenkins.
`stop_build`	Stop a specific build by job name and build number.
`get_pending_inputs`	Get the pending input steps of a build paused for input.
`submit_input`	Proceed with or abort a pipeline input step of a build.
`get_all_build_artifacts`	List the artifacts of a specific build.
`get_build_artifact`	Download an artifact from a specific build.
`get_build_artifact_url`	Get the direct URL of an artifact from a specific build.
`get_view`	Get a specific view by name.
`get_all_views`	Get the configuration of a specific view.
`get_all_plugins`	Get all installed plugins.
`get_plugin`	Get a specific plugin by short name.
`get_plugins_with_problems`	Get plugins with problems (missing dependencies, version mismatch, etc.).
`get_plugins_with_backup`	Get plugins that can be downgraded.
`get_plugins_with_updates`	Get plugins that have available updates.
`get_plugin_dependency_graph`	Get dependency graph for a plugin in Graphviz format.
`run_groovy_script`	Execute an arbitrary Groovy script on Jenkins.

Note: get_pending_inputs reads the wfapi endpoint served by the pipeline-rest-api plugin (bundled with pipeline-stage-view). submit_input only needs that plugin when input_id is omitted — pass input_id explicitly and it works on any Jenkins with the pipeline-input-step plugin.

Contributing

CONTRIBUTING.md

License

Licensed under MIT - see LICENSE file. This is not an official Jenkins product.

Star History

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained

ResponsivenessResponsive

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Sentry AOAuth
dev.sentry.mcp
Enable secure connectivity between Sentry issues and debugging data, and LLM clients, using a Model Context Protocol (MCP) server.
Monitoring Developer Tools Observability
3
hithereiamaliff-mcp-nextcloudOAuth
ai.smithery
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Cloud Storage File Systems Workplace & Productivity
238
Proofable MCP AOAuth
io.github.proofable
Context and control for any AI. Agent identity, scoped access, and proof across tools.
Security Agent Orchestration Autonomous Agents
1
BuildkiteOAuth
com.buildkite.mcp
The Buildkite MCP server exposes Buildkite product data (pipelines, builds, jobs, and test data) to AI tools, editors, and agents through the Model Context Protocol. It provides capabilities including pipeline creation and management, build monitoring with specialized tools like 'wait_for_build', efficient log querying using Apache Parquet conversion and caching, and OAuth-based authentication for both read-write and read-only access to Buildkite's REST API.
CI/CD & DevOps Monitoring Observability
2

Related MCP Servers

mcp-jenkins
CI/CD & DevOps Developer Tools
lanbaoshen
A
license
B
quality
A
maintenance
The Model Context Protocol (MCP) Jenkins integration is an open-source implementation that bridges Jenkins with AI language models following Anthropic's MCP specification. This project enables secure, contextual AI interactions with Jenkins tools while maintaining data privacy and security.
Updated 4 days ago (2026-10-13 01:26 UTC)
36
154
MIT
Jenkins MCP Server
CI/CD & DevOps Developer Tools
saurprince
A
license
Not graded
quality
C
maintenance
Provides Jenkins CI/CD integration for AI assistants through the Model Context Protocol, enabling job management, build control, and system administration via natural language commands.
Updated 7 months ago (2026-03-18 08:44 UTC)
225 PyPI
1
MIT
mcp-jenkins
CI/CD & DevOps Developer Tools
Julia85311
F
license
Not graded
quality
A
maintenance
Enables AI language models to securely inspect and control Jenkins through natural language, covering jobs, builds and their console output/artifacts, queue items, nodes, views and plugins, plus triggering or stopping builds, submitting pipeline inputs, and running Groovy scripts. Read-only mode and CLI, environment-variable, or HTTP-header based authentication keep credentials and data under the user's control.
Updated 2 days ago (2026-10-14 15:25 UTC)
-
MCP Jenkins
CI/CD & DevOps Developer Tools Testing & QA Tools
PrawitWalker140
F
license
Not graded
quality
A
maintenance
Enables AI language models to securely interact with Jenkins through the Model Context Protocol, exposing tools to query and manage items, nodes, queues, builds, artifacts, views, plugins, and execute Groovy scripts while maintaining data privacy and security.
Updated 11 hours ago (2026-10-16 10:28 UTC)
-