CloudBees Unify MCP Server Tool reference

The CloudBees Unify MCP Server provides tools for working with CloudBees Unify through AI agents.

All tools are visible to authenticated users. Your CloudBees Unify roles determine which resources you can access when using those tools.

How tools work

When you ask your AI agent a question, it determines which tools to call and with what parameters. You don’t need to know the exact tool names, just ask in natural language.

For example:

"List my components": AI agent calls components_list.
"Show workflows for api-gateway": AI agent calls workflow_list with component filter.
"Who am I?": AI agent calls user_whoami.

Tool categories

Tools are organized into the following categories:

Actions and automation
Branches and repositories
Components
Controllers
Endpoints and resources
Feature flags
Logs and reports
Organizations
Security
Teams and users
Workflows

Actions and automation

actions_list: List actions.
automation_jobs_list: List automation jobs.
runs_list: List workflow runs.

Branches and repositories

branches_list: List branches.
repositories_list: List repositories.
repositories_search: Search for repositories.

Components

components_create: Create a new component.
components_delete: Delete a component.
components_list: List components.
components_search: Search for components.

Controllers

controllers_data_get: Get controller data.
controllers_list: List CI controllers.

Endpoints and resources

endpoint_list: List endpoints.
properties_list: List properties.
resources_list: List resources.

Feature flags

flags_add: Add a feature flag.
flags_applications_list: List feature flag applications.
flags_configuration_state_update: Update feature flag configuration state.
flags_configurations_list: List feature flag configurations.
flags_delete: Delete a feature flag.
flags_environments_list: List feature flag environments.
flags_get: Get a feature flag by ID.
flags_get_by_name: Get a feature flag by name.
flags_list: List feature flags.
flags_update_defaultValue_string: Update feature flag default value.

Logs and reports

logs_list: List logs.
report_drilldown_get: Get report drilldown data.

Organizations

organizations_list_suborganizations: List sub-organizations.
organizations_search: Search for organizations.
organizations_suborg_report: Get sub-organization report.

Security

security_findings_summary_get: Get security findings summary.
security_issues_all_get: Get all security issues.
security_issues_open_get: Get open security issues.

Teams and users

teams_list: List teams.
user_set_timezone: Set user timezone.
user_whoami: Get current user information.
users_list: List users.

Workflows

workflow_get_content: Get workflow content.
workflow_list: List workflows.
workflow_schema_get: Get workflow schema.
workflow_trigger: Trigger a workflow.
workflow_update_content: Update workflow content.
workflow_validate: Validate a workflow.

Tool access and permissions

All tools are visible regardless of your role. When you use a tool, CloudBees Unify enforces role-based access control:

Your AI agent can only access resources you have permission to access.
Tool calls fail if you lack permission for the requested resource.
All tool calls are logged and attributed to your user account.

If a tool call fails with a permission error, contact your CloudBees Unify administrator to verify your role assignments.