Which integrations are available for this server?

Provides tools for interacting with Jenkins via REST API, enabling AI agents to manage jobs, builds, logs, SCM configurations, and test results on a Jenkins instance.

How do I use host-mcp-jenkins?

1. Click on "Install 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., "@host-mcp-jenkins get the latest build status of 'my-app'" 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.

host-mcp-jenkins

by mister-good-deal

Overview Schema Related Servers Score Discussions

TypeScript

Remote

host-mcp-jenkins

A local MCP (Model Context Protocol) server for Jenkins that replicates the Jenkins MCP Server Plugin by calling Jenkins REST API over HTTP.

No plugin installation required on your Jenkins instance.

Why?

The official Jenkins MCP Server Plugin must be installed on the Jenkins server. If you don't have admin rights to install plugins, host-mcp-jenkins gives you the same 17 MCP tools running locally, calling Jenkins REST API with your personal API token.

Compatibility

Jenkins Version	Status
LTS 2.462.x+	✅ Fully supported
LTS 2.426.x	✅ Fully supported
LTS 2.401.x	✅ Fully supported
LTS 2.361.x	✅ Fully supported
Weekly (latest)	✅ Fully supported

Minimum version: Jenkins 2.164+. All REST API endpoints used by this server have been available in Jenkins core since the earliest 2.x releases. The tree query parameter (used for response field filtering) was introduced in Jenkins 1.464.

Plugin Dependencies

Most tools (11 out of 17) use only the Jenkins core REST API and require no plugins. Some tool categories depend on specific plugins:

Tools	Required Plugin	Min Plugin Version	Notes
`getJobScm`, `getBuildScm`, `findJobsWithScmUrl`	Git Plugin	2.0+	SCM data exposed via Git plugin actions
`getTestResults`	JUnit Plugin	1.0+	Bundled with Jenkins since 1.577
`getFlakyFailures`	JUnit Plugin	1.33+	Flaky test detection support required

Note: The Git Plugin is installed on ~96% of Jenkins controllers. The JUnit Plugin is installed on ~97% and has been bundled with Jenkins by default since version 1.577. If these plugins are not present, the corresponding tools will return empty results or 404 errors.

API Endpoint Matrix

Every tool maps to one or more Jenkins REST API endpoints. All JSON endpoints support the tree parameter for field filtering.

Tool	Method	REST Endpoint	Dependency
`getJob`	GET	`/job/{name}/api/json`	Core
`getJobs`	GET	`/api/json`	Core
`getBuild`	GET	`/job/{name}/{build\|lastBuild}/api/json`	Core
`triggerBuild`	POST	`/job/{name}/build`, `/job/{name}/buildWithParameters`	Core
`updateBuild`	POST	`/job/{name}/{build}/submitDescription`, `configSubmit`	Core
`whoAmI`	GET	`/me/api/json`	Core
`getStatus`	GET	`/api/json`, `/computer/api/json`, `/queue/api/json`	Core
`getQueueItem`	GET	`/queue/item/{id}/api/json`	Core
`getBuildLog`	GET	`/job/{name}/{build}/consoleText`	Core
`getProgressiveBuildLog`	GET	`/job/{name}/{build}/logText/progressiveText`	Core
`searchBuildLog`	GET	`/job/{name}/{build}/consoleText`	Core
`getJobScm`	GET	`/job/{name}/api/json`	Git Plugin
`getBuildScm`	GET	`/job/{name}/{build}/api/json`	Git Plugin
`getBuildChangeSets`	GET	`/job/{name}/{build}/api/json`	Core
`findJobsWithScmUrl`	GET	`/api/json` (recursive 3-level tree)	Git Plugin
`getTestResults`	GET	`/job/{name}/{build}/testReport/api/json`	JUnit Plugin
`getFlakyFailures`	GET	`/job/{name}/{build}/testReport/api/json`	JUnit Plugin ≥ 1.33

Quick Start

npx @mister-good-deal/host-mcp-jenkins \
  --jenkins-url https://jenkins.example.com \
  --jenkins-user your-username \
  --jenkins-token your-api-token

HTTP Transport

To start the server with Streamable HTTP transport instead of stdio:

npx @mister-good-deal/host-mcp-jenkins \
  --jenkins-url https://jenkins.example.com \
  --jenkins-user your-username \
  --jenkins-token your-api-token \
  --transport http \
  --port 3000

This exposes:

Health check: GET /health → {"status":"ok"}
MCP endpoint: /mcp (Streamable HTTP)
Graceful shutdown on SIGINT / SIGTERM

Configuration

All options support both CLI arguments and environment variables (CLI takes precedence):

CLI Argument	Environment Variable	Required	Default	Description
`--jenkins-url`	`JENKINS_URL`	✅	—	Jenkins base URL
`--jenkins-user`	`JENKINS_USER`	✅	—	Jenkins username
`--jenkins-token`	`JENKINS_API_TOKEN`	✅	—	Jenkins API token
`--insecure`	`JENKINS_INSECURE=true`		`false`	Skip TLS certificate verification
`--log-level`	`LOG_LEVEL`		`info`	`debug` \| `info` \| `warn` \| `error`
`--timeout`	`JENKINS_TIMEOUT`		`30000`	HTTP request timeout (ms)
`--max-retries`	`JENKINS_MAX_RETRIES`		`3`	Max retries for transient errors (429/5xx)
`--retry-delay`	`JENKINS_RETRY_DELAY`		`1000`	Base delay in ms for exponential backoff
`--transport`	`MCP_TRANSPORT`		`stdio`	Transport type (`stdio` \| `http`)
`--port`	`MCP_PORT`		`3000`	HTTP server port (only with `--transport http`)

Getting a Jenkins API Token

Log in to Jenkins
Click your username (top-right) → Configure
Under API Token, click Add new Token
Name it and click Generate — copy the token value

MCP Client Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "jenkins": {
      "command": "npx",
      "args": ["-y", "@mister-good-deal/host-mcp-jenkins"],
      "env": {
        "JENKINS_URL": "https://jenkins.example.com",
        "JENKINS_USER": "your-username",
        "JENKINS_API_TOKEN": "your-api-token"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "jenkins": {
      "command": "npx",
      "args": ["-y", "@mister-good-deal/host-mcp-jenkins"],
      "env": {
        "JENKINS_URL": "https://jenkins.example.com",
        "JENKINS_USER": "your-username",
        "JENKINS_API_TOKEN": "your-api-token"
      }
    }
  }
}

Cursor

Add to your MCP server configuration:

{
  "mcpServers": {
    "jenkins": {
      "command": "npx",
      "args": ["-y", "@mister-good-deal/host-mcp-jenkins", "--jenkins-url", "https://jenkins.example.com", "--jenkins-user", "your-username", "--jenkins-token", "your-api-token"]
    }
  }
}

Note for contributors: If you're running the MCP server from within this workspace (where package.json declares "packageManager": "pnpm@...") and npx fails with host-mcp-jenkins: not found, use pnpm dlx instead. This happens because corepack intercepts npx when run from a pnpm-managed project.

HTTP Transport (Remote)

When the server is running with --transport http, MCP clients can connect via HTTP URL instead of launching a subprocess:

Claude Desktop / VS Code / Cursor:

{
  "mcpServers": {
    "jenkins": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Docker Usage

HTTP transport enables AI agents running inside Docker containers to connect to the MCP server without needing an MCP gateway.

Running the MCP Server on the Host

Start the server with HTTP transport on the host machine:

npx @mister-good-deal/host-mcp-jenkins \
  --jenkins-url https://jenkins.example.com \
  --jenkins-user your-username \
  --jenkins-token your-api-token \
  --transport http \
  --port 3000

From inside a Docker container, connect to http://host.docker.internal:3000/mcp.

Docker Compose Example

services:
  ai-agent:
    image: your-ai-agent:latest
    environment:
      MCP_SERVER_URL: "http://host.docker.internal:3000/mcp"
    extra_hosts:
      - "host.docker.internal:host-gateway"

Note: The extra_hosts mapping is required on Linux. On macOS and Windows, Docker Desktop resolves host.docker.internal automatically.

Available Tools (17)

Full parity with the Jenkins MCP Server Plugin, plus extras:

Core (8)

Tool	Description
`getJob`	Get a Jenkins job by its full path
`getJobs`	Get a paginated list of Jenkins jobs, sorted by name
`getBuild`	Get a specific build or the last build of a Jenkins job
`triggerBuild`	Trigger a build for a Jenkins job (supports parameters)
`updateBuild`	Update build display name and/or description
`whoAmI`	Get information about the currently authenticated user
`getStatus`	Check the health and readiness status of a Jenkins instance
`getQueueItem`	Get the queue item details by its ID

Build Logs (3)

Tool	Description
`getBuildLog`	Retrieve paginated log lines for a build
`getProgressiveBuildLog`	Incrementally retrieve build logs via Jenkins progressive text API
`searchBuildLog`	Search for log lines matching a pattern (string or regex)

SCM (4)

Tool	Description
`getJobScm`	Retrieve SCM configurations of a Jenkins job
`getBuildScm`	Retrieve SCM configurations of a Jenkins build
`getBuildChangeSets`	Retrieve change log sets of a Jenkins build
`findJobsWithScmUrl`	Find jobs that use a specified git SCM URL

Test Results (2)

Tool	Description
`getTestResults`	Retrieve test results for a build (optionally only failures)
`getFlakyFailures`	Retrieve flaky test failures for a build

Comparison with Jenkins MCP Server Plugin

Feature	Jenkins Plugin	host-mcp-jenkins
Installation	Requires Jenkins admin	None — runs locally
Transport	SSE, Streamable HTTP, Stateless	stdio (default), Streamable HTTP
Authentication	Jenkins built-in	API token over HTTP Basic
Tools	16	17 (full parity + progressive log)
Response format	`ToolResponse` envelope	Same `ToolResponse` envelope
`tree` parameter	Via internal API	Forwarded to REST API

Development

# Install dependencies
pnpm install

# Build
pnpm run build

# Run in development mode
pnpm run dev -- --jenkins-url https://jenkins.example.com --jenkins-user admin --jenkins-token TOKEN

# Lint
pnpm run lint

# Unit tests
pnpm test

# Integration tests (requires Docker)
pnpm run test:integration

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

0dRelease cycle

4Releases (12mo)

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mister-good-deal/host-mcp-jenkins'

If you have feedback or need assistance with the MCP directory API, please join our Discord server