About AINSOF
AINSOF is an MCP server that brings a catalog of human-made production music into AI assistants for video editors and creative teams. It supports searches by brief or reference and offers previews, picture scoring, video analysis, stems, and cue-sheet data.
Key features
- 01Search music by brief, mood, or track
- 02Match cues from reference links
- 03Listen to full-track previews
- 04Analyze video structure and pacing
- 05Cut music to length and sync to picture
- 06Retrieve versions, stems, and cue sheets
Use cases
- 01Find and audition music for a video edit
- 02Find catalog cues similar to a reference track
- 03Fit a cue to a precise duration and picture
- 04Collect writer and publisher details for used music
MCP support
This Streamable HTTP MCP server exposes catalog search, previews, video analysis and scoring, version and stem retrieval, and cue-sheet lookup through 14 tools. A key is not required to connect.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.ainsof.ioclaude mcp add --transport http io-ainsof https://mcp.ainsof.io{"mcpServers":{"io-ainsof":{"type":"http","url":"https://mcp.ainsof.io"}}}Open in Cursor{"servers":{"io-ainsof":{"type":"http","url":"https://mcp.ainsof.io"}}}Open in VS Code{"mcpServers":{"io-ainsof":{"type":"http","url":"https://mcp.ainsof.io"}}}{"mcpServers":{"io-ainsof":{"serverUrl":"https://mcp.ainsof.io"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
14| Parameter | Type | Required | Description |
|---|---|---|---|
| scope | enum | No | Optional library restriction; omit to let the request select the library.music | sfx |
| product | string | No | |
| description | string | Yes | Describe the video, mood or music wanted, in the user's language. Required; duration alone is insufficient. |
| cuts_per_min | number | No | edit pace, if known |
| duration_sec | number | Yes | the video's length in seconds |
| has_narration | boolean | No | true if anyone speaks over it |
Details
From the project README
AINSOF MCP Server
Original, human-made production music inside your AI assistant.
Search it by brief or by reference link, hear full previews, score it to your video,
analyze your edit, pull versions, stems and cue sheets, and clear it without leaving the tool you already work in.
ainsof.io · mcp.ainsof.io · browse the catalog
Endpoint: https://mcp.ainsof.io (Streamable HTTP, no key required)
AINSOF is a music superpowers creative company: a curated, growing production-music catalog built for sync, with purpose-made tools for connecting music to picture. Every cue is written, performed and produced by human composers; nothing in the catalog is AI-generated. New original music lands every week.
This server puts the whole catalog behind 14 MCP tools, so an AI assistant can find the right cue for a scene, play it, fetch stems and cut-downs, and even return a finished, professionally scored edit of your video.
Connect
Claude (claude.ai / Claude Desktop)
Settings → Connectors → Add custom connector → paste https://mcp.ainsof.io.
Claude Code
claude mcp add --transport http ainsof https://mcp.ainsof.io
Or install it as a plugin, which brings the connection and a working setup along with it:
/plugin marketplace add AINSOF-Tech/mcp
/plugin install ainsof
What's in the plugin
The connector on its own gives an assistant fourteen tools. The plugin adds the judgment around them: when to reach for music, which version fits a 22-second cut, and what to hand over when legal asks for paper.
| Skills | soundtrack | Teaches the assistant to offer music on its own the moment a video is edited, rendered or exported. It measures the cut, asks for the version that fits that exact length rather than a full track, shows three options instead of ten, and never implies a license that isn't there. |
setup | Connect and verify the server, raise the rate limit with a free key, and recognize the three replies that look like errors and aren't. | |
| Sub-agent | music-supervisor | Turns a brief into a defensible shortlist: several spots at once, each measured, searched from more than one angle, auditioned, ranked, with the trade-off named and the cue sheet attached. |
| Commands | /score-video | Measure a cut, find the music, and take it through to a finished score synced to picture. |
/find-music | Search the catalog by brief, mood, scene, composer or catalog number. | |
/match-reference | Paste a Spotify / YouTube / Apple Music / Deezer link and get the closest AINSOF cues, matched by sound. | |
/cue-sheet | Pull writers, splits, ISRC and publisher for a cue you used. |
So a video exported in your session gets a real shortlist without anyone having to remember to ask for one.
Cursor
Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"ainsof": { "url": "https://mcp.ainsof.io" }
}
}
Grok
Connectors → add a remote MCP connector with https://mcp.ainsof.io.
ChatGPT
Developer mode → Connectors → add https://mcp.ainsof.io.
What it can do
| Tool | What it does |
|---|---|
search_music | Find cues by a written brief, a mood, or an exact track / album / catalog number |
search_by_reference | Paste a Spotify / YouTube / Apple Music / Deezer link, or name a record, and get the closest AINSOF cues by sound. SoundCloud and TikTok links are not supported; give the artist and title instead |
find_similar | Find AINSOF cues that sound like an AINSOF cue, either the whole cue or a passage of it (5 to 60 seconds, such as the hook) |
find_soundtrack | Describe your video (length, pace, narration) and get cues that fit it |
score_my_video | Upload a video and get back a professionally scored edit, synced to picture |
analyze_video | Structural analysis of a video: cuts, pacing, sections |
fit_to_length | Cut a chosen cue to a length from 1 to 300 seconds the way an editor would: whole bars and the real ending, never stretched. Also exact video lengths, seamless loops and matching stems |
get_track | Full detail for one cue: versions, stems, metadata |
listen_link | A link to hear the complete preview of any cue |
get_upload_link / deliver_score | Move video in, get the scored result out |
cue_sheet | Cue-sheet data for anything you used |
about_ainsof | Licensing, catalog and privacy details |
feedback | Tell us when a result was right or wrong (with your consent) |
Previews are always the complete piece in clean MP3 192k, so you can cut with them before anything is licensed. Listening is free without sign-in. Downloading a version needs Google or email sign-in and an AINSOF account with download access, and a download is not a publication license.
In practice
A video editor, mid-edit. You're cutting a 45-second alpine ski clip in silence.
You tell your assistant: "fast cuts, no narration, score it." It calls
find_soundtrack with the length and pace, streams you three full previews, and the
one you keep comes back through score_my_video already synced to your cut.
A creative team pitching with a reference. The client says "something like Hans
Zimmer's Time." Paste the link. search_by_reference listens to the actual record
and answers with the closest cues in the AINSOF catalog, playable immediately and
licensable the same day.
An agency producer clearing a spot. The edit is locked and legal wants paper.
get_track returns every version and stem of the cue you used, cue_sheet returns
the cue-sheet data, and licensing is one email: every cue in the catalog is
pre-cleared, one owner, no chain-of-title archaeology.
A developer building a creative tool. Your users edit video in your product.
Point your agent at https://mcp.ainsof.io and music discovery (search,
reference matching, previews, scoring to picture) becomes a feature of your app,
with no key required to start.
Rate limits
| Tier | Calls / day |
|---|---|
| No key | 300 |
| With an API key | 1,000 |
| Need more? | [email protected] |
Keys are free: email [email protected]. Send one as a bearer token:
claude mcp add --transport http ainsof https://mcp.ainsof.io \
--header "Authorization: Bearer ain_live_…"
Licensing & privacy
The catalog itself is commercial: every cue is signed, owned and cleared, and licensing runs through ainsof.io. This repository contains the public server manifest and connection docs only, released under the MIT license (LICENSE); what that license does and does not cover is spelled out in NOTICE.
What the plugin sends, and where
The plugin contains no scripts or hooks. Its one network destination is the AINSOF
server at https://mcp.ainsof.io, reached only through the tool calls your
assistant makes. Those calls carry:
- Searches and briefs: the words of the brief, any reference link you paste, and the cue titles or track IDs you ask about.
- Videos: only a video you choose to analyze or score. A hosted file is passed
by its link; a file on your computer is uploaded through the page that
get_upload_linkreturns. - Feedback: sent through
feedbackonly after you agree, quoted in your own words.
Privacy: the server receives only the tool calls sent to it, never the rest of your
conversation. To understand a brief, AINSOF sends its words to AI services from
Google and TypeSafe, without your name, email, IP address or any video. AINSOF
records usage metrics (the tool used, the search sent, the cues returned, links
requested or opened, time, country, client app and a one-way pseudonymous caller
hash) and does not store your raw IP address in them. An uploaded video is deleted
once its scored files are stored, and rendered videos and delivery packages are
deleted after seven days. Storyboards, transcripts and a reduced review copy made
by analyze_video are kept for 30 days. To have your data deleted sooner, write to
[email protected]. Full policy: ainsof.io/privacy.html.
Contact
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.