Skip to main content
Version: Release 26.1

Release MCP Tools Plugin

note

The bundled Release MCP Tools Plugin is available only from the 26.1.5 maintenance release onward.

Digital.ai Release includes a built-in Model Context Protocol (MCP) server through the bundled Release MCP Tools Plugin. The MCP server lets AI agents securely interact with releases, templates, tasks, variables.

Prerequisites

  • You must have the Admin global permission to configure the MCP server.
  • Ensure that the MCP server is enabled in System Settings > AI Settings. For more information, see AI Settings.

Key Features

  • Bundled by default: The plugin is included with Digital.ai Release, so no separate installation is required. To view the installed version, go to cog icon > Manage Plugins.
  • Enabled by default: The MCP server is enabled by default, allowing Ask Release to work immediately without additional configuration. Administrators can enable or disable the MCP server in System Settings > AI Settings.
  • Read and write access: By default, AI agents can use both read and write tools. To prevent AI agents from making changes, enable Read-only mode in AI Settings.
  • No restart required: Changes to the MCP server settings take effect immediately across the Release cluster.

Connect an AI Agent

The MCP Server settings page provides a ready-to-use connection snippet for supported AI clients.

Under MCP Connection Snippet, select your client and copy the generated configuration into your client's MCP settings. The snippet includes the server URL and the x-release-personal-token header, which authenticates the AI agent with your Release personal access token. The AI agent can access only the resources that your user is permitted to access.

The following example shows an MCP server configuration for the Visual Studio Code mcp.json file:

{
"servers": {
"Digital.ai Release": {
"type": "http",
"url": "https://<your-release-host>/s/mcp",
"headers": {
"x-release-personal-token": "YOUR_PERSONAL_ACCESS_TOKEN"
}
}
}
}

The MCP server URL is your Release server base URL followed by /s/mcp, for example https://release.example.com/s/mcp. This path is the same for both SaaS and on-premises installations.

For Cursor and Claude Code, use the same x-release-personal-token header. For Claude Desktop, pass it on the command line as --header x-release-personal-token: YOUR_PERSONAL_ACCESS_TOKEN.

Replace the placeholder values with the URL and personal access token generated in the MCP Connection Snippet section of Digital.ai Release.

Available Tools

The plugin provides the following tools. Read-only tools are always available. The read/write tools, which create, update, delete, or run things, are available only when Read-only mode is turned off.

Read-only Tools

ToolDescription
list_releasesList and filter releases, active or archived.
get_releaseGet the details of a release.
count_releasesCount releases that match a filter.
download_attachmentDownload a file attached to a task or release.
list_templatesList templates across folders.
get_templateGet a template, including its phases and tasks.
list_foldersBrowse the folder hierarchy.
find_folderFind a folder by its path.
search_configurationsSearch configurations by type and title.
get_configurationGet a configuration.
list_variablesList variables in a release, template, folder, or global context.
get_variableGet a variable.
get_type_namesList the available object types.
get_metadata_typeGet the definition and properties of a type.
get_activity_logsGet the activity log of a release.
list_installed_pluginsList installed plugins and their versions.
search_available_pluginsSearch the plugin gallery for available plugins and updates.
list_triggersList release triggers.
get_triggerGet a trigger.

Read/Write Tools

These tools are hidden when Read-only mode is enabled.

ToolDescription
create_release_from_templateCreate a release from a template.
start_releaseStart a release.
manage_templateCreate, update, or delete a template.
manage_folderCreate, delete, or move a folder.
manage_configurationCreate, update, or delete a configuration.
manage_variableCreate, update, or delete a variable in any context.
manage_phaseCreate, update, or delete a phase.
manage_taskCreate, update, delete, or change the type of a task.
transition_taskComplete, fail, retry, skip, or abort a task.
manage_gate_conditionCreate, update, or delete a gate condition.
manage_gate_dependencyCreate or delete a gate dependency.