Prefect MCP Server

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/prefecthq-prefect-mcp-server

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

16 read · 0 write · 0 deleteRead-only

Secrets

None asked for

Install scripts

None found

Runs as

Python package

Tools (16)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• get_automations

  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_dashboard

  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

  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_deployme…

• get_flow_run_logs

  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

  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(…

• get_flows

  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

  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

  Get a schema for an object type.

• get_release_notes

  Get authoritative, structured release notes for a Prefect OSS release. Accepts "latest" or an exact version and returns the release title, date, Markdown notes, and source URL.

• get_task_runs

  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": {"…

• get_work_pools

  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_": ["kubern…

• list_authorized_workspaces

  List Prefect Cloud workspaces selected during OAuth consent. Returns account handles, workspace handles, workspace IDs, and grant metadata for the workspaces available to this connection. Only available in Prefect Cloud OAuth mode.

• orientation

  Return an overview of Prefect MCP capabilities and access boundaries. Summarizes supported inspection, documentation, schema, and optional authoring capabilities. It does not access or modify Prefect data.

• read_events

  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_e…

• review_rate_limits

  Review rate limit usage for this Prefect Cloud account (Cloud only). Prefect Cloud API access is governed by rate limits in different categories (runs, deployments, flows, work_pools, writing-logs, etc.). When you see HTTP 429 errors or "Too Many Requests" responses from the Prefect API, use this tool to identify which operation groups were throttled and when. Queries all common rate limit operation groups and groups consecutive throttled minutes into periods, showing which operation groups were affected during each stretch. Note: These are not API authentication keys - they're categories o…

Signals

Weekly downloads

1,813

Last release

Sep 1, 2026 (1 month ago)

Last package publish

Sep 1, 2026 (1 month ago)

From the package registry.

Details

Registry name

io.github.PrefectHQ/prefect-mcp-server

Version

0.0.1-beta.13

Auth

No auth

Packages

pypi prefect-mcp

License

License unknown

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registry