v1.1.1 — 37 tools

Jenkins MCP Server

Connect your AI assistant to Jenkins. Trigger builds, inspect pipelines, manage jobs — all via natural language.

npm install View on GitHub
npx --yes @kud/mcp-jenkins@latest
37 Tools
2 Auth modes
MIT License
Features

Everything you need for Jenkins CI/CD

Comprehensive Jenkins API coverage, flexible auth, and native MCP protocol support for any AI assistant.

🔒
Flexible Authentication
Bearer tokens, Basic auth (user + API token), or OAuth. Pass credentials via CLI args or environment variables.
🔄
Multi-Instance Support
Connect to multiple Jenkins servers in a single MCP entry. Name instances automatically from hostnames or set them explicitly.
🚫
Tool Filtering
Allowlist or blocklist tools via environment variables. Expose only read-only tools for safer AI assistant access.
⚡
Modern Stack
TypeScript 5.3+, ES2023, native Fetch API. No heavyweight dependencies — just the MCP SDK and Node.js 20+.
📊
Real-time Monitoring
Build status, queue management, pipeline stage breakdown, console logs, and test results — all from your AI chat.
🔨
37 Tools
Jobs, builds, nodes, views, artifacts, plugins, and system info. Covers ~95% of the Jenkins REST API surface.
Quickstart

Up and running in 60 seconds

No installation required. Add the server to your AI assistant with a single command.

Claude Code CLI 

# Via environment variables (recommended)
claude mcp add --transport stdio --scope user jenkins \
  --env MCP_JENKINS_URL=https://your-jenkins.com \
  --env MCP_JENKINS_USER=your_username \
  --env MCP_JENKINS_API_TOKEN=your_token \
  -- npx --yes @kud/mcp-jenkins@latest

# Or via CLI args (override env vars)
claude mcp add --transport stdio --scope user jenkins \
  -- npx --yes @kud/mcp-jenkins@latest \
  --url https://your-jenkins.com \
  --user your_username \
  --api-token your_token

Claude Desktop 

// claude_desktop_config.json — env vars (recommended)
{
  "mcpServers": {
    "jenkins": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-jenkins@latest"],
      "env": {
        "MCP_JENKINS_URL": "https://your-jenkins.com",
        "MCP_JENKINS_USER": "your_username",
        "MCP_JENKINS_API_TOKEN": "your_token"
      }
    }
  }
}

Example conversations 

You:  List all my Jenkins jobs
AI:   Found 12 jobs: api-backend, mobile-pipeline, deploy-staging...

You:  What's the status of the mobile-pipeline build?
AI:   Build #142 — FAILED in 4m 32s. Stage "Run Tests" failed.

You:  Show me the console log for that build
AI:   [2024-01-15 10:23:41] ERROR: 3 tests failed in AuthServiceTest...

You:  Trigger a new build for deploy-staging with VERSION=2.1.0
AI:   Build #67 queued for deploy-staging with VERSION=2.1.0.
Tools

37 tools, 7 categories

From triggering builds to inspecting nodes, every major Jenkins operation is covered.

jenkins_list_jobsList all Jenkins jobs
jenkins_search_jobsSearch jobs by name pattern
jenkins_get_job_statusGet last build status for a job
jenkins_enable_jobEnable a disabled job
jenkins_disable_jobDisable a job
jenkins_delete_jobDelete a job (permanent)
jenkins_get_job_configGet job XML configuration
jenkins_create_jobCreate a new job from XML config
jenkins_update_job_configUpdate an existing job's XML config
jenkins_rename_jobRename a job
jenkins_copy_jobCopy/duplicate a job
jenkins_get_build_statusGet status for a specific build number
jenkins_get_recent_buildsGet last N builds for a job
jenkins_trigger_buildTrigger a new build, optionally with parameters
jenkins_stop_buildStop/abort a running build
jenkins_delete_buildDelete a build record
jenkins_replay_buildReplay a pipeline build with the same script
jenkins_get_console_logGet console output for a build
jenkins_get_build_changesGet Git commits included in a build
jenkins_get_pipeline_stagesGet pipeline stage breakdown with durations
jenkins_get_test_resultsGet test pass/fail counts and suite details
jenkins_list_artifactsList build artifacts with sizes
jenkins_get_artifactDownload an artifact (returned as base64)
jenkins_get_queueView all pending builds in the queue
jenkins_cancel_queueCancel a queued build by item ID
jenkins_list_nodesList all Jenkins agents/nodes
jenkins_get_nodeGet detailed info on a specific node
jenkins_toggle_node_offlineTake a node offline or bring it back online
jenkins_get_system_infoGet Jenkins system information
jenkins_get_versionGet the Jenkins version string
jenkins_get_pluginsList all installed plugins with versions
jenkins_quiet_downEnable quiet mode (no new builds)
jenkins_cancel_quiet_downCancel quiet mode
jenkins_list_viewsList all views with their jobs
jenkins_get_viewGet details for a specific view
jenkins_list_instancesList all configured Jenkins instances with their URLs
jenkins_safe_restartSafely restart Jenkins (waits for running builds)
Configuration

Environment variables

CLI arguments take priority over environment variables. Use MCP_JENKINS_* prefixed vars for env-based config.

Variable Description Example
MCP_JENKINS_URL Jenkins server URL (required) https://jenkins.example.com
MCP_JENKINS_USER Username for Basic auth admin
MCP_JENKINS_API_TOKEN API token for Basic auth 11abc...ef
MCP_JENKINS_BEARER_TOKEN Bearer token (OAuth / token auth) eyJhbGci...
MCP_JENKINS_INSTANCES Comma-separated instance names (multi-instance) ci,prod
MCP_JENKINS_TOOLS Allowlist — only expose these tools jenkins_list_jobs,jenkins_get_job_status
MCP_JENKINS_BLOCK_TOOLS Blocklist — hide these tools from the AI jenkins_delete_job,jenkins_safe_restart

Multi-instance example 

# Comma-separated values — positional, one per instance
MCP_JENKINS_URL=https://pipeline.yourcompany.com,https://scheduler.yourcompany.com
MCP_JENKINS_USER=admin,admin
MCP_JENKINS_API_TOKEN=token1,token2
# Instances named "pipeline" and "scheduler" from hostnames

# Or name them explicitly with MCP_JENKINS_INSTANCES
MCP_JENKINS_INSTANCES=ci,prod
MCP_JENKINS_URL=https://jenkins.yourcompany.com/ci,https://jenkins.yourcompany.com/prod
MCP_JENKINS_USER=admin,admin
MCP_JENKINS_API_TOKEN=token1,token2

Read-only monitoring preset 

# Block all write/destructive tools — safe for monitoring dashboards
MCP_JENKINS_BLOCK_TOOLS=jenkins_trigger_build,jenkins_stop_build,jenkins_delete_build,\
jenkins_cancel_queue,jenkins_enable_job,jenkins_disable_job,jenkins_delete_job,\
jenkins_create_job,jenkins_update_job_config,jenkins_rename_job,jenkins_copy_job,\
jenkins_toggle_node_offline,jenkins_quiet_down,jenkins_cancel_quiet_down,\
jenkins_safe_restart,jenkins_replay_build