Release MCP Tools Plugin
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
> 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
| Tool | Description |
|---|---|
list_releases | List and filter releases, active or archived. |
get_release | Get the details of a release. |
count_releases | Count releases that match a filter. |
download_attachment | Download a file attached to a task or release. |
list_templates | List templates across folders. |
get_template | Get a template, including its phases and tasks. |
list_folders | Browse the folder hierarchy. |
find_folder | Find a folder by its path. |
search_configurations | Search configurations by type and title. |
get_configuration | Get a configuration. |
list_variables | List variables in a release, template, folder, or global context. |
get_variable | Get a variable. |
get_type_names | List the available object types. |
get_metadata_type | Get the definition and properties of a type. |
get_activity_logs | Get the activity log of a release. |
list_installed_plugins | List installed plugins and their versions. |
search_available_plugins | Search the plugin gallery for available plugins and updates. |
list_triggers | List release triggers. |
get_trigger | Get a trigger. |
Read/Write Tools
These tools are hidden when Read-only mode is enabled.
| Tool | Description |
|---|---|
create_release_from_template | Create a release from a template. |
start_release | Start a release. |
manage_template | Create, update, or delete a template. |
manage_folder | Create, delete, or move a folder. |
manage_configuration | Create, update, or delete a configuration. |
manage_variable | Create, update, or delete a variable in any context. |
manage_phase | Create, update, or delete a phase. |
manage_task | Create, update, delete, or change the type of a task. |
transition_task | Complete, fail, retry, skip, or abort a task. |
manage_gate_condition | Create, update, or delete a gate condition. |
manage_gate_dependency | Create or delete a gate dependency. |