AINSOF MCP server
Commit Nov 5, 2026Lets an AI assistant search a production music catalog, match music to video references, and generate professionally scored video edits.
Also known as AINSOF-Tech/mcp, mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.8
- Last commit
- Nov 5, 2026
- License
- MIT
What is AINSOF MCP?
AINSOF lets an AI assistant search a production music catalog, match music to video references, and generate professionally scored video edits.
Summary generated from the project's README
About AINSOF MCP server
AINSOF provides an MCP server that connects AI assistants to a curated catalog of human-made production music. Designed for video editors, creative teams, and developers, the server enables users to find music through written briefs, moods, or external reference links from platforms like Spotify and YouTube. It functions as a remote service via a streamable HTTP endpoint, requiring no initial key, though users can increase daily call limits from 300 to 1,000 by providing a free API key.
The system includes sixteen specialized tools that allow an assistant to perform complex tasks like analyzing video pacing, matching music to specific scene lengths, and retrieving stems or cue sheets. While searching and listening to previews is free, downloading tracks or using video tools requires an AINSOF account. The server supports various clients including Claude Desktop, Claude Code, Cursor, Grok, and ChatGPT, offering a way to integrate professional music supervision directly into existing creative workflows.
What you can do with it
- 1Score a video automaticallyAn editor can provide a video link to have the assistant find music and return a finished, synced edit.
- 2Match music by referenceUsers can paste a link to a song on YouTube or Spotify to find the most similar tracks in the catalog.
- 3Generate professional cue sheetsProducers can instantly retrieve metadata like ISRC and publisher information for legal clearance.
- 4Find music by briefA creative can describe a scene's mood or pace to receive a tailored shortlist of musical options.
Written from the project's README. Every use case is checked against a quote from it.
How to install AINSOF MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall AINSOF MCP in Claude Code
$ claude mcp add --transport http mcp https://mcp.ainsof.io/Install AINSOF MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.ainsof.io/"
}
}
}Install AINSOF MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.ainsof.io/"
}
}
}Install AINSOF MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.ainsof.io/"}'Install AINSOF MCP in Codex
$ codex mcp add mcp --url https://mcp.ainsof.io/Install AINSOF MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.ainsof.io/"
Install AINSOF MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp https://mcp.ainsof.io/Install AINSOF MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.ainsof.io/",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableainsof-tech/mcp is public and reachablegithub.com/ainsof-tech/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-05github.com/ainsof-tech/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 1002 msPass
README
View on GitHubEndpoint: https://mcp.ainsof.io (Streamable HTTP, no key required to start; the video tools ask the person to sign in once on ainsof.io)
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 16 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)
Customize → Connectors → + Add → Add custom connector → paste https://mcp.ainsof.io.
Works on every plan; Free accounts can add one custom connector. On Team and Enterprise an owner adds it for the workspace.
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 sixteen 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
AINSOF is an official app in ChatGPT: open AINSOF in ChatGPT and add it. There is no address to paste.
Gemini
On gemini.google.com: Connected Apps → Custom apps for Spark → paste https://mcp.ainsof.io. Google currently limits custom apps to personal Google Accounts with Keep Activity on, in the US, in English, for users 18 and over.
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) |
browse_tag |
List the cues under one AINSOF genre, mood, instrument or use tag, in ranked order |
browse_playlist |
List the tracks of an AINSOF editorial playlist by its name, in the site's order |
find_soundtrack |
Describe your video (length, pace, narration) and get cues that fit it |
score_my_video |
Give it a video link and get back a professionally scored edit, synced to picture (a file on your computer goes up through get_upload_link first) |
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? | info@ainsof.io |
Keys are free: sign in at ainsof.io/account/api-keys and choose Create new key (shown once). Send it as a bearer token:
claude mcp add --transport http ainsof https://mcp.ainsof.io \
--header "Authorization: Bearer ain_…"
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
info@ainsof.io. Full policy: ainsof.io/privacy.html.
Contact
AINSOF MCP questions
How do I add AINSOF MCP to Claude Code?
Run claude mcp add --transport http mcp https://mcp.ainsof.io/ in your terminal. Add --scope user to make it available in every project.
How do I add AINSOF MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How can I search for music using a reference?
You can paste a Spotify, YouTube, Apple Music, or Deezer link to get the closest AINSOF cues matched by sound.
Can the AI score music to my video?
Yes, the server can measure a video cut, find suitable music, and return a finished, professionally scored edit synced to the picture.
Is the music in the catalog AI-generated?
No, every cue is written, performed, and produced by human composers.