Prefect MCP Server

Instructions

Implementation Reference

• src/mcp_prefect/workspace.py:47-66 (handler)

  The 'get_current_workspace' tool handler function. Decorated with @mcp.tool, it uses the Prefect client to read the current workspace and returns its details as text content, with fallback for local instances.

  @mcp.tool
  async def get_current_workspace() -> List[Union[types.TextContent, types.ImageContent, types.EmbeddedResource]]:
      """
      Get the current workspace.
      
      Returns:
          Details of the current workspace
      """
      try:
          async with get_client() as client:
              workspace = await client.read_workspace()
              
              return [types.TextContent(type="text", text=str(workspace.dict()))]
      except Exception as e:
          # For local Prefect instances, workspace APIs may not be available
          return [types.TextContent(
              type="text",
              text="Workspaces are only available in Prefect Cloud. This appears to be a local Prefect instance."
          )]