The mcp-jenkins server enables AI language models to securely interact with Jenkins CI/CD systems through the Model Context Protocol (MCP), providing comprehensive automation and monitoring capabilities.
Core Capabilities:
Job Management: Get all jobs, search by patterns (class, name, fullname, URL, color), retrieve job info/config, trigger builds with parameters, and manage multibranch pipeline jobs including branch listing and scan triggering
Build Operations: Monitor running builds, retrieve build details/logs/source code, get test results with status filtering (PASSED, SKIPPED, FAILED, FIXED, REGRESSION), and stop running builds
Queue Management: View all queue items, get specific queue item details, and cancel queued jobs
Node/Agent Management: Get all Jenkins nodes and retrieve node configurations
Security & Configuration:
Optional read-only mode to prevent write operations
Flexible authentication via username/password or API token (command line or HTTP headers)
Configurable SSL certificate verification
Regex-based tool filtering to restrict available operations
Deployment & Integration:
Multiple transport methods: stdio, SSE, and streamable-http
Pre-configured for JetBrains GitHub Copilot and VSCode Copilot Chat
Docker support for easy deployment
Provides tools for interacting with Jenkins CI/CD systems, including retrieving job information, searching jobs, accessing build data, viewing job configurations, and triggering builds with parameters.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-jenkinsshow me the status of the production deployment pipeline"
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
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:
Related MCP server: Upstash MCP Server
Line Arguments
When using command line arguments, you can specify the Jenkins server details as follows:
Argument | Description | Required |
| The URL of the Jenkins server. (Http app can set it via headers | No |
| The username for Jenkins authentication. (Http app can set it via headers | No |
| The password or API token for Jenkins authentication. (Http app can set it via headers | No |
| Timeout for Jenkins API requests in seconds. Default is | No |
| Whether to verify SSL certificates when connecting to Jenkins. Default is to verify. | No |
| Whether to use a singleton Jenkins client for all requests in the same session. Default is True. | No |
| Whether to enable read-only mode. Default is False | No |
| A regex pattern to filter available tools. Default is to allow all tools. | No |
| Transport method to use for communication. Options are | No |
| Host address for | No |
| Port number for | No |
Configuration and Usage
Jetbrains Github Copilot
Open Jetbrains Settings
Navigate to Github Copilot > MCP > Configure
Add the following configuration:
VSCode Copilot Chat
Create
.vscodefolder withmcp.jsonfile in you workspace for local setup or editsettings.jsontrough settings menu.Insert the following configuration:
SSE mode
Streamable-Http mode
Run the Jenkins MCP server with the following command:
Available Tools
Tool | Description |
| Get a specific item by name. |
| Get the configuration of a specific item. |
| Get all items in Jenkins. |
| Query items based on pattern. |
| Build a item. |
| Get all nodes in Jenkins. |
| Get a specific node by name. |
| Get the configuration of a specific node. |
| Get all queue items in Jenkins. |
| Get a specific queue item by ID. |
| Cancel a specific queue item by ID. |
| Get a specific build by job name and build number. |
| Get scripts associated with a specific build. |
| Get the console output of a specific build. |
| Get the test report of a specific build. |
| Get all currently running builds in Jenkins. |
| Stop a specific build by job name and build number. |
Contributing
License
Licensed under MIT - see LICENSE file. This is not an official Jenkins product.