The Prefect MCP Server enables AI assistants to interact with Prefect's workflow orchestration platform through natural language via the Model Context Protocol (MCP), providing comprehensive management and monitoring capabilities through 45+ API endpoints.
Core Capabilities:
Flow Management: List, filter, view, and delete flows; query flow runs with extensive filtering (state, deployment, tags, time ranges); control flow run lifecycle (create, restart, cancel, delete, set states); retrieve flow run details and logs
Deployment Operations: List, filter, view, update, and delete deployments; create flow runs from deployments with custom parameters, names, tags, and idempotency keys; manage deployment schedules (view, set cron/interval-based schedules, pause, resume); configure work queue assignments
Task Run Monitoring: List and filter task runs by name, state, tags, and time ranges; retrieve task run details and logs; query task runs by flow run; manually set task run states with optional messages
Work Queue Operations: Create, list, update, pause, resume, and delete work queues; manage concurrency limits and configuration; filter by name or paused status
Variable Management: Create, read, update, and delete variables with support for string, dict, list, or other JSON-serializable values; manage variable tags; filter by name with pagination
Block Management: List available block types with slug-based filtering; retrieve block type schemas; query, retrieve, and delete block documents (configuration instances)
Workspace Management: List accessible workspaces; get current workspace context; retrieve workspace details by ID or handle
Artifact Management: Perform CRUD operations on Prefect artifacts
Automation Control: Create, view, update, delete, pause, and resume automations
System Monitoring: Check Prefect server health status and connectivity; create and retrieve logs for debugging
Key Features: Comprehensive filtering on most operations (tags, names, states, dates), pagination support with limit/offset, UUID-based precise resource targeting, tag-based organization, and state management with custom messages.
Allows AI assistants to interact with Prefect through natural language, providing access to flow management, flow run management, deployment management, task run monitoring, work queue management, block management, variable management, and workspace information.
Deprecated 27-Nov-2025
I've personally moved my efforts to a more generic OpenAPI spec based MCP: https://github.com/allen-munsch/yas-mcp
Additionally, there is actually an official beta release by prefect over here: https://pypi.org/project/prefect-mcp/
Prefect MCP Server
A Model Context Protocol (MCP) server implementation for Prefect, enabling AI assistants to interact with Prefect through natural language.
Note: The official Prefect MCP server is available here. This is a community implementation.
🚀 Quick Start
Related MCP server: n8n MCP Server
📦 Installation
pip Installation
From Source
Manual Run
🛠️ Features
💬 Example Interactions
AI assistants can help you with:
Flow Management
"Show me all my flows and their last run status"
"Create a new flow run for the 'data-processing' deployment"
"What's the current status of flow run 'abc-123'?"
Deployment Control
"Pause the schedule for the 'daily-reporting' deployment"
"Update the 'etl-pipeline' deployment with new parameters"
Infrastructure Management
"List all work pools and their current status"
"Create a new work queue for high-priority jobs"
Variable & Configuration
"Create a variable called 'api_timeout' with value 300"
"Show me all variables containing 'config' in their name"
Monitoring & Debugging
"Get the logs for the last failed flow run"
"Show me all running task runs right now"
🤖 Platform Integration
Claude Desktop
Add to claude_desktop_config.json: