Sonic Match MCP

Findings (1)

• lowLow. Minor, or common in normal tools. Shown for information.
  Reads environment variables not listed in the manifest

  SONICMATCH_CACHE_DIR, SONICMATCH_ERROR_LOG, SONICMATCH_GATE_HOST, SONICMATCH_HOSTED_DB

Network activity

Tools exposed (12)

• status

  Show ffmpeg/yt-dlp availability and which music adapters have keys.

• ingest_video

  Ingest a local video path or public http(s) URL. Accepts a filesystem path or an HTTPS video URL. YouTube/TikTok/Instagram via yt-dlp is OFF unless SONICMATCH_ALLOW_YTDLP=1 (ToS + extractor risk). Rejects file://, http, loopback, and private IPs (SSRF). Size-capped. Extracts durati

• analyze_video_music

  Produce a structured VideoSonic profile for BGM matching. platform_hint: instagram_story | instagram_reel | tiktok | youtube_short | youtube_long | generic. Uses Gemini video understanding when GEMINI_API_KEY is set; otherwise local ffmpeg/audio heuristics (and optional faster-whis

• recommend_bgm

  Rank license-safe BGM. Pass asset_id and/or a VideoSonic profile. Defaults instrumental_only=True when speech_coverage > 0.25. catalog: auto | seed | jamendo | freesound | library auto = seed always, plus Jamendo/Freesound/user-library when configured. Each recommendation includes

• search_music

  Free-text search over seed + optional Jamendo / Freesound / user library.

• get_track

  Return one track's metadata, license string, attribution text, and URLs.

• preview_mix

  Mix BGM under the video: hook trim, loop if needed, optional speech ducking. Returns preview mp3 + low-res mp4 paths, the ffmpeg command, and a mix_spec JSON an editor (CapCut / Premiere / DaVinci / your agent) can re-apply. Ducking uses ffmpeg sidechaincompress when the video has spee

• export_mix_spec

  Export the mix spec + ffmpeg recipe + attribution without requiring a render. This is the editor companion output (CapCut / Premiere / DaVinci / agent). Set render=true to also write preview files (same as preview_mix).

• suggest_cuts

  Snap detected scene cuts onto a beat grid. Returns EDL-ish spans and intro/peak/outro acts. bpm defaults to the VideoSonic suggested_bpm midpoint, or the track BPM if track_id is set.

• generate_bed

  Generate a bed when the catalog misses. Always marked source=generated. Refuses unless i_understand_not_commercially_cleared=true. Local fallback is a sine-tremolo demo. NOT cleared for ads. Check Suno/Stable Audio/Lyria terms before swapping in a real generator. Generated tracks are ex

• save_brand_kit

  Save a brand kit (BPM lock + no vocals + mood whitelist). Pass brand_kit=name to recommend_bgm.

• analyze_batch

  Analyze up to 20 clips, cluster moods, return one consistent mini-playlist for the series.