Using the Deploy MCP tools
After you have successfully connected to the IBM DevOps Deploy (Deploy) MCP server, you can use the integrated Deploy MCP tools to perform tasks within Deploy.
You can access the following Deploy MCP tools
from your MCP client:
| Tools | Description | Input |
|---|---|---|
| list_applications | Lists all applications. | None |
| list_application_processes | Lists all processes defined in an application. | applicationId |
| list_application_environments | Lists the environments for a specific application. | applicationId |
| list_application_snapshots | Lists all snapshots defined in an application. | applicationId |
| get_deployment_status | Returns the application deployment status. | deploymentId |
| deploy_snapshot_to_environment | Deploys an application snapshot to an environment. | applicationId, snapshotId,
processId, environmentId |
| schedule_deployment | Schedule a deployment for future execution. | deploymentId |
| get_deployment_failed_status | Retrieves information about the failed steps in a deployment. | deploymentId |
| get_deployment_step_output | Retrieves information on a step in a deployment. | stepOutputTokenOpaque,
firstLineIndex |
| search_step_output_regex | Searches logs using regular expressions. | stepOutputTokenOpaque, pattern,
contextLineCount |
| search_step_output_hangs | Identifies long intervals (hangs) between output lines in step execution logs by analyzing timestamp information in the log format. Currently, this tool only checks for hangs within failed steps. |
Tip: You can retrieve a complete list of
all available tools directly from your MCP client. For specific instructions on how
to use your MCP client to view this list, refer to the independent software vendor
documentation.
The core functionality of the Deploy MCP tools
is accessed through the chat prompts within the MCP client interface. By using these
prompts, you can perform complex deployment tasks by using natural language. Examples of
the chat prompts that you can use are as follows:
- List my applications.
- List processes for the application
helloApplication. - Deploy
helloApplicationintodev_environment1. - Why did deployment
deployment_idfail?
Note: When crafting your prompts, you can reference objects
by their ID or name.
The AI agent interprets your chat prompts to intelligently select and run the appropriate
MCP tool to fulfill the request.
Important: The results
are highly dependent on the capabilities of the LLM that your MCP client uses, and
the results are non-deterministic.