Sonicmatch MCP Server

Video-native MCP server for license-safe BGM. Watches the footage - not the script - and returns a shortlist, a 12–20s hook, and an ffmpeg ducking spec. Its 11 documented tools cover video, analyze, music, mix.

People who work with video, analyze and music and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-16 · ★ 39 · #119 OF 173 MAINTAINED MEDIA · VERIFIED 2026-09-18

MIT · Python servers · how we verify → /methodology

01 · Install Sonicmatch

before you install - you'll need

Set JAMENDO_CLIENT_ID, FREESOUND_API_KEY before connecting. GEMINI_API_KEY is optional or environment-specific per the README.

Claude Desktop

Settings → Extensions → Install, then select the https://github.com/js713-lab/sonic-match-mcp/releases/download/v0.2.0/sonicmatch-mcp-0.2.0.mcpb .mcpb bundle

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as Claude Desktop extension (.mcpb bundle)

repo age created 2026-09-10 - young repo, little track record yet

license MIT - declared in the repository

registry namespace io.github.js713-lab is GitHub-verified and matches the repo owner

03 · What Sonicmatch can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 11 documented tools spanning video, analyze, music, mix, including ingest_video, analyze_video_music, recommend_bgm, search_music.

Capability map

Tools grouped from the project's README - what Sonicmatch lets an agent do.

Analyze

2 tools - e.g. Mood, energy curve, speech, scenes, hook window, BPM, search queries; Up to 20 clips → mood cluster + shared mini-playlist

analyze_video_music · analyze_batch

read & search

2 tools - e.g. Free-text / BPM / mood over seed + optional catalogs; One track’s metadata, license, attribution, URLs

search_music · get_track

Ingest

1 tool - e.g. Local path or HTTPS URL → asset_id (never video bytes). Platform URLs need SONICMATCH_ALLOW_YTDLP=1

ingest_video

Recommend

1 tool - e.g. 3–7 ranked tracks + why + license + hook in/out

recommend_bgm

Preview

1 tool - e.g. Hook trim, loop, optional ducking → preview files + ffmpeg + mix spec

preview_mix

Export

1 tool - e.g. Mix spec + ffmpeg + attribution (no render unless render=true)

export_mix_spec

Suggest

1 tool - e.g. Beat grid, snapped scene cuts, EDL, intro / peak / outro

suggest_cuts

Generate

1 tool - e.g. Demo bed marked source=generated. Requires i_understand_not_commercially_cleared=true

generate_bed

Latest releases

v0.2.0 · 2026-09-10

First public release. MCP Registry package is the .mcpb attached to this release. · Install from source: pip install git+

04 · Who maintains Sonicmatch

Sonicmatch is maintained by js713-lab. We track 2 MCP servers from js713-lab - 2 actively maintained, 41 combined GitHub stars, oldest repo from Aug 2026. Full record: all servers from js713-lab.

  1. iCloud Drive Docs Read-only MCP server for listing, searching, downloading, and reading iCloud Drive documents. ★ 2

05 · Facts

category
media - ranked #119 of 173 actively-maintained media servers as of 2026-09-18.
release cadence
1 release in the last 90 days (latest 2026-09-10)
registry
io.github.js713-lab/sonicmatch-mcp (active, first published 2026-09-10)
packages
mcpb:https://github.com/js713-lab/sonic-match-mcp/releases/download/v0.2.0/sonicmatch-mcp-0.2.0.mcpb

06 · Sonicmatch FAQ

Is Sonicmatch still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-16 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can Sonicmatch do?

An agent gets 11 documented tools spanning video, analyze, music, mix, including ingest_video, analyze_video_music, recommend_bgm, search_music.

07 · Alternatives to Sonicmatch