docs_get_release_notes
ChatGPTGet authoritative, structured release notes for a Prefect OSS release. Use this for questions like "what changed in the latest Prefect release?" instead of semantic documentation search.
docs_search_prefect
ChatGPTSearch Prefect documentation for concepts, examples, and best practices. For latest or version-specific Prefect OSS release notes, use get_release_notes instead.
get_automations
ChatGPTGet automations with optional filters. Returns compact summaries by default (trigger_type, action_count). Filter by specific ID(s) for full detail including trigger config, actions, actions_on_trigger, and actions_on_resolve. Filter operators: - id.any_: Match specific automation IDs - name.any_: Match automation names - enabled.eq_: Filter by enabled state Examples: - List all automations: get_automations() - Full detail: get_automations(filter={"id": {"any_": ["<automation-id>"]}}) - Get by name: get_automations(filter={"name": {"any_": ["my-automation"]}}) - Only enabled: get_automations(filter={"enabled": {"eq_": True}})
get_dashboard
ChatGPTGet a high-level dashboard overview of the Prefect instance. Returns current flow run statistics, work pool status, and all active concurrency limits (global/tag-based, deployment, work pool, and work queue). Essential for diagnosing flow run delays and bottlenecks.
get_deployments
ChatGPTGet deployments with optional filters. Returns compact summaries by default. Filter by specific ID(s) for full detail including parameters, parameter_openapi_schema, job_variables, work_pool details, and recent_runs. Filter operators: - any_: Match any value in list - all_: Match all values - like_: SQL LIKE pattern matching - not_any_: Exclude values - is_null_: Check for null/not null - eq_/ne_: Equality comparisons Examples: - List all deployments: get_deployments() - Full detail: get_deployments(filter={"id": {"any_": ["<deployment-id>"]}}) - Active deployments: get_deployments(filter={"paused": {"eq_": False}}) - Production deployments: get_deployments(filter={"tags": {"all_": ["production"]}})
get_flow_run_logs
ChatGPTGet execution logs for a flow run. Retrieves log entries from the flow run execution, including timestamps, log levels, and messages. Examples: - Get logs: get_flow_run_logs(flow_run_id="...") - Get more logs: get_flow_run_logs(flow_run_id="...", limit=500)
get_flow_runs
ChatGPTGet flow runs with optional filters. Returns compact summaries by default. Filter by specific ID(s) for full detail including parameters, inlined deployment info, and work pool info. Filter operators: - any_: Match any value in list - all_: Match all values - like_: SQL LIKE pattern matching - not_any_: Exclude values - is_null_: Check for null/not null - after_/before_: Time comparisons - gt_/gte_/lt_/lte_: Numeric comparisons Examples: - List recent runs: get_flow_runs() - Get specific run: get_flow_runs(filter={"id": {"any_": ["<flow-run-id>"]}}) - Failed runs: get_flow_runs(filter={"state": {"type": {"any_": ["FAILED"]}}}) - Production runs: get_flow_runs(filter={"tags": {"all_": ["production"]}})
get_flows
ChatGPTGet flows with optional filters. Returns a list of flows registered in the workspace. Filter operators: - any_: Match any value in list - like_: SQL LIKE pattern matching - all_: Match all values Examples: - List all flows: get_flows() - Get specific flow: get_flows(filter={"id": {"any_": ["<flow-id>"]}}) - Flows by name pattern: get_flows(filter={"name": {"like_": "etl-%"}}) - Flows by tags: get_flows(filter={"tags": {"all_": ["production"]}})
get_identity
ChatGPTGet identity and connection information for the current Prefect instance. Returns API URL, type (cloud/oss), and user information if available. Essential for understanding which Prefect instance you're connected to.
get_object_schema
ChatGPTGet a schema for an object type.
get_task_runs
ChatGPTGet task runs with optional filters. Returns a list of task runs and their details matching the filters. Note that 'task_inputs' contains dependency tracking information (upstream task relationships), not the actual parameter values passed to the task. Filter operators: - any_: Match any value in list - like_: SQL LIKE pattern matching - not_any_: Exclude values - is_null_: Check for null/not null Examples: - List recent tasks: get_task_runs() - Get specific task: get_task_runs(filter={"id": {"any_": ["<task-run-id>"]}}) - Failed tasks: get_task_runs(filter={"state": {"type": {"any_": ["FAILED"]}}}) - Tasks by pattern: get_task_runs(filter={"name": {"like_": "%process%"}})
get_work_pools
ChatGPTGet work pools with optional filters. Returns compact summaries by default (name, type, status, concurrency_limit). Filter by specific ID(s) for full detail including work queues, active worker counts, and descriptions. Essential for debugging deployment issues related to flow runs being stuck or not starting. Filter operators: - any_: Match any value in list - like_: SQL LIKE pattern matching Examples: - List all pools: get_work_pools() - Full detail: get_work_pools(filter={"id": {"any_": ["<work-pool-id>"]}}) - Kubernetes pools: get_work_pools(filter={"type": {"any_": ["kubernetes"]}})
list_authorized_workspaces
ChatGPTList Prefect Cloud workspaces selected during OAuth consent. This tool is only available when the server is running in Prefect Cloud OAuth mode. Use it before calling workspace-scoped tools when the user names a workspace by handle, account/workspace pair, or nickname.
orientation
ChatGPTExplain which Prefect MCP tool to use for common Prefect operations. Covers workspace inspection, failure diagnosis, documentation, release notes, object schemas, and the separately gated execution-plan authoring tools. Returns routing guidance only and does not access or modify Prefect data.
read_events
ChatGPTRead and filter events from the Prefect instance. Provides a structured view of events with filtering capabilities. Note: When no time range is specified, events from the last 1 hour are returned by default. Use occurred_after/occurred_before parameters to query a different time range. Common event type prefixes: - prefect.flow-run: Flow run lifecycle events - prefect.deployment: Deployment-related events - prefect.work-queue: Work queue events - prefect.agent: Agent events Examples: - Recent flow run events: read_events(event_type_prefix="prefect.flow-run") - Last 24 hours: read_events(occurred_after="<ISO8601-timestamp-24-hours-ago>") - Specific time range: read_events(occurred_after="2024-01-01T00:00:00Z", occurred_before="2024-01-02T00:00:00Z")
docs_get_release_notes
Claudedocs_search_prefect
Claudeget_automations
Claudeget_dashboard
Claudeget_deployments
Claudeget_flow_run_logs
Claudeget_flow_runs
Claudeget_flows
Claudeget_identity
Claudeget_object_schema
Claudeget_task_runs
Claudeget_work_pools
Claudelist_authorized_workspaces
Claudeorientation
Clauderead_events
Claude