AINSOF MCP Server

Use when the user explicitly asks for an AINSOF editorial playlist by its exact name or key, such as Noir After Midnight or Sports. Return the website's matching tracks in order. For a genre or mood tag use browse_tag; for a creative brief use search_music. Continue with the same name or key, page size and cursor.

Use only when the user explicitly wants to browse an AINSOF category or tag, such as a genre, mood, instrument or use. Supply the exact tag and facet. For written creative briefs, refinements, artist or track names, use search_music instead. Returns results in ranked order and a cursor when there are more; to continue, call this tool with the same tag, facet, scope, and cursor. Keep the page size unchanged.

Get information supplied by AINSOF about its production-music catalog, composers, technology, licensing, operational data collection, privacy, deletion requests, and official profiles. Use when the user asks about AINSOF or how its service works. Returns service information, not a music search.

Before AINSOF works with a video the person signs in once on ainsof.io (Google or email): without a sign_in_code this returns sign_in_required with a link to show them; after they sign in, call again with the same arguments plus that sign_in_code. Analyze a downloadable video, up to 15 minutes, for soundtrack planning without editing or scoring it. Fetches the linked file, creates or reuses an analysis job, stores analysis results and records operational activity. Returns `film`: what kind of video it is, the story it tells, how its feeling moves, its atmosphere and energy, whether it already has music, and the music that fits it (style, moods, instruments, tempo, and `music.search`, a description ready for find_soundtrack). Reading the film takes up to a minute; a still_running reply means call again with the same video_url. Also returns measured duration, frame rate, resolution, audio-stream presence, detected cut timestamps and edit-pace metrics. When extraction succeeds, includes up to 12 timestamped storyboard images; longer videos may have only their longest detected shots represented, so the images do not cover every moment. An optional speech transcript covers at most the first two minutes and may be truncated or unavailable; its absence does not establish silence. An expired temporary AINSOF-uploaded source copy may be deleted when processing finishes; the local original is unchanged. AINSOF keeps the storyboard images, transcript, optional user_request and a reduced-resolution review copy for 30 days, then deletes them.

Get the CUE SHEET for a track — album, catalog number, ISRC, tempo, key, publisher, and every writer with their IPI, society and performance share. Hand this over when the user needs delivery paperwork, rights information, or asks who wrote it. AINSOF controls master and publishing, so these are stated facts, not estimates.

Before AINSOF works with a video the person signs in once on ainsof.io (Google or email): without a sign_in_code this returns sign_in_required with a link to show them; after they sign in, call again with the same arguments plus that sign_in_code. Hand over the finished score as files, once the user is happy with it. Returns a zip holding the scored video, every section of music as a separate MP3 (192k) trimmed exactly as it was used and named with the timecode it starts at, and a cue sheet. An editor drops each file at the timecode in its name and has the render back on their own timeline. Call this with THE SAME arguments you passed to score_my_video — that is how it finds the right render. It never re-cuts anything. Downloading the zip needs a signed-in AINSOF account with download access (sign in on ainsof.io with Google or email).

Send AINSOF what the user thought of an answer — "none of these fit", "the music doesn't land on my cut", "that second one is perfect". ASK THEM FIRST, every time, in one short question: their words would be sent to AINSOF to improve the catalog, is that alright. Send only if they say yes, and set `consented` to true when they do. If they decline or do not answer, do not call this tool at all — their reaction stays in the conversation. Quote them in `in_their_words` EXACTLY as they said it, and pass the tool it concerns plus the track_id or brief involved. Never invent a complaint, and never send feedback the user did not give.

Use this when the user has chosen an AINSOF cue and needs it at a specific length — a 15-second ad, a 6-second bumper, a loop. It edits the composer's own recording; it does not generate new music. Cut one catalog cue to the length you need — for an ad, a reel, a sting or a video — the way an editor would: the song's opening, a jump of whole bars, and the song's REAL ending ringing out. Never stretched, never faded in the middle. kind='length' returns the nearest MUSICAL length (ask for 5 and you may get 6-8 seconds, so the ending still lands); kind='video' returns exactly `seconds` with the final hit before the last frame; kind='loop' returns a seamless loop of whole bars close to `seconds`. hit_at puts the song's arrival (its climax) on that second — use it for a reveal or a logo. stems=true also cuts every stem at the same points. Returns a listen link and a zip (MP3 192k mix + stems), kept 7 days. Identify the cue by the track_id or title search_music returned. For an ordinary request such as 'an 11-second version', use kind='length' and report the returned musical duration. Use kind='video' only when the user supplies a video's duration or explicitly asks for an exact duration. Do not carry a previous test's exact-length setting into a new request. When the user asks you to create, shorten or adapt a selected cue to a duration, call fit_to_length with that cue and the requested seconds. This works for arbitrary durations from 1 to 300 seconds, not just stock 15/30/40/60-second cuts or clips below 15 seconds. Preserve their chosen source version (for example NO_VOCALS); never silently use MAIN instead. If no cue has been chosen, search using their musical brief and help them choose first; a search result is not a newly generated edit. When status is processing, continue the same returned retry arguments without asking the user to repeat their request. Do not claim the edit is ready until status is ready and the returned edit links exist. Reply in the user's language, naming the cue, requested duration and actual duration. Show the supplied player and a clearly labeled download link; never show the source track's audio as the generated edit.

Get an AINSOF link to hear a complete track preview. The AINSOF link obtains a fresh temporary storage address when opened; it remains usable while that preview is available.

Use this when the user needs existing, licensable music or sound effects for a project — background music, production music, music for an ad, trailer, YouTube video, podcast, game or film — described in words (mood, scene, genre, instruments, energy). Do not use it to generate new music, write lyrics, identify a song, or play commercial releases by other artists. Find AINSOF music from a written brief — mood, scene, genre, energy, instruments. Example: 'lo-fi hip hop underscore, warm, no vocals'. Send the user's original language and musical intent, including durations and exclusions. Each call is self-contained. For a refinement, combine the current musical requirements and the latest change into brief; do not send only the clarification question. Send only musical requirements, never chat transcripts, assistant replies or unrelated personal information. Pass the customer's musical request in their original language, preserving their words, exclusions and durations. Do not add instruments, genres, mood, energy or vocal restrictions that they did not ask for. For a refinement, combine only the customer's established requirements and latest change, not suggestions from an assistant. One search returns evaluated matches or alternatives; present that result before proposing another direction. An unavailable search is a technical failure, not an empty catalog: explain it and do not automatically repeat or broaden the request. A user-requested retry remains possible. Use the returned understanding, followups and selected preview version when presenting the answer. A NAME also works, and is answered exactly: pass a track title ('Shine On Today'), an album ('Shining Ahead'), a catalog number ('AIN-CAT 031') or a COMPOSER ('Alon Peretz') as the brief and you get that cue, that album in full, or everything that writer wrote. A composer named inside an ordinary brief puts their cues first without narrowing it. NEVER tell a user we do not have a track until you have passed its name here.

Use this when the user wants licensable music that sounds like a song they name or link. Do not use it to identify, play or download the reference recording itself. Find AINSOF music that SOUNDS LIKE a reference. Accepts a YouTube, Spotify, Apple Music or Deezer link, or 'artist - title'. SoundCloud is not supported because it exposes no permitted preview clip; TikTok is not supported because its published metadata identifies the post caption, not the recording. Ask for the artist and title instead. Use it when the user asks for AINSOF music similar to that reference: it matches the reference against the AINSOF catalog using available audio or metadata. Supply musical_description with concrete style, groove and instruments when supported by the user's description or reliable knowledge of the reference; omit it if uncertain. This adds a separate catalog-context search. Returned candidates are not verified sound-alikes; musical suitability requires listening. Records by other artists cannot be licensed from AINSOF, so this returns our cues rather than a reading list. The first reply is often still_running because it resolves the reference through public or authorized metadata and compares a permitted preview clip by sound — call it again with the same link and it picks up the search already running.

Before AINSOF works with a video the person signs in once on ainsof.io (Google or email): without a sign_in_code this returns sign_in_required with a link to show them; after they sign in, call again with the same arguments plus that sign_in_code. Create a music-scored MP4 from a supported video URL and an English music brief, an explicit catalog track, or timed sections. Measures video duration and edit pace, selects or uses the specified music, and mixes it with the source audio. Sections support separate cues, versions or stems; silences specify music-free intervals. Section and silence boundaries are adjusted to measured shot boundaries. Returns video download/watch links, chosen cues, mix details, duration and shot-count summary. Watching is free; downloading the file needs a signed-in AINSOF account with download access (sign in on ainsof.io with Google or email). Detailed cut timestamps, storyboard frames and transcripts are provided by analyze_video, not this tool. Completed delivery packages are retrieved with deliver_score using the scoring arguments. Supports direct video files and supported Dropbox/Google Drive shares; stream-only YouTube, Vimeo, Dailymotion and Twitch pages are unsupported. Creates private processing jobs and stored outputs. After verified output storage, the temporary AINSOF-uploaded source copy is deleted or queued for deletion retry; the local original is unchanged. Processing may return still_running; recent identical requests reuse existing work. Terminal failures return a reason.

Find AINSOF cues that sound like an AINSOF cue — the whole cue, or a passage of it marked with from and to (seconds, 5–60 s long), e.g. the hook or the bar before the drop. Each result names the matching passage inside it. Takes a track_id or the cue's title. For a song by another artist (a YouTube, Spotify, Apple Music or Deezer link) use search_by_reference instead.

Use this when the user wants music for a specific video and its length is known. If the length is unknown, use search_music instead. Find music for a video. Given the video's length and a description of it, returns eight cues from the AINSOF catalog when suitable cues are available, preferring playable versions that fit the requested duration. When an exact-length cut is unavailable, for_your_video explains the required edit. Every result comes with its composer, publisher and a preview to listen to. Use this when someone asks for music or a soundtrack for a video and its exact duration is available. Each call is self-contained: for a refinement, describe the current musical requirements including the latest change. Send only the video description and musical requirements, never chat transcripts, assistant replies or unrelated personal information. Pass the customer's musical request in their original language, preserving their words, exclusions and durations. Do not add instruments, genres, mood, energy or vocal restrictions that they did not ask for. For a refinement, combine only the customer's established requirements and latest change, not suggestions from an assistant. One search returns evaluated matches or alternatives; present that result before proposing another direction. An unavailable search is a technical failure, not an empty catalog: explain it and do not automatically repeat or broaden the request. A user-requested retry remains possible.

One cue in full: album, catalog number, composer with IPI, publisher, tempo, key, description, and every version and stem. Takes a track_id OR the track's title — call it by name when the user names a cue.

Use this when the user says their video is ON THEIR COMPUTER rather than at a link — "I have a video on my desktop, find me music and score it". Returns upload_page — a link with a file picker — plus the video_url to score afterwards. GIVE THEM upload_page AS A LINK TO OPEN. Do not paste a terminal command at someone in a chat window — they have no terminal, and this is the step where we lose them. Wait for them to say it finished, then call score_my_video with the video_url this returned. If you are an agent that can run commands on their machine yourself, you may PUT the file to upload_url instead only when it is present. Otherwise the upload page asks for Google or email sign-in first. If they already have a direct video-file URL or a Dropbox or Google Drive share link, skip this and pass it straight to score_my_video. Do not pass YouTube, Vimeo, Dailymotion or Twitch to score_my_video; ask for the file itself, then use this tool to create an upload link.