1
Open Claude Desktop config
Launch Claude Desktop and open the local MCP server configuration.
Pricing
30% OFF
Login
Turn
Claudeinto a music video engine
Connect freebeat to Claude, Cursor, Windsurf, Claude Code, and generate music videos and AI effects right from your conversations.
Claude Desktop
2
Add the freebeat MCP server
Name it freebeat and add the local MCP server command:
3
Set FREEBEAT_API_KEY
Create an API Key in freebeat, add it to the MCP environment, then ask Claude to start a music video task.
THE COMMAND SET
auth
Save and inspect your freebeat API key locally, or pass --api-key per command when needed.
set-api-keyshow--api-key
assets
Upload audio from a local file or source URL, and upload one or two reference images.
upload-audioupload-imagemusic_id
effects
List available video effects and inspect effect_id, preview media, default music, and aspect ratios.
listeffect_idpreview
mv
Submit or run AI music video generation from an uploaded song, prompt, references, and aspect ratio.
submitrun--json
effect
Generate effect-template clips with an effect_id, music_id, image URL, and prompt.
submitruneffect_id
task
Check status, wait for completion, and fetch video_url and cover_url from completed tasks.
statuswaitresult
A COMPLETE MUSIC VIDEO STUDIO INSIDE CLAUDE
Music video generation, AI effects, media upload, and task management in a single connection
Terminal
> Generate a neon city music video for this track
--aspect 9:16
--reference cover.png
● freebeat
Uploading audio...
Creating music video task...
→ ./output/neon_mv.mp4
GENERATIVE MEDIA
MUSIC VIDEO GENERATION
Start from a song, prompt, or music link and let your agent call freebeat to generate a complete MV with aspect ratios, references, effects, and async render results.
EFFECT ENGINE
ONE PROMPT TURNS MUSIC INTO SHORTS
Ask your agent to find the right video effect, fill in music, reference images, and prompts, then generate publish-ready clips for campaigns and social media.
Agent
> Find effects for a product launch teaser
● freebeat
Found 8 matching effects.
Generating 3 video variants...
✓ vertical teaser
✓ square social clip
Modes
upload_audio Import audio or source URL
upload_image Add one or two references
list_effects Inspect effect_id options
generate_music_video Start an MV task
generate_effect Start an effect task
get_task_status Poll task status
get_task_result Fetch video_url + cover_url
MODES
PICK AN EFFECT, SKIP THE SETUP
Start from effect_id, default music, recommended references, and template instructions. Your agent can compare templates before generating.
AUTOMATION
FROM SONG FOLDER TO VIDEO PIPELINE
CLI and MCP share one task model. Use Claude for creative planning, then batch upload, generate, wait, and save structured JSON from terminal scripts.
Terminal
> Build 5 music videos from ./songs
● freebeat
Reading folder...
Submitting jobs...
✓ 5 task ids saved
✓ results.json ready
A COMPLETE MUSIC VIDEO STUDIO INSIDE YOUR AGENT
Audio upload, image references, effect templates, and render results in a single MCP connection
FROM CONCEPT TO CONTENT IN ONE CONVERSATION
Tell Claude what you are making. It picks the right freebeat MCP tools and delivers production-ready music video results
ARTIST RELEASES
Upload a finished track, select a visual direction, and generate release-ready vertical or widescreen videos.
SOCIAL MEDIA & CONTENT CREATION
Turn one song into multiple shorts, hooks, visual loops, and template-driven effect clips.
MARKETING TEAMS
Generate product teasers and campaign variations from a song, a reference image, and a short brief.
AUTOMATION SCRIPTS
Use the CLI for repeatable batches, local folders, JSON output, and scheduled content pipelines.
FROM IDEA TO MUSIC VIDEO IN ONE CONVERSATION
Start small with one generation, or go deep with effect discovery, references, batch jobs, and task polling. Claude handles the workflow
Submit one music video task in seconds
Describe the mood, aspect ratio, and music source. Claude chooses the freebeat MCP tool and returns the task_id.
Generate a 9:16 cyberpunk MV for this track
Build a release package from a conversation
Create a hero MV, a square cut, and short variations while keeping the same visual direction.
Make three social cuts and save all video links
Compare effects and ship the best result
List freebeat effects, generate variants, wait for completion, and choose the strongest output.
Try 4 effects and show me the completed videos
GOT ANY QUESTIONS LEFT?
We have answered the most frequently asked questions
How does freebeat connect to AI agents?
Add the freebeat MCP server to any MCP-compatible client. The command is npx -y freebeat-mcp, authorized with the FREEBEAT_API_KEY environment variable.
Where do I create an API key?
Sign in to freebeat and open /music-video-generator/profile. Create a key in the API Keys section. The API Keys link on this page points there.
Which agents are supported?
Claude Desktop, Cursor, Windsurf, Claude Code, and other MCP-compatible clients can use the same freebeat server config.
What is the difference between MCP and CLI?
MCP is for agent conversations. CLI is for terminals and scripts. Both expose uploads, effects, generation, polling, and result retrieval.
Why do generation jobs require polling?
Music video rendering can take time. freebeat returns a task_id first, then the agent or CLI polls status and fetches video_url when complete.
What can I create?
You can create music videos, effect-template clips, vertical social videos, widescreen MVs, and style-guided versions using reference images.
Do I need to put my API key in prompts?
No. Keep the key in your MCP environment config or CLI credentials. Your prompt should only describe the creative task.
Can I use the result in automation?
Yes. Completed tasks return structured links and status fields that work well with JSON files, spreadsheets, content calendars, and scripts.
YOUR AI STACK JUST LEVELED UP
Connect Claude, Cursor, Windsurf, or Claude Code to freebeat in seconds. Music videos, AI effects, and render results on demand.
Get startedEXPLORE MORE AI FEATURES
Products
RANDOM MOTION TECHNOLOGY INC
3529 Old Conejo Road, Newbury Park, CA 91320