← Explore all mcp servers

DATA AND ANALYTICS / Prefect

Prefect MCP

Inspects Prefect flow runs, deployments and logs with an optional proxy to current Prefect documentation.

“An MCP server for interacting with prefect resources.”

01 / THE REASONING

Why this made the selection.

  • Combines operational run context with current documentation lookup for investigation workflows.
  • Supports hosted workspace consent and local profiles for self-hosted or custom environments.
  • The pinned README is a read-only Prefect inspector for Cloud and self-hosted instances, plus a docs proxy.
  • The hosted OAuth path does not ask the client to paste an API key, and workspace tools stay inside the workspaces the user selected.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • README.md, pyproject.toml and LICENSE
  • src/prefect_mcp_server/server.py, __main__.py and settings.py
  • Published PyPI metadata
  • 2026-10-14 reread of retained pinned setup/configuration evidence for the specific operational details added in this batch.
  • README.md
  • LICENSE

Our findings

  • The reviewed setting defaults experimental execution plans off and gates the publishing tool; the broad README read-only description is qualified accordingly.
  • README distinguishes Cloud OAuth plugins from local profile inheritance and documents request-header precedence for team-operated servers. Experimental source capabilities remain separately qualified.
  • The README gives MCP clients read-only tools for Prefect Cloud and self-hosted Prefect, and a proxy for current CLI, SDK, and deployment docs.
  • The hosted plugin path uses Prefect Cloud OAuth, does not require a client API key, and limits workspace-scoped tools to the workspaces selected during consent.
  • Those hosted tools do not change Prefect state. The server is described as experimental.

Not established by this review

  • No MCP server or upstream package was installed or run.
  • No authenticated account, client handshake, query, write operation or security test was performed.
  • No authenticated session, installation, permission bypass or package-to-source parity test was performed.
  • The server was not started and its tools were not called.
  • A pin does not verify transitive dependencies.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Connect a server deliberately.

Upstream setup instructions ↗
  1. Add https://prefect.fastmcp.app/mcp to a compatible remote client, or follow the publisher’s local uvx setup for self-hosted Prefect.
  2. Authorize only the intended Cloud workspaces; for local use confirm the profile and PREFECT_API_URL.
  3. Inspect get_identity and the tool list before requesting sensitive logs or enabling any experimental capability.
  4. The README gives per-client commands (claude, codex and gemini mcp add) rather than one installer, so this record shows no single command.

Before you start

  • Access to the target Prefect Cloud workspace or self-hosted instance
  • Python 3.10 or later and uv for the optional local path

Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

{
  "mcpServers": {
    "prefect": {
      "command": "uvx",
      "args": [
        "--from",
        "prefect-mcp",
        "prefect-mcp-server"
      ],
      "env": {
        "PREFECT_API_URL": "https://api.prefect.cloud/api/accounts/[ACCOUNT_ID]/workspaces/[WORKSPACE_ID]",
        "PREFECT_API_KEY": "your-api-key"
      }
    }
  }
}

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/PrefectHQ/prefect-mcp-server/blob/48efd289bdb2b94a78e35b1331fbefc4fa3f6411/README.md

    Supports: summary, upstreamDescription, whySelected, bestFor, install, compatibility, transports, limitations, access, review, configExample

  2. https://github.com/PrefectHQ/prefect-mcp-server/blob/48efd289bdb2b94a78e35b1331fbefc4fa3f6411/LICENSE

    Supports: license, access.cost

  3. https://github.com/PrefectHQ/prefect-mcp-server/blob/48efd289bdb2b94a78e35b1331fbefc4fa3f6411/src/prefect_mcp_server/settings.py

    Supports: review, limitations, access

  4. https://github.com/PrefectHQ/prefect-mcp-server/blob/48efd289bdb2b94a78e35b1331fbefc4fa3f6411/src/prefect_mcp_server/server.py

    Supports: review, limitations

Evidence & Ask