Flyworks-AI/flyworks-mcp
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