Skip to content

Summary

Prefect's official read-only MCP server for inspecting flow runs, deployments and automations on Prefect Cloud or self-hosted, with a docs proxy for current CLI and SDK guidance.

Features

  • Read-only inspection of flow runs, deployments, work pools and automations
  • Works against Prefect Cloud and self-hosted Prefect instances
  • Docs proxy for current Prefect CLI, SDK, deployment guidance and release notes
  • Claude Code and Codex plugins backed by hosted Prefect Cloud OAuth, with workspace selection
  • Local uvx stdio server inherits the active ~/.prefect/profiles.toml profile

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it.
  3. Restart the agent — the "Prefect" tools will be available.
{
  "mcpServers": {
    "prefect-mcp": {
      "command": "uvx",
      "args": [
        "prefect-mcp"
      ]
    }
  }
}

Description

Prefect's MCP server is deliberately narrow: it is read-only. An agent can inspect flow runs, deployments, work pools and automations on Prefect Cloud or a self-hosted instance, but it cannot trigger, pause or delete anything. For a workflow orchestrator that is the right default — the failure mode you want to avoid is an agent "fixing" a stuck run by re-triggering a pipeline that writes to production.

What it is genuinely good at is debugging. The agent reads the run graph, the task states, the logs and the automation that fired, and reasons about why a deployment failed with the same information a human would open the UI to get. Alongside that sits a documentation proxy, so the assistant looks up current Prefect CLI, SDK and deployment guidance and release notes rather than reciting an API shape from two versions ago.

Setup depends on where Prefect lives. Claude Code and Codex both have a plugin (/plugin marketplace add prefecthq/prefect-mcp-server, then /plugin install prefect) that connects to Prefect's hosted read-only server over Prefect Cloud OAuth, with workspace selection during install; because the bundle points at a hosted URL rather than launching a local process, the same plugin works for Claude Tag and Cowork. A local stdio server runs via uvx prefect-mcp and inherits credentials from the active profile in ~/.prefect/profiles.toml, which is the path for self-hosted Prefect or an explicit workspace. Teams can also deploy it over HTTP with per-request credential headers for a shared server.

It is MIT licensed and the maintainers label it experimental and under active development — APIs and behaviours can change without notice, so pin the version if you depend on it.

Related MCP Servers

Astronomer's MCP server for Apache Airflow: 30+ tools over the Airflow REST API, with consolidated helpers that explore a DAG, diagnose a failed run or summarise system health in a single call. Works with Airflow 2.x and 3.x.

Featured

The official W&B MCP server: query experiment runs, Weave LLM traces, artifacts and registries in natural language, and write findings back as a W&B report.

MCP: Couchbase Guru

by Couchbase

Couchbase's documentation agent as a single MCP tool: ask a question about any Couchbase product, SDK or version and get an answer with source links. No cluster and no credentials.

Fivetran's own MCP server exposes the Fivetran REST API to agents as discoverable tools, so an assistant can check sync status, inspect connections and destinations, and trigger syncs from chat.

Browse all MCP servers →