MCP App Store
by KeenEthics
Prefect icon

Prefect MCP Server for Claude and ChatGPT

By Prefect Technologies

Overview

Connect Prefect Cloud to inspect workflows, diagnose failed, late, or stuck runs, review workspace and worker health, and search current Prefect documentation and release notes. The hosted tools are read-only.

How to connect

  1. Claude: Open the Prefect listing in the Claude connectors directory and choose Connect. Claude listing Prefect exposes 15 tools here.
  2. ChatGPT: Open the Prefect listing in the ChatGPT app directory and choose Connect. ChatGPT listing Prefect exposes 15 tools here.

Tools

docs_get_release_notes

ChatGPT
Get 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

ChatGPT
Search Prefect documentation for concepts, examples, and best practices. For latest or version-specific Prefect OSS release notes, use get_release_notes instead.

get_automations

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get a schema for an object type.

get_task_runs

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
List 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

ChatGPT
Explain 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

ChatGPT
Read 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

Claude

docs_search_prefect

Claude

get_automations

Claude

get_dashboard

Claude

get_deployments

Claude

get_flow_run_logs

Claude

get_flow_runs

Claude

get_flows

Claude

get_identity

Claude

get_object_schema

Claude

get_task_runs

Claude

get_work_pools

Claude

list_authorized_workspaces

Claude

orientation

Claude

read_events

Claude

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/prefect"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/prefect)