Get all running builds from Jenkins

Returns: A list of all running builds

Get specific build info from Jenkins

Args: fullname: The fullname of the job number: The number of the build, if None, get the last build

Returns: The build info

Get the scripts used in a specific build in Jenkins

Args: fullname: The fullname of the job number: The number of the build, if None, get the last build

Returns: A list of scripts used in the build

Get the console output of a specific build in Jenkins

Args: fullname: The fullname of the job number: The number of the build, if None, get the last build pattern: Optional regex pattern to filter lines (only matching lines are returned) offset: Number of lines to skip from the beginning after filtering, default 0 limit: Maximum number of lines to return after filtering and offset

Returns: The console output of the build

Get the test report of a specific build in Jenkins

Args: fullname: The fullname of the job number: The number of the build, if None, get the last build

Returns: The test report of the build

Get the parameters of a specific build in Jenkins

Args: fullname: The fullname of the job number: The number of the build, if None, get the last build

Returns: A dictionary of build parameter names and their values

Stop a specific build in Jenkins

Args: fullname: The fullname of the job number: The number of the build to stop

List the artifacts of a specific build in Jenkins

Args: fullname: The fullname of the job number: The number of the build, if None, get the last build

Returns: A list of artifact metadata dicts with fileName, relativePath, and displayPath

Download an artifact from a specific build in Jenkins

Binary files are returned as base64-encoded content; text files are returned as plain text.

Args: fullname: The fullname of the job relative_path: The relative path of the artifact (e.g. playwright-report/index.html) number: The number of the build, if None, get the last build

Returns: A dict with 'content' (str) and 'encoding' ('utf-8' or 'base64')

Get the direct URL of an artifact from a specific build in Jenkins

Args: fullname: The fullname of the job relative_path: The relative path of the artifact (e.g. playwright-report/index.html) number: The number of the build, if None, get the last build

Returns: The direct Jenkins URL of the artifact

Get all items from Jenkins

Returns: A list of items

Get specific item from Jenkins

Args: fullname: The fullname of the item

Returns: The item

Get specific item config from Jenkins

Args: fullname: The fullname of the item

Returns: The config of the item

Set specific item config in Jenkins

Args: fullname: The fullname of the item config_xml: The config XML of the item

Query items from Jenkins

Args: class_pattern: The pattern of the _class fullname_pattern: The pattern of the fullname color_pattern: The pattern of the color folder_depth: The maximum depth of folders to traverse. If None, traverses all levels.

Returns: A list of items

Build an item in Jenkins

Args: fullname: The fullname of the item data: The parameters to trigger the build with. Required if build_type is 'buildWithParameters'. build_type: If your item is configured with parameters, you must use 'buildWithParameters' as build_type.

Returns: The queue item number of the item.

Get the parameter definitions of a Jenkins job

Args: fullname: The fullname of the item

Returns: A list of parameter definitions, each containing name, type, defaultValue, and description

Get all nodes from Jenkins

Returns: A list of all nodes

Get a specific node from Jenkins

Contains executor about the node.

Args: name: The name of the node

Returns: The node

Get node config from Jenkins

Args: name: The name of the node

Returns: The config of the node

Set specific node config in Jenkins

Args: name: The name of the node config_xml: The config XML of the node

Get all installed plugins from Jenkins

Args: depth: The depth of the information to retrieve. Default is 2 (includes dependencies).

Returns: A list of all installed plugins

Get a specific plugin from Jenkins

Contains detailed information about the plugin, including dependencies when depth >= 2.

Args: short_name: The short name of the plugin depth: The depth of the information to retrieve. Default is 2 (includes dependencies).

Returns: The plugin details, or None if not found

Get all plugins with problems from Jenkins

These are plugins that have issues such as missing dependencies, incompatible versions, core version mismatch, or other configuration problems.

Returns: A list of plugins with problems

Get plugins that can be downgraded

Returns plugins that have a backupVersion and can be rolled back.

Args: depth: The depth of the information to retrieve. Default is 0.

Returns: A list of plugins that can be downgraded

Get plugins that have available updates

Args: depth: The depth of the information to retrieve. Default is 0.

Returns: A list of plugins with available updates

Get dependency graph for a specific plugin in Graphviz format

Recursively analyzes dependencies down to leaf nodes. Returns nodes and edges that can be used to generate a dependency graph.

Args: short_name: The short name of the plugin to analyze

Returns: A dictionary with 'nodes' and 'edges' for Graphviz rendering

Get all items in Jenkins queue

Returns: A list of all items in the Jenkins queue

Get a specific item in Jenkins queue by id

Args: id: The id of the queue item

Returns: The queue item

Cancel a specific item in Jenkins queue by id

Args: id: The id of the queue item

Get all top-level views from Jenkins.

Returns: A list of views with their name and URL.

Get a Jenkins view by path, returning its jobs and/or nested sub-views.

Views can be nested up to multiple levels deep. Use "/" to separate levels in the path. If the view contains sub-views instead of jobs, the response will include their names so you can drill down further.

Args: view_path: View path using "/" to separate levels. Examples: "All", "frontend", "frontend/nightly". Spaces and special characters in view names are handled automatically. depth: Depth of detail to retrieve for each job. Default is 0.

Returns: A dict with the view's name, jobs list, and/or nested views.

Execute an arbitrary Groovy script on Jenkins.

This tool provides access to Jenkins internal features that are not available via REST API.

Args: script: The Groovy script code to execute.

Returns: The result of the script execution.

Examples: # Basic usage: run_groovy_script(script='println Jenkins.instance.version')

# Access Jenkins information:
run_groovy_script(
    script='''
        def version = Jenkins.instance.version
        def mode = Jenkins.instance.mode
        return "Version: ${version}, Mode: ${mode}"
    '''
)