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.
- Add https://prefect.fastmcp.app/mcp to a compatible remote client, or follow the publisher’s local uvx setup for self-hosted Prefect.
- Authorize only the intended Cloud workspaces; for local use confirm the profile and PREFECT_API_URL.
- Inspect get_identity and the tool list before requesting sensitive logs or enabling any experimental capability.
- 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.
https://github.com/PrefectHQ/prefect-mcp-server/blob/48efd289bdb2b94a78e35b1331fbefc4fa3f6411/README.md
Supports: summary, upstreamDescription, whySelected, bestFor, install, compatibility, transports, limitations, access, review, configExample
https://github.com/PrefectHQ/prefect-mcp-server/blob/48efd289bdb2b94a78e35b1331fbefc4fa3f6411/LICENSE
Supports: license, access.cost
https://github.com/PrefectHQ/prefect-mcp-server/blob/48efd289bdb2b94a78e35b1331fbefc4fa3f6411/src/prefect_mcp_server/settings.py
Supports: review, limitations, access
https://github.com/PrefectHQ/prefect-mcp-server/blob/48efd289bdb2b94a78e35b1331fbefc4fa3f6411/src/prefect_mcp_server/server.py
Supports: review, limitations