Example prompts and workflows

The examples below illustrate how an AI agent interprets natural-language requests and maps them to MCP server tools. Single-tool examples show straightforward requests; the complex multi-tool workflows section shows how the agent chains several tools together to answer a single request.

For the full tool reference, see MCP server tools.

Identify yourself

“Who am I, according to CloudBolt?”
“What is my username and email in the platform?”
“Am I a super admin in CloudBolt?”

The agent calls fetch_identity and returns your username, email, and group memberships.

List and inspect servers

“Show me all my servers and their current status.”
“Show me all servers in CloudBolt.”
“List all servers that are currently powered off.”
“Show me all running servers across all groups.”
“Which servers belong to the Sales Engineers group?”
“Find all servers whose hostname starts with ’lal’.”
“Give me the full details for server SVR-abc12345.”
“What OS is running on server SVR-abc12345?”
“What cloud environment is server SVR-abc12345 deployed in?”
“Show me the CPU and memory specs for server SVR-abc12345.”
“What group does server SVR-abc12345 belong to?”

The agent calls fetch_server_list, filtering by power status, group, or hostname as needed, and optionally follows up with fetch_server_details to retrieve the OS, CPU/RAM, environment, or group of an individual server.

Run a server action

“What actions can I run on server SVR-abc12345?”
“Can I snapshot server SVR-abc12345?”
“What options are available for the ‘resize’ action parameter on server SVR-abc12345?”
“Show me the available sizes I can choose when resizing server SVR-abc12345.”
“What values can I pick for the region parameter when running an action on server SVR-abc12345?”
“List the parameter choices for the backup action on server SVR-abc12345.”
“Run the snapshot action on server SVR-abc12345.”
“Resize server SVR-abc12345 to a larger instance type.”
“Run the ‘install-agent’ action on server SVR-abc12345.”

The agent calls fetch_server_actions to discover available actions and parameters, fetch_server_action_parameter_options to resolve any dynamic choices, then run_server_action. The agent follows up with fetch_job or fetch_order.

Schedule server power

“What is the power schedule for server SVR-abc12345?”
“When is server SVR-abc12345 scheduled to shut down?”
“Does server SVR-abc12345 have an automatic start time configured?”
“Show me the power schedule for all servers in the Sales Engineers group.”
“Is server SVR-abc12345 set to power off on weekends?”
“Schedule server SVR-abc12345 to power off at 8 PM every weekday.”
“Set server SVR-abc12345 to start at 7 AM Monday through Friday.”
“Configure server SVR-abc12345 to shut down every night at midnight.”
“Set a weekend power-off schedule for server SVR-abc12345.”
“Schedule server SVR-abc12345 to restart every Sunday at 2 AM.”
“Remove the power schedule from server SVR-abc12345.”
“Clear all scheduled power events for server SVR-abc12345.”
“Disable the auto-shutdown schedule on server SVR-abc12345.”
“Cancel the power schedule I set on server SVR-abc12345.”
“Remove the nightly shutdown schedule from server SVR-abc12345.”

The agent calls set_server_power_schedule to apply a schedule, fetch_server_power_schedule to show the current schedule, and clear_server_power_schedule to remove it.

Explore cloud environments

“What cloud environments do I have access to?”
“List all environments in CloudBolt.”
“What cloud environments are connected to the platform?”
“Show me all AWS environments available.”
“Are there any Azure environments configured in CloudBolt?”
“What vSphere environments are available?”
“Give me the full details for environment ENV-hgaqef4i.”
“What cloud provider is environment ENV-hgaqef4i connected to?”
“What region is environment ENV-hgaqef4i in?”
“Show me the quotas configured for environment ENV-hgaqef4i.”
“What groups have access to environment ENV-hgaqef4i?”

The agent calls fetch_environment_list and optionally fetch_environment_details for the provider, region, quotas, and group access for a specific environment.

Browse resources

“Show me all Kubernetes clusters managed by CloudBolt.”
“List all resources in CloudBolt.”
“List all resources belonging to the Sales Engineers group.”
“What types of resources can CloudBolt manage?”
“Give me full details for resource RSC-g2ltcp0c.”
“What environment is resource RSC-g2ltcp0c deployed in?”
“Who owns resource RSC-g2ltcp0c?”
“What type of resource is RSC-g2ltcp0c?”
“Show me the configuration details for resource RSC-g2ltcp0c.”

The agent calls fetch_resource_types to find the resource type ID, then fetch_resources filtered by that type or group, and fetch_resource_details for a specific resource. Use fetch_resource_link for a direct link to the resource.

Run a resource action

“What actions are available for resource RSC-g2ltcp0c?”
“Can I scale resource RSC-g2ltcp0c?”
“List all runnable actions on resource RSC-g2ltcp0c.”
“Is there a backup action for resource RSC-g2ltcp0c?”
“What management actions can I perform on resource RSC-g2ltcp0c?”
“What options are available for the scale action on resource RSC-g2ltcp0c?”
“Show me the valid parameter choices for the backup action on RSC-g2ltcp0c.”
“Run the backup action on resource RSC-abc12345.”
“Scale resource RSC-xyz98765 to the large tier.”
“Trigger the failover action on resource RSC-abc12345.”
“Run the ‘rotate-credentials’ action on resource RSC-xyz98765.”
“Execute the decommission action on resource RSC-abc12345.”

The agent calls fetch_resource_actions to discover the available actions, fetch_resource_action_parameter_options for any dynamic parameter choices, then run_resource_action, monitoring the result with fetch_job or fetch_order.

Schedule resource power

“What is the power schedule for resource RSC-abc12345?”
“Is resource RSC-xyz98765 set to shut down overnight?”
“Show me the scheduled power events for resource RSC-abc12345.”
“When is resource RSC-xyz98765 scheduled to start up?”
“Does resource RSC-abc12345 have any power automation configured?”
“Schedule resource RSC-abc12345 to power off at 10 PM daily.”
“Set resource RSC-xyz98765 to start at 6 AM on weekdays.”
“Configure a weekend shutdown schedule for resource RSC-abc12345.”
“Set resource RSC-xyz98765 to restart every Sunday at 3 AM.”
“Schedule resource RSC-abc12345 to power off every Friday at 6 PM.”
“Remove the power schedule from resource RSC-abc12345.”
“Clear all power automation for resource RSC-xyz98765.”
“Disable the auto-shutdown on resource RSC-abc12345.”
“Cancel the scheduled power events for resource RSC-xyz98765.”
“Turn off power scheduling for resource RSC-abc12345.”

The agent calls set_resource_power_schedule, fetch_resource_power_schedule, and clear_resource_power_schedule. A resource schedule powers all of a resource’s servers on and off.

Work with groups

“What groups do I have access to?”
“List all groups in CloudBolt.”
“Show me all top-level groups in the platform.”
“Are there any groups related to the engineers department?”
“Give me the details for the Sales Engineers group.”
“What environments are associated with the Sales Engineers group?”
“Can I order into the Sales Engineers group?”

The agent calls fetch_groups to list your groups and fetch_group_details for a specific group’s members and environments. The fetch_orderable_groups tool returns groups you can order under, and fetch_group_link returns a direct link to the group.

Order from the catalog

“What catalog items are available for me to order?”
“Show me all available blueprints in the catalog.”
“Is there a catalog item for provisioning a Linux VM?”
“List all catalog items tagged with ’networking’.”
“What self-service items can I order from CloudBolt?”
“What tags are used to categorize catalog items?”
“Show me all available catalog tags in CloudBolt.”
“Are there catalog items tagged ‘ESO’?”
“What tags exist for filtering the catalog?”
“List all catalog tags and how many items each has.”
“Which environments can I deploy resources into?”
“What environments are available when placing a catalog order?”
“Show me all environments I can order servers into.”
“Can I deploy into the AWS us-east-1 environment?”
“Show me the schema for blueprint BP-bzznmo4r.”
“What parameters does blueprint BP-7rm1q96s require?”
“Show me all the inputs needed to order blueprint BP-7rm1q96s.”
“What fields do I need to fill out for the Custom Server blueprint?”
“Are there any required parameters for blueprint BP-7rm1q96s?”
“List the parameters and their types for blueprint BP-7rm1q96s.”
“What values can I choose for the ‘vcenter_folder_name’ parameter in blueprint BP-7rm1q96s?”
“Show me the available OS options for blueprint Custom Server.”
“List the valid options for the environment parameter in blueprint Custom Server.”
“Build an order payload for blueprint BP-vhlndvv2 with a medium-sized Linux VM.”
“Order a Linux VM from the catalog into the Sales Engineers group.”
“Show me all orders placed for blueprint BP-vhlndvv2.”

The agent calls fetch_catalog_items to find a blueprint, fetch_orderable_groups to select a group, and fetch_blueprint_schema to read the required parameters and deployment items. It resolves dynamic choices with fetch_blueprint_parameter_options, returns the assembled order for confirmation, then submits it with order_catalog_item. To repeat a past deployment, the agent uses list_blueprint_orders and fetch_blueprint_order_payload.

This follows the Ordering a catalog item steps.

Track and approve orders

“Show me all orders in CloudBolt.”
“List all pending orders in the system.”
“Did I submit any blueprint orders yesterday?”
“What is the status of order 807?”
“Do I have any orders waiting for my approval?”
“Approve order ORD-ohp12uc7.”
“Deny order ORD-tyjq9zv1.”
“Deny all orders that are pending.”
“Reject the Linux VM request ORD-xyz98765 with reason ‘Not in budget’.”
“Cancel order ORD-abc12345.”

The agent calls fetch_orders to list orders and fetch_order for the status of a specific order. For approvers, fetch_orders_pending_my_approval lists orders pending approval, and approve_order, deny_order, and cancel_order act on pending orders. Use fetch_order_link for a direct link to an order.

Monitor jobs

“Are there any jobs currently running in CloudBolt?”
“What is the status of job 102112?”
“Did job JOB-o1qpgosn complete successfully?”
“Show me the output logs for job JOB-o1qpgosn.”
“How long did job JOB-o1qpgosn take to run?”
“What action triggered job JOB-o1qpgosn?”

The agent calls fetch_running_jobs to list jobs in progress, and fetch_job for the status, timing, and outcome of a specific job. Use fetch_job_link for a direct link to a job in the portal.

Link to objects in the UI

“Give me a link to the CloudBolt dashboard.”
“Give me a link to resource RSC-g2ltcp0c in the CloudBolt portal.”
“Give me a UI link to the Sales Engineers group.”
“Give me a UI link to order ORD-yv03rzxb.”
“Give me a UI link to job JOB-o1qpgosn.”

The agent calls fetch_dashboard_link and the matching link tool, such as fetch_server_link, for a direct link to a specific object.

Complex multi-tool workflows

The following examples chain several tools together to answer a single request.

End-of-day cost-saving shutdown

“Find all servers in the Sales Engineers and Main groups that don’t already have a power schedule, and set them to shut down at 7 PM every weekday.”

The agent calls fetch_groups, fetch_server_list, fetch_server_power_schedule, and set_server_power_schedule.

Pending-approval triage with links

“Show me all orders waiting for my approval, summarize what each one is requesting, and give me a direct link to each so I can review them in the portal.”

The agent calls fetch_orders_pending_my_approval, fetch_order, and fetch_order_link.

Full server audit report

“Give me a full audit of all servers in the Sales Engineers group — include their power status, OS, environment, whether they have a power schedule, and what actions are available on each.”

The agent calls fetch_server_list, fetch_server_details, fetch_server_power_schedule, and fetch_server_actions.

Self-service deployment end-to-end

“I want to provision a Linux VM. Show me what catalog items are available, walk me through the required parameters and options, then place the order into the Sales Engineers group in the VMware environment.”

The agent calls fetch_catalog_items, fetch_orderable_groups, fetch_orderable_environments, fetch_blueprint_schema, fetch_blueprint_parameter_options (with fetch_blueprint_item_parameters), and order_catalog_item.

Running job health check with links

“Are there any jobs currently running? For each one, give me the full status details and a link so I can monitor them in the portal.”

The agent calls fetch_running_jobs, fetch_job, and fetch_job_link.

Group capacity overview

“For each group I have access to, show me how many servers and resources it contains along with any quota or budget information.”

The agent calls fetch_groups, fetch_group_details, fetch_server_list, and fetch_resources.

Environment readiness check before ordering

“Before I place an order, show me which environments are available, their cloud provider and region details, which groups can order into them, and what catalog items are eligible.”

The agent calls fetch_orderable_environments, fetch_environment_details, fetch_orderable_groups, and fetch_catalog_items.

Approve all pending orders with a summary

“Show me everything currently in my approval queue with a summary of each request, then approve all orders that are for the Sales Engineers group.”

The agent calls fetch_orders_pending_my_approval, fetch_order, and approve_order.

Failed-order investigation

“Show me all orders from the past 7 days that failed or were denied, get the full details on each, pull the associated job, and give me links to review them in the portal.”

The agent calls fetch_orders, fetch_order, fetch_job, and fetch_job_link.

Complete power-schedule cleanup

“Find all servers and resources that have a power schedule set, list what those schedules are, and then clear every power schedule across the board so we start fresh.”

The agent calls fetch_server_list, fetch_server_power_schedule, clear_server_power_schedule, fetch_resources, fetch_resource_power_schedule, and clear_resource_power_schedule.

Blueprint order-payload preview before submission

“I want to order the Custom Server blueprint but I’m not sure about the parameters. Show me the schema, walk me through all available parameter options, and generate the full order payload so I can review it before submitting.”

The agent calls fetch_catalog_items, fetch_blueprint_schema, fetch_blueprint_item_parameters, fetch_blueprint_parameter_options, and fetch_blueprint_order_payload.

Cross-group server comparison report

“Compare the servers in the Main group versus the Sales Engineers group — show me the differences in instance sizes, operating systems, cloud environments, and power statuses.”

The agent calls fetch_groups, fetch_server_list, fetch_server_details, and fetch_environment_details.

Full identity and access context report

“Give me a complete picture of my access in CloudBolt: who I am, what groups I belong to, what environments I can deploy into, what I’m allowed to order, and a summary of orders I’ve placed recently.”

The agent calls fetch_identity, fetch_groups, fetch_group_details, fetch_orderable_groups, fetch_orderable_environments, and fetch_orders.