CloudBees Unify MCP Server tool reference

2 minute read

Tools available through the CloudBees Unify MCP Server are organized into functional categories. All tools are visible to authenticated users, but your CloudBees Unify roles determine which resources you can access when using those tools. For background on authentication and RBAC enforcement, refer to Understanding the CloudBees Unify MCP Server.

How tools work

When you ask your AI agent a question, it determines which tools to call and with what parameters. You do not need to know the exact tool names. 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 a component filter.

"Who am I?"

AI agent calls user_whoami.

Actions and automation

Tools for listing actions, automation jobs, and workflow runs.

actions_list

List actions.

automation_jobs_list

List automation jobs.

runs_list

List workflow runs.

Branches and repositories

Tools for listing and searching branches and repositories.

branches_list

List branches.

repositories_list

List repositories.

repositories_search

Search for repositories.

Components

Tools for creating, deleting, listing, and searching components.

components_create

Create a new component.

components_delete

Delete a component.

components_list

List components.

components_search

Search for components.

Controllers

Tools for retrieving data and listing CI controllers.

controllers_data_get

Get controller data.

controllers_list

List CI controllers.

Endpoints and resources

Tools for listing endpoints, properties, and resources.

endpoint_list

List endpoints.

properties_list

List properties.

resources_list

List resources.

Feature flags

Tools for managing feature flags, their configurations, environments, and applications.

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

Tools for listing logs and retrieving report data.

logs_list

List logs.

report_drilldown_get

Get report drilldown data.

Organizations

Tools for listing and searching organizations.

organizations_list_suborganizations

List child organizations.

organizations_search

Search for organizations.

organizations_suborg_report

Get child organization report.

Security

Tools for retrieving security findings and issues.

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

Tools for listing teams and users, and managing user settings.

teams_list

List teams.

user_set_timezone

Set user timezone.

user_whoami

Get current user information.

users_list

List users.

Workflows

Tools for listing, triggering, validating, and updating 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.