MCP server tools

Mon, 01 Jan 0001 00:00:00 +0000

The CMP MCP server exposes a set of built-in tools covering servers, resources, groups, environments, jobs, orders, catalog operations, power schedules, and UI links.

Listing the available tools

List the tools a CMP server currently publishes using the management command:

./manage.py mcp_inspect

Safety profiles

All tools operate within the authenticated user’s permission scope. Each tool is tagged with a safety profile:

read_only: The tool only reads data and cannot make changes. Multiple read-only tools can be called in parallel to gather information.
write: The tool can change the state of CMP and/or your cloud resources, and requires the write scope (see Authentication).

Identity

Tool	Safety	Parameters	Description
`fetch_identity`	`read_only`	None	Return the authenticated user’s profile: username, email, and group memberships.

Servers

Tool	Safety	Parameters	Description
`fetch_server_list`	`read_only`	`hostname` (optional): exact hostname match `hostname_contains` (optional): servers whose hostname contains this string; ignored if `hostname` is set `hostname_startswith` (optional): servers whose hostname starts with this string; ignored if `hostname` or `hostname_contains` is set `group_name` (optional): exact name of the group the server belongs to `power_status` (optional): `on` for powered-on servers, `off` for powered-off servers `owned_by_me` (optional): when `True`, return only servers owned by the requesting user `page` (optional; defaults to `1`) `page_size` (optional; defaults to `25`)	List all active servers visible to the current user.
`fetch_server_details`	`read_only`	`server_id`	Return full details for a specific server: IP, OS, CPU/RAM, status, and provider metadata.
`fetch_server_action_parameter_options`	`read_only`	`action_id`: action global ID (for example, “SVA-abc12345”) `parameter_name`: name of the parameter from the `fetch_server_actions` schema `server_ids`: list of server global IDs the action will run on `current_values`: dictionary of provided parameter values; required when fetching options for a parameter that depends on another	Return the available options for a specific server action parameter.
`fetch_server_actions`	`read_only`	`server_id`	Return the list of server actions available to the current user for a given server, along with each action’s parameter schema.
`run_server_action`	`write`	`server_ids`: list of server global IDs (for example, “SVR-abc12345”) `action_id`: action global ID returned by `fetch_server_actions` (for example, “SVA-abc12345”) `parameters`: dictionary of parameter values keyed by the parameter name from the `fetch_server_actions` schema	Run a server action on one or more servers.

Groups

Tool	Safety	Parameters	Description
`fetch_groups`	`read_only`	None	List all groups accessible to the user.
`fetch_group_details`	`read_only`	`group_id`	Return full details for a specific group, including members and assigned environments.

Environments

Tool	Safety	Parameters	Description
`fetch_environment_list`	`read_only`	None	List all cloud environments the user can access (for example, AWS regions, Azure subscriptions, vSphere clusters).
`fetch_environment_details`	`read_only`	`environment_id`	Return full details for a specific environment: provider type, connection status, and available networks.

Resources

Tool	Safety	Parameters	Description
`fetch_resource_types`	`read_only`	None	List all registered resource types and their global IDs. Call this first when filtering by type.
`fetch_resources`	`read_only`	`name` (optional): exact resource name `name_contains` (optional): resources whose name contains this string; ignored if `name` is set `name_startswith` (optional): resources whose name starts with this string; ignored if `name` or `name_contains` is set `group_name` (optional): exact name of the group the resource belongs to `owned_by_me` (optional): when `True`, returns only resources owned by the requesting user `resource_type_name` (optional): exact name of the resource type (for example, “S3 Bucket”) `page` (optional; defaults to `1`) `page_size` (optional; defaults to `25`)	List resources, optionally filtered by type.
`fetch_resource_details`	`read_only`	`resource_id`	Return full details for a specific resource.
`fetch_resource_actions`	`read_only`	`resource_id`	Return the list of actions for the given resource available to the current user, along with each action’s parameter schema.
`fetch_resource_action_parameter_options`	`read_only`	`action_id`: action global ID (for example, “RSA-abc12345”) `parameter_name`: name of the parameter from the `fetch_resource_actions` schema `resource_ids`: list of resource global IDs the action will run on `current_values`: dictionary of provided parameter values; required when fetching options for a parameter that depends on another	Return available options for a specific resource action parameter.
`run_resource_action`	`write`	`resource_ids`: list of resource global IDs (for example, “RSC-abc12345”) `action_id`: action global ID returned by `fetch_resource_actions` (for example, “RSA-abc12345”) `parameters`: dictionary of parameter values keyed by the parameter name from the `fetch_resource_actions` schema	Run a resource action on one or more resources.

Jobs

Tool	Safety	Parameters	Description
`fetch_running_jobs`	`read_only`	None	List all jobs in a RUNNING state for the authenticated user. Use this to monitor async operations.
`fetch_job`	`read_only`	`job_id`: job global ID (for example, “JOB-abc12345”)	Return the current status and details for a specific job.

Orders

Actions that require approval create an order. Use these tools to find orders, check their status, and act on orders awaiting approval.

Example prompts and workflows