cli

The Prefect CLI skill is an essential companion to the read-only MCP server, providing the necessary interface for executing mutations and lifecycle management tasks across your Prefect Cloud or OSS workspaces. Designed for AI agent workflows, this skill allows for programmatic control over deployments, flow runs, and automation policies. It is intended for DevOps engineers, data platform teams, and automated agents that need to perform write operations or remediation tasks when static analysis and observation are insufficient.

• Trigger deployments via flow-name/deployment-name patterns or specific UUIDs.

• Manage flow run lifecycles, including cancellation and deletion, using non-interactive flags.

• Create and update automation policies using structured JSON configurations.

• Interface with the Prefect API for advanced filtering, resource inspection, and state management.

• Supports batch operations and automated error handling through standard shell-based execution.

• Always utilize the --no-prompt flag for all CLI interactions to ensure non-interactive agent compatibility and prevent blocking operations.

• Use the get_flow_runs or get_deployments tools from the read-only MCP server first to obtain complete UUIDs, which are required for successful mutations.

• Prefer using the prefect api command with --data inputs for granular control and raw JSON outputs, ensuring results are machine-readable for downstream processing.

• Avoid relying on Rich table output, as terminal formatting can truncate critical IDs; pipe output through jq when possible.

• Ensure your environment is authenticated via ~/.prefect/profiles.toml or appropriate environment variables like PREFECT_API_URL and PREFECT_API_KEY before executing commands.

• This skill acts as the write-side partner to read-only diagnostic tools, enabling a complete feedback loop from observing a failing run to canceling or re-triggering it automatically.