trigger-buildLABSCO SUMMARY
The console log is the tool that matters.
Listing jobs and triggering builds is convenience; pulling a failed build's console output into the same window as the code is the thing that changes how a broken pipeline gets fixed. The two prompts push further in that direction — they exist to make the assistant read logs for causes rather than repeat the status you can already see. Note that triggering and stopping builds are real actions against a real CI server, so the token you hand it should have the reach you actually intend.
What it is
An MCP server for Jenkins that gives an assistant the operations you would otherwise click through the web UI: list jobs, start and stop builds, read build results and console output, and check the queue and the agents. Jobs are also exposed as resources under a jenkins:// scheme, and two prompts steer the assistant through analysing them.
What you get
- Every job listed with its status —
list-jobs - One job in detail, including its recent builds —
get-job-details - A build triggered by job name, with optional job parameters, returning the queue information —
trigger-build - A running build halted by job name and build number —
stop-build - Status, duration and details of a specific build —
get-build-info - The console log of a specific build, which is where a failure is actually explained —
get-build-console - The pending builds sitting in the queue —
get-queue-info - The agents: all of them with status, or one node's configuration in detail —
list-nodes,get-node-info - Two prompts for analysis rather than retrieval:
analyze-job-statusreviews all jobs at a brief or detailed level, andanalyze-build-logsreads one job's build log for errors and warnings and suggests fixes
Requirements
A Jenkins server and credentials on it: JENKINS_URL, JENKINS_USERNAME, and either JENKINS_TOKEN (an API token, recommended) or JENKINS_PASSWORD. Install with pip install jenkins-mcp-server==0.1.6 or uv pip install jenkins-mcp-server==0.1.6, then run jenkins-mcp-server --verbose; uvx jenkins-mcp-server works without a permanent install. The pyproject name is jenkins-mcp-server (0.1.6). Storing the token in your editor's settings keeps it out of a plain-text .env.
Setup effort
One command plus a key — pip install jenkins-mcp-server==0.1.6, then supply credentials
USE CASES
Finding out why the build broke
Get the failing build's info, pull its console output, and have the log read for the error rather than skimming it yourself.
Kicking off a deploy without leaving the editor
Trigger the job by name with its parameters and read back the queue information it returns.
Stopping a run that is going nowhere
Halt the in-progress build by job name and build number, then confirm the state.
Checking whether the problem is the agents
List the nodes and read one agent's status and configuration when builds are queuing rather than running.
9 tools
Listed in project docs. Your client may show a different list.
stop-buildget-job-detailslist-jobsget-build-infoget-build-consoleget-queue-infoget-node-infolist-nodesBEFORE YOU INSTALL
What to know first
Tools you get
9 tools named in the project's documentation.
Requires
- jenkins-mcp-server on PATH
- JENKINS_URL in your environment
- JENKINS_TOKEN in your environment
- JENKINS_USERNAME in your environment
INSTALLATION
Connect your client
Server setup
pip install jenkins-mcp-server==0.1.6MCP Clients
VS Code
{
"servers": {
"jenkins-mcp-server": {
"type": "stdio",
"command": "jenkins-mcp-server",
"args": [
"--verbose"
],
"env": {
"JENKINS_URL": "http://<YOUR_JENKINS_SERVER>:8080",
"JENKINS_USERNAME": "<YOUR_JENKINS_USERNAME>",
"JENKINS_TOKEN": "<YOUR_JENKINS_TOKEN>"
}
}
}
}VS Code — uvx
{
"servers": {
"jenkins-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"jenkins-mcp-server==0.1.6"
],
"env": {
"JENKINS_URL": "http://<YOUR_JENKINS_SERVER>:8080",
"JENKINS_USERNAME": "<YOUR_JENKINS_USERNAME>",
"JENKINS_TOKEN": "<YOUR_JENKINS_TOKEN>"
}
}
}
}Claude Desktop — uvx
{
"mcpServers": {
"jenkins-mcp-server": {
"command": "uvx",
"args": [
"jenkins-mcp-server"
]
}
}
}This is the README's Claude Desktop entry, which sets no Jenkins connection. Add an "env" object beside "args" with JENKINS_URL, JENKINS_USERNAME and JENKINS_TOKEN, as the VS Code configuration does, or the server cannot reach Jenkins. Unpinned, uvx fetches the latest release on PyPI (0.1.6 on 2026-09-15).