Freebeat MCP server

Read from the package source without running it. The installed server may list more.

• generate_effect

  Start AI effect generation from an effect template, a music_id, and exactly one reference image URL. Recommended flow: list_effects -> optional upload_audio -> optional upload_image -> generate_effect -> get_task_status -> get_task_result. By default, use list_effects.image_url. You can also use a single uploaded image URL from upload_image. Only call get_task_result after get_task_status returns

• generate_music_video

  Start AI music video generation from a music_id returned by upload_audio. Recommended flow: upload_audio -> optional upload_image -> generate_music_video -> get_task_status -> get_task_result. Only call get_task_result after get_task_status returns completed.

• get_task_result

  Retrieve the output for a completed Freebeat task. Only call after get_task_status returns completed. Current supported completed MV and effect results return result.video_url and result.cover_url. If the task is still pending or running, this tool returns TASK_NOT_COMPLETED. If the task failed, this tool surfaces the backend failure.

• get_task_status

  Check asynchronous Freebeat task status. Backends may return lowercase status values such as pending, completed, and failed, or legacy uppercase variants. Continue polling until the task reaches a terminal state. Only call get_task_result after status is completed.

• list_effects

  List supported effects with the metadata needed to select an effect and create an effect task. Each effect includes a default image_url and default_music_id you can use directly.

• upload_audiowrite action

  Upload a local audio file or import from a supported music URL. Supported platforms: SoundCloud, YouTube, Suno, Udio, TikTok, Stable Audio, and Riffusion. Provide exactly one of file_path or url. Returns a music_id for generate_music_video or generate_effect.

• upload_imagewrite action

  Upload one or two image files (PNG/JPG/JPEG, max 10MB each) for Freebeat workflows. Use returned image_urls in generate_music_video.reference_image_urls, or pass a single uploaded image URL to generate_effect.reference_image_urls to replace the default list_effects.image_url.

• Code scan51 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancerepository not readable: repo not found3/15
• Maintainer identityno repository or website to verify2/10

Safety score

55/100

higher than 10% of 48,255 servers

Tools

7

the typical server has 7

Tools that change things

29%

typical: 0%. Fewer write tools means less an agent can break

Downloads a week

106

more than 64% of 12,191 servers with a package

Freebeat MCP: common questions

Is Freebeat MCP server safe?

With care: it is graded C, so read the findings first (55/100). Read the Freebeat MCP safety report

How do I install Freebeat MCP?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Freebeat MCP need an API key?

Yes. The registry entry asks for FREEBEAT_API_KEY.

Is Freebeat MCP maintained?

The latest release is v0.1.1.

How does Freebeat MCP compare with other MCP servers?

safety score 55/100 (higher than 10% of 48,255 servers); tools 7 (the typical server has 7); tools that change things 29% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.