flyworks-mcp MCP Server

The Flyworks MCP is a Model Context Protocol (MCP) server that provides a convenient interface for interacting with the Flyworks API. It facilitates fast and free lipsync video creation for a wide…

Local serverstdio

What is the flyworks-mcp Server?

flyworks-mcp is an MCP project maintained in the flyworks-ai/flyworks-mcp repository. The maintainer describes its purpose as “The Flyworks MCP is a Model Context Protocol (MCP) server that provides a convenient interface for interacting with the Flyworks API. It facilitates fast and…”. Read the project documentation for the complete scope.

Installation

The documented pypi package is flyworks-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares FLYWORKS_API_TOKEN, FLYWORKS_API_BASE_URL, FLYWORKS_MCP_BASE_PATH. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
avatar	Digital human avatar ID. Either this or avatar creation parameters must be provided.
avatar_video_url	URL of a video to create the avatar from.
avatar_image_url	URL of an image to create the avatar from.
avatar_video_file	Local path to a video file to create the avatar from.
avatar_image_file	Local path to an image file to create the avatar from.
audio_url	Remote URL of the audio file. One of audio_url or audio_file must be provided.
audio_file	Local path to the audio file. One of audio_url or audio_file must be provided.
title	Optional title for the created video.
async_mode	If true, returns task_id immediately. If false, waits for completion and downloads the video. Default is true.
output_path	Where to save the downloaded video if async_mode is false. Default is "output.mp4".
text	Text content to be spoken by the avatar. Required.
voice	Voice ID to use for text-to-speech. If not provided, a random voice will be selected automatically.

How to install the flyworks-mcp Server

{
  "mcpServers": {
    "flyworks": {
      "command": "uvx",
      "args": [
        "flyworks-mcp",
        "-y"
      ],
      "env": {
        "FLYWORKS_API_TOKEN": "YOUR_FLYWORKS_API_TOKEN",
        "FLYWORKS_API_BASE_URL": "https://hfw-api.hifly.cc/api/v2/hifly",
        "FLYWORKS_MCP_BASE_PATH": "/path/to/your/output/directory"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
FLYWORKS_API_TOKEN	Declared in the maintainer’s client configuration.	Check documentation
FLYWORKS_API_BASE_URL	Declared in the maintainer’s client configuration.	Check documentation
FLYWORKS_MCP_BASE_PATH	Declared in the maintainer’s client configuration.	Check documentation