flyworks-mcp

Flyworks-AI/flyworks-mcp

3.9

Flyworks MCP is a Model Context Protocol server for creating fast and free lipsync videos using digital avatars.

Tools

Functions exposed to the LLM to take actions

create_lipsync_video_by_audio

Create lipsync video by audio input. The tool will animate a digital human avatar to speak in sync with the provided audio.

Parameters:
- 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 false.
- output_path: Where to save the downloaded video if async_mode is false. Default is "output.mp4".

Avatar creation: Provide exactly ONE of avatar_video_url, avatar_image_url, avatar_video_file, or avatar_image_file to create a new avatar.
If avatar ID is directly provided, these parameters will be ignored.

Audio file should be mp3, m4a, or wav format, within 20MB, and between 1 second and 3 minutes.

Returns:
- If async_mode is true: task_id for checking status later
- If async_mode is false: downloaded video path and task result
- If download fails: error message, task_id, task_result, and video_url for manual download

create_lipsync_video_by_text

Create lipsync video by text input. The tool will generate audio from the text and animate a digital human avatar to speak it.

Parameters:
- 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.
- 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.
- 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 false.
- output_path: Where to save the downloaded video if async_mode is false. Default is "output.mp4".

Avatar creation: Provide exactly ONE of avatar_video_url, avatar_image_url, avatar_video_file, or avatar_image_file to create a new avatar.
If avatar ID is directly provided, these parameters will be ignored.

Text should be between 1 and 500 characters.

Returns:
- If async_mode is true: task_id for checking status later, selected voice ID
- If async_mode is false: downloaded video path, task result, and selected voice ID
- If download fails: error message, task_id, task_result, video_url, and selected voice ID for manual download

create_video_by_podcast

Create video by podcast HTML file. The tool will read a podcast HTML file and generate a video based on its content.

Parameters:
- podcast_html_url: Remote URL of the podcast HTML file.
- async_mode: If true, returns task_id immediately. If false, waits for completion and downloads the video. Default is false.
- output_path: Where to save the downloaded video if async_mode is false. Default is "output.mp4".

The podcast HTML file should contain structured content that can be processed to generate a video.

Returns:
- If async_mode is true: task_id for checking status later
- If async_mode is false: downloaded video path and task result
- If download fails: error message, task_id, task_result, and video_url for manual download

Prompts

Interactive templates invoked by user choice

No prompts

Resources

Contextual data attached and managed by the client

No resources