AINSOF API

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AINSOF_API_KEY" \
  -d '{"action": "search", "brief": "dark cinematic trailer tension, pulsing synths", "top_k": 2}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    headers={"Authorization": f"Bearer {os.environ['AINSOF_API_KEY']}"},
    json={
      "action": "search",
      "brief": "dark cinematic trailer tension, pulsing synths",
      "top_k": 2
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${process.env.AINSOF_API_KEY}`,
  },
  body: JSON.stringify({
    "action": "search",
    "brief": "dark cinematic trailer tension, pulsing synths",
    "top_k": 2
  }),
});
const data = await res.json();

{
  "ok": true,
  "catalogue_note": "Every track in these results is an original AINSOF composition. If your brief named a commercial song or artist, these are original alternatives in that spirit — not the …",
  "how_to_present": "Present each cue as: the album cover as a markdown image ![](album_cover_url), then the title in bold, then album and catalogue number, composer, publisher, BPM and lengt …",
  "results": [
    {
      "track_id": "AIN-CAT 047_007",
      "title": "Tectonic Will",
      "album_cover_url": "https://mcp.ainsof.io/cover/AIN-CAT_047.jpg?v=2",
      "album_cover_thumb_url": "https://mcp.ainsof.io/cover/AIN-CAT_047.jpg?v=2&w=220",
      "album": "Bedrock Ballistic (Raw Force Hybrid Trailer)",
      "catalogue": "AIN-CAT 047",
      "composers": [
        {
          "name": "Roman Marin",
          "society": "PRS",
          "ipi": "392438537",
          "performance_share": "50%"
        }
      ],
      "publisher": "AINSOF (Or Chausha AINSOF)",
      "style": "Hybrid Trailer",
      "also": [
        "Aggressive Hybrid Trailer",
        "Dark Cinematic Trailer"
      ],
      "feels": [
        "Intense",
        "Aggressive",
        "…"
      ],
      "length": "2:11",
      "bpm": 137,
      "description": "This aggressive hybrid trailer track, clocking in at 137.2 BPM, delivers an intense and foreboding sonic experience. Driven by powerful cinematic percussion, taiko drums, …",
      "listen_url": "https://play.ainsof.io/#AIN-CAT_047_007",
      "audio_url": "https://mcp.ainsof.io/p/AIN-CAT_047_007?raw=1",
      "also_available": "7 more versions: CUT_15, CUT_30, CUT_40, CUT_60, MUSIC_BED, NO_PERCUSSION, UNDERSCORE · 5 stems"
    },
    "…"
  ],
  "licensing": "… (see The licensing object)"
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ain_000000000000000000000000" \
  -d '{"action": "search", "brief": "piano"}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    headers={"Authorization": "Bearer ain_000000000000000000000000"},
    json={
      "action": "search",
      "brief": "piano"
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer ain_000000000000000000000000",
  },
  body: JSON.stringify({
    "action": "search",
    "brief": "piano"
  }),
});
const data = await res.json();

{
  "ok": false,
  "error": "unauthorized",
  "message": "That key is not recognised."
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -d '{"action": "search", "brief": "warm acoustic"}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    json={
      "action": "search",
      "brief": "warm acoustic"
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "action": "search",
    "brief": "warm acoustic"
  }),
});
const data = await res.json();

{
  "ok": false,
  "error": "rate_limited",
  "message": "You have reached the free daily limit. It resets on a rolling 24 hours. A free key raises it to 1000 a day — create one at https://ainsof.io/account/api-keys (sign in with Google or email) — or get in touch and we will raise it further.",
  "tell_the_user": "Say plainly that the daily free limit was reached and it resets within 24 hours. Do NOT say the catalogue has nothing, do NOT say the track does not exist, and do NOT go and search the web instead. Nothing was searched.",
  "contact": "info@ainsof.io"
}

{
  "status": "preview",
  "what_you_have": "You have full search across the AINSOF catalogue, and every track you download is a complete preview — the whole piece, start to finish, so you can cut to it and see whether it truly works. The preview is for auditioning; publication requires a separate licence.",
  "beyond_online": {
    "note": "A preview does not grant permission for publication, broadcast, advertising or other release. This connector does not sell licences or initiate a purchase; it provides discovery, auditioning and rights information.",
    "uses": [
      "Trailers and promos",
      "Broadcast television and radio",
      "Cinema and theatrical",
      "Paid advertising campaigns",
      "Games and apps",
      "Anything exclusive, or any territory you need locked"
    ]
  },
  "contact": "info@ainsof.io",
  "how_it_works": [
    "Search and audition catalogue previews without purchasing anything.",
    "Cue sheets identify the music and credits; they are not a licence.",
    "For technical support, privacy requests or questions about an existing licence, contact info@ainsof.io."
  ]
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -d '{"action": "search", "brief": "warm acoustic guitar underscore, hopeful, no vocals", "top_k": 3}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    json={
      "action": "search",
      "brief": "warm acoustic guitar underscore, hopeful, no vocals",
      "top_k": 3
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "action": "search",
    "brief": "warm acoustic guitar underscore, hopeful, no vocals",
    "top_k": 3
  }),
});
const data = await res.json();

{
  "ok": true,
  "enforced": [
    "no vocals"
  ],
  "catalogue_note": "Every track in these results is an original AINSOF composition. If your brief named a commercial song or artist, these are original alternatives in that spirit — not the named recording, and not a cover of it.",
  "how_to_present": "Use only the AINSOF album artwork attached to this result or its album_cover_thumb_url. Never search for, generate or substitute artwork from Spotify, Apple Music or another artist. If it cannot be displayed, show the album title without an image. Present each cue as: the album cover as a markdown image ![](album_cover_url), then the title in bold, then album and catalogue number, composer, publisher, BPM and length, then the listen link as an ordinary markdown link.  The artwork reaches you twice — attached to this reply as image blocks, and as a URL on every row. Each attached cover is preceded by a line naming its album (\"Album cover — <album> · <catalogue>\"), so you always know which record a picture belongs to: show it beside the cues from that album. Covers are sent one per album, not one per cue, so several cues can share the same picture.  Interfaces differ: some render the markdown image inline, some hide remote images behind a click, some show only the attachment. Write the markdown image regardless, since it costs nothing where it does not render. But never assume the customer can see it: never let the cover carry a fact the words do not. Named in text, the album survives every client.  listen_url on a row opens the complete preview of that cue. Every cue here is a preview for auditioning; licensing is at the foot of this answer, and both are true of the whole list rather than of any one row.  also_available on a row is an INVENTORY, not a limit: \"7 more versions: CUT_15, CUT_30, CUT_40, CUT_60, UNDERSCORE, NO_CHOIR · 8 stems\" means we hold each of those named lengths and mixes of that cue, plus eight separated stems. The version names are on the row precisely so you can answer \"do you have a 30?\" from what you already have — read them and say yes, rather than calling get_track to find out. Stems are counted rather than named, because their names are long and nobody picks a cue off a stem list.  Never read a short row as a thin catalogue and never tell a customer a cue has no 30-second cut or no stems. Call get_track when you need the actual FILES — a listen link for a specific version or stem, or the full credits — not to discover which versions exist, because that is already written above.  ⚠️ Do NOT build a custom audio player, HTML widget or iframe for these results. A generated player runs under a content policy that blocks our audio host, so the controls appear and nothing plays — which looks broken to the customer and is worse than a plain link that works. A markdown link plays. Use it.  Never mention scores, rankings, identifiers, tokens, link expiry, iframes, content policies or anything about how the search works. If something cannot be done, say plainly what failed and offer to try again.  If the brief named a commercial song or artist, open with the plain fact that AINSOF is an original catalogue and these are original alternatives in that spirit — never present a result as the named recording or a cover of it.",
  "results": [
    {
      "track_id": "AIN-CAT 058_001",
      "title": "Azahar",
      "album_cover_url": "https://mcp.ainsof.io/cover/AIN-CAT_058.jpg?v=2",
      "album_cover_thumb_url": "https://mcp.ainsof.io/cover/AIN-CAT_058.jpg?v=2&w=220",
      "album": "Naranja Amarga (Live Spanish Guitar)",
      "catalogue": "AIN-CAT 058",
      "composers": [
        {
          "name": "Hanan Alter",
          "society": "PRS",
          "ipi": "1307867336",
          "performance_share": "50%"
        }
      ],
      "publisher": "AINSOF (Or Chausha AINSOF)",
      "style": "Spanish Acoustic Folk",
      "also": [
        "Spanish Guitar",
        "Latin Acoustic",
        "Acoustic Folk"
      ],
      "feels": [
        "Heartfelt",
        "Reflective",
        "Hopeful"
      ],
      "length": "2:35",
      "bpm": 128,
      "description": "This warm and intimate acoustic guitar piece, performed in D minor at a flowing 127.84 BPM, offers a delicate and reflective journey. Its gentle three-beat pulse and tender melody evoke images of sun-dappled courtyards and orange blossoms, capturing quiet moments between Spain and Mexico. With an emotional peak around 139 seconds, the track is ideal for understated cultural storytelling, reflective travel, and scenes of gentle romance. The solo acoustic guitar creates a heartfelt and hopeful atmosphere, concluding its 155-second duration with a lingering sense of bittersweet beauty. It's a piece designed for quiet contemplation rather than overt sadness, perfect for adding a touch of authentic, live-recorded warmth. The track's organic feel and intimate sound make it highly versatile for emotional depth.",
      "listen_url": "https://play.ainsof.io/#AIN-CAT_058_001",
      "audio_url": "https://mcp.ainsof.io/p/AIN-CAT_058_001?raw=1",
      "also_available": "5 more versions: CUT_15, CUT_30, CUT_40, CUT_60, UNDERSCORE · 3 stems"
    },
    {
      "track_id": "AIN-CAT 059_006",
      "title": "Farruca",
      "album_cover_url": "https://mcp.ainsof.io/cover/AIN-CAT_059.jpg?v=2",
      "album_cover_thumb_url": "https://mcp.ainsof.io/cover/AIN-CAT_059.jpg?v=2&w=220",
      "album": "Juerga Larga (Live Flamenco)",
      "catalogue": "AIN-CAT 059",
      "composers": [
        {
          "name": "Idan Zion",
          "society": "ASCAP",
          "ipi": "1100892299",
          "performance_share": "50%"
        }
      ],
      "publisher": "AINSOF (Or Chausha AINSOF)",
      "style": "Acoustic Flamenco Farruca",
      "also": [
        "Farruca",
        "Spanish Guitar",
        "Acoustic Flamenco"
      ],
      "feels": [
        "Passionate",
        "Energetic",
        "Nostalgic"
      ],
      "length": "1:45",
      "bpm": 89,
      "description": "This D minor Farruca, performed at 89.29 BPM, features two acoustic guitars—a lead and a rhythm—creating a gentle, intimate, and exposed soundscape without bass or percussion. Its unhurried yet energetic and passionate delivery evokes a reflective and nostalgic mood, ideal for moments of quiet contemplation or a solitary flamenco dance. The track builds to an emotional peak at 101 seconds before concluding at 102 seconds, making it perfect for understated emotional beats in film or documentary. It captures the essence of a live, acoustic Spanish guitar performance, offering a romantic and hopeful texture for various media.",
      "listen_url": "https://play.ainsof.io/#AIN-CAT_059_006",
      "audio_url": "https://mcp.ainsof.io/p/AIN-CAT_059_006?raw=1",
      "also_available": "4 more versions: CUT_15, CUT_30, CUT_40, CUT_60 · 2 stems"
    }
  ],
  "licensing": {
    "status": "preview",
    "what_you_have": "You have full search across the AINSOF catalogue, and every track you download is a complete preview — the whole piece, start to finish, so you can cut to it and see whether it truly works. The preview is for auditioning; publication requires a separate licence.",
    "beyond_online": {
      "note": "A preview does not grant permission for publication, broadcast, advertising or other release. This connector does not sell licences or initiate a purchase; it provides discovery, auditioning and rights information.",
      "uses": [
        "Trailers and promos",
        "Broadcast television and radio",
        "Cinema and theatrical"
      ]
    },
    "contact": "info@ainsof.io",
    "how_it_works": [
      "Search and audition catalogue previews without purchasing anything.",
      "Cue sheets identify the music and credits; they are not a licence.",
      "For technical support, privacy requests or questions about an existing licence, contact info@ainsof.io."
    ]
  }
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -d '{"action": "search", "brief": "Shine On Today"}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    json={
      "action": "search",
      "brief": "Shine On Today"
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "action": "search",
    "brief": "Shine On Today"
  }),
});
const data = await res.json();

{
  "ok": true,
  "found_by_name": "This is the cue asked for by name, from the AINSOF catalogue.",
  "catalogue_note": "Every track in these results is an original AINSOF composition. If your brief named a commercial song or artist, these are original alternatives in that spirit — not the named recording, and not a cover of it.",
  "how_to_present": "Use only the AINSOF album artwork attached to this result or its album_cover_thumb_url. Never search for, generate or substitute artwork from Spotify, Apple Music or another artist. If it cannot be displayed, show the album title without an image. Present each cue as: the album cover as a markdown image ![](album_cover_url), then the title in bold, then album and catalogue number, composer, publisher, BPM and length, then the listen link as an ordinary markdown link.  The artwork reaches you twice — attached to this reply as image blocks, and as a URL on every row. Each attached cover is preceded by a line naming its album (\"Album cover — <album> · <catalogue>\"), so you always know which record a picture belongs to: show it beside the cues from that album. Covers are sent one per album, not one per cue, so several cues can share the same picture.  Interfaces differ: some render the markdown image inline, some hide remote images behind a click, some show only the attachment. Write the markdown image regardless, since it costs nothing where it does not render. But never assume the customer can see it: never let the cover carry a fact the words do not. Named in text, the album survives every client.  listen_url on a row opens the complete preview of that cue. Every cue here is a preview for auditioning; licensing is at the foot of this answer, and both are true of the whole list rather than of any one row.  also_available on a row is an INVENTORY, not a limit: \"7 more versions: CUT_15, CUT_30, CUT_40, CUT_60, UNDERSCORE, NO_CHOIR · 8 stems\" means we hold each of those named lengths and mixes of that cue, plus eight separated stems. The version names are on the row precisely so you can answer \"do you have a 30?\" from what you already have — read them and say yes, rather than calling get_track to find out. Stems are counted rather than named, because their names are long and nobody picks a cue off a stem list.  Never read a short row as a thin catalogue and never tell a customer a cue has no 30-second cut or no stems. Call get_track when you need the actual FILES — a listen link for a specific version or stem, or the full credits — not to discover which versions exist, because that is already written above.  ⚠️ Do NOT build a custom audio player, HTML widget or iframe for these results. A generated player runs under a content policy that blocks our audio host, so the controls appear and nothing plays — which looks broken to the customer and is worse than a plain link that works. A markdown link plays. Use it.  Never mention scores, rankings, identifiers, tokens, link expiry, iframes, content policies or anything about how the search works. If something cannot be done, say plainly what failed and offer to try again.  If the brief named a commercial song or artist, open with the plain fact that AINSOF is an original catalogue and these are original alternatives in that spirit — never present a result as the named recording or a cover of it.",
  "results": [
    {
      "track_id": "AIN-CAT 031_002",
      "title": "Shine On Today",
      "album_cover_url": "https://mcp.ainsof.io/cover/AIN-CAT_031.jpg?v=2",
      "album_cover_thumb_url": "https://mcp.ainsof.io/cover/AIN-CAT_031.jpg?v=2&w=220",
      "album": "Shining Ahead (Corporate Advertising)",
      "catalogue": "AIN-CAT 031",
      "composers": [
        {
          "name": "Alon Peretz",
          "society": "PRS",
          "ipi": "687184598",
          "performance_share": "50%"
        }
      ],
      "publisher": "AINSOF (Or Chausha AINSOF)",
      "style": "Advertising Pop",
      "also": [
        "Acoustic Pop",
        "Folk Pop",
        "Indie Pop"
      ],
      "feels": [
        "Uplifting",
        "Optimistic",
        "Carefree"
      ],
      "length": "2:31",
      "bpm": 84,
      "description": "This uplifting and sunny D major track, flowing at 83.96 BPM, radiates lighthearted optimism and positive energy. Featuring a bright blend of acoustic guitar, keys, bass, drums, percussion, and playful whistles, it creates an effortlessly cheerful and organic soundscape. The addition of tuba, synth, FX, and subtle vocals adds texture to its feelgood, indie pop character. Ideal for capturing moments of joy and carefree adventure, this track is perfect for a wide range of visual content. It evokes scenes of bright mornings and happy family gatherings, making it a versatile choice for positive storytelling.",
      "listen_url": "https://play.ainsof.io/#AIN-CAT_031_002",
      "audio_url": "https://mcp.ainsof.io/p/AIN-CAT_031_002?raw=1",
      "also_available": "7 more versions: CUT_15, CUT_30, CUT_40, CUT_60, NO_MELODY, NO_PERCUSSION, NO_VOCAL · 11 stems"
    }
  ],
  "licensing": {
    "status": "preview",
    "what_you_have": "You have full search across the AINSOF catalogue, and every track you download is a complete preview — the whole piece, start to finish, so you can cut to it and see whether it truly works. The preview is for auditioning; publication requires a separate licence.",
    "beyond_online": {
      "note": "A preview does not grant permission for publication, broadcast, advertising or other release. This connector does not sell licences or initiate a purchase; it provides discovery, auditioning and rights information.",
      "uses": [
        "Trailers and promos",
        "Broadcast television and radio",
        "Cinema and theatrical"
      ]
    },
    "contact": "info@ainsof.io",
    "how_it_works": [
      "Search and audition catalogue previews without purchasing anything.",
      "Cue sheets identify the music and credits; they are not a licence.",
      "For technical support, privacy requests or questions about an existing licence, contact info@ainsof.io."
    ]
  }
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -d '{"action": "search", "brief": "מוזיקה עצובה לפסנתר", "top_k": 2}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    json={
      "action": "search",
      "brief": "מוזיקה עצובה לפסנתר",
      "top_k": 2
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "action": "search",
    "brief": "מוזיקה עצובה לפסנתר",
    "top_k": 2
  }),
});
const data = await res.json();

{
  "ok": true,
  "translated_from": {
    "we_searched_for": "Sad piano music.",
    "tell_the_user": "Their brief was rewritten into English before searching, because the catalogue matcher reads English only. Answer them in their own language, and show them this English phrase so they can correct it if it missed what they meant."
  },
  "catalogue_note": "Every track in these results is an original AINSOF composition. If your brief named a commercial song or artist, these are original alternatives in that spirit — not the named recording, and not a cover of it.",
  "how_to_present": "Use only the AINSOF album artwork attached to this result or its album_cover_thumb_url. Never search for, generate or substitute artwork from Spotify, Apple Music or another artist. If it cannot be displayed, show the album title without an image. Present each cue as: the album cover as a markdown image ![](album_cover_url), then the title in bold, then album and catalogue number, composer, publisher, BPM and length, then the listen link as an ordinary markdown link.  The artwork reaches you twice — attached to this reply as image blocks, and as a URL on every row. Each attached cover is preceded by a line naming its album (\"Album cover — <album> · <catalogue>\"), so you always know which record a picture belongs to: show it beside the cues from that album. Covers are sent one per album, not one per cue, so several cues can share the same picture.  Interfaces differ: some render the markdown image inline, some hide remote images behind a click, some show only the attachment. Write the markdown image regardless, since it costs nothing where it does not render. But never assume the customer can see it: never let the cover carry a fact the words do not. Named in text, the album survives every client.  listen_url on a row opens the complete preview of that cue. Every cue here is a preview for auditioning; licensing is at the foot of this answer, and both are true of the whole list rather than of any one row.  also_available on a row is an INVENTORY, not a limit: \"7 more versions: CUT_15, CUT_30, CUT_40, CUT_60, UNDERSCORE, NO_CHOIR · 8 stems\" means we hold each of those named lengths and mixes of that cue, plus eight separated stems. The version names are on the row precisely so you can answer \"do you have a 30?\" from what you already have — read them and say yes, rather than calling get_track to find out. Stems are counted rather than named, because their names are long and nobody picks a cue off a stem list.  Never read a short row as a thin catalogue and never tell a customer a cue has no 30-second cut or no stems. Call get_track when you need the actual FILES — a listen link for a specific version or stem, or the full credits — not to discover which versions exist, because that is already written above.  ⚠️ Do NOT build a custom audio player, HTML widget or iframe for these results. A generated player runs under a content policy that blocks our audio host, so the controls appear and nothing plays — which looks broken to the customer and is worse than a plain link that works. A markdown link plays. Use it.  Never mention scores, rankings, identifiers, tokens, link expiry, iframes, content policies or anything about how the search works. If something cannot be done, say plainly what failed and offer to try again.  If the brief named a commercial song or artist, open with the plain fact that AINSOF is an original catalogue and these are original alternatives in that spirit — never present a result as the named recording or a cover of it.",
  "results": [
    {
      "track_id": "AIN-CAT 065_004",
      "title": "Rooms Grow Colder",
      "album_cover_url": "https://mcp.ainsof.io/cover/AIN-CAT_065.jpg?v=2",
      "album_cover_thumb_url": "https://mcp.ainsof.io/cover/AIN-CAT_065.jpg?v=2&w=220",
      "album": "Under Everything (Melodic Emotional Keys)",
      "catalogue": "AIN-CAT 065",
      "composers": [
        {
          "name": "Or Chausha",
          "society": "PRS",
          "ipi": "640537754",
          "performance_share": "25%"
        },
        {
          "name": "Itai Haim Lahav",
          "society": "PRS",
          "ipi": "1354269637",
          "performance_share": "25%"
        }
      ],
      "publisher": "AINSOF (Or Chausha AINSOF)",
      "style": "Melancholic Cinematic Piano Underscore",
      "also": [
        "Sad Piano",
        "Emotional Underscore",
        "Cinematic Drama"
      ],
      "feels": [
        "Melancholic",
        "Sorrowful",
        "Reflective"
      ],
      "length": "2:54",
      "bpm": 115,
      "description": "A deeply melancholic and intimate piano underscore, 'Rooms Grow Colder' evokes a profound sense of loss and quiet reflection. Delicate piano melodies, supported by warm pads, subtle keys, and ethereal synth textures, weave a sorrowful narrative in A minor at 115 BPM. The track maintains a restrained, vulnerable energy, building gently towards a poignant emotional peak near its conclusion at 160 seconds. It is a heartfelt journey through bittersweet memories and the tender process of saying goodbye, perfect for moments of quiet contemplation and emotional storytelling. The overall mood is dreamy and reflective, offering solace in its delicate beauty. This instrumental piece is designed to underscore profound personal moments and cinematic drama.",
      "listen_url": "https://play.ainsof.io/#AIN-CAT_065_004",
      "audio_url": "https://mcp.ainsof.io/p/AIN-CAT_065_004?raw=1",
      "also_available": "7 more versions: CUT_15, CUT_30, CUT_40, CUT_60, NO_DRUM, NO_PIANO_KEY, UNDERSCORE · 8 stems"
    },
    {
      "track_id": "AIN-CAT 065_007",
      "title": "Nothing to Fix",
      "album_cover_url": "https://mcp.ainsof.io/cover/AIN-CAT_065.jpg?v=2",
      "album_cover_thumb_url": "https://mcp.ainsof.io/cover/AIN-CAT_065.jpg?v=2&w=220",
      "album": "Under Everything (Melodic Emotional Keys)",
      "catalogue": "AIN-CAT 065",
      "composers": [
        {
          "name": "Or Chausha",
          "society": "PRS",
          "ipi": "640537754",
          "performance_share": "25%"
        },
        {
          "name": "Itai Haim Lahav",
          "society": "PRS",
          "ipi": "1354269637",
          "performance_share": "25%"
        }
      ],
      "publisher": "AINSOF (Or Chausha AINSOF)",
      "style": "Cinematic Emotional Underscore",
      "also": [
        "Sad Piano",
        "Melodic Underscore",
        "Ambient Cinematic"
      ],
      "feels": [
        "Melancholic",
        "Dreamy",
        "Reflective"
      ],
      "length": "2:46",
      "bpm": 90,
      "description": "This melodic and intimate emotional cue, set at a gentle 90 BPM in C minor, is led by expressive Keys, soft Pads, and delicate Percussion, creating a reflective atmosphere. The 166-second track, featuring Bells, Synth Textures, Guitar, and FX Keys, builds to an emotional peak at 142 seconds before a tender fade at 164 seconds. It evokes a dreamy, melancholic, and reflective mood, perfect for personal, vulnerable, and quietly dramatic moments. Ideal for cinematic underscore in dramas or documentaries, it provides a tender backdrop for storytelling about loss, quiet hope, or new beginnings. This piece is suited for moments of introspection, gentle farewells, or the warmth of childhood memories. Its subtle drama and heartfelt sentiment make it perfect for emotional storytelling in film, TV, and social media.",
      "listen_url": "https://play.ainsof.io/#AIN-CAT_065_007",
      "audio_url": "https://mcp.ainsof.io/p/AIN-CAT_065_007?raw=1",
      "also_available": "7 more versions: CUT_15, CUT_30, CUT_40, CUT_60, NO_DRUM, NO_PIANO_KEY, UNDERSCORE · 7 stems"
    }
  ],
  "licensing": {
    "status": "preview",
    "what_you_have": "You have full search across the AINSOF catalogue, and every track you download is a complete preview — the whole piece, start to finish, so you can cut to it and see whether it truly works. The preview is for auditioning; publication requires a separate licence.",
    "beyond_online": {
      "note": "A preview does not grant permission for publication, broadcast, advertising or other release. This connector does not sell licences or initiate a purchase; it provides discovery, auditioning and rights information.",
      "uses": [
        "Trailers and promos",
        "Broadcast television and radio",
        "Cinema and theatrical"
      ]
    },
    "contact": "info@ainsof.io",
    "how_it_works": [
      "Search and audition catalogue previews without purchasing anything.",
      "Cue sheets identify the music and credits; they are not a licence.",
      "For technical support, privacy requests or questions about an existing licence, contact info@ainsof.io."
    ]
  }
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -d '{"action": "search", "link": "Hans Zimmer - Time", "top_k": 3}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    json={
      "action": "search",
      "link": "Hans Zimmer - Time",
      "top_k": 3
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "action": "search",
    "link": "Hans Zimmer - Time",
    "top_k": 3
  }),
});
const data = await res.json();

{
  "ok": true,
  "heard": "Hans Zimmer — Time",
  "reference_match": {
    "method": "reference_only",
    "context_retrieval": "not_requested",
    "reference_source": "audio_or_catalogue",
    "similarity_verified": false,
    "note": "These are ranked catalogue candidates, not verified sound-alikes. No musical description was supplied. Add the reference's known style, groove and instruments to refine the search; do not invent them."
  },
  "catalogue_note": "Every track in these results is an original AINSOF composition. If your brief named a commercial song or artist, these are original alternatives in that spirit — not the named recording, and not a cover of it.",
  "how_to_present": "Use only the AINSOF album artwork attached to this result or its album_cover_thumb_url. Never search for, generate or substitute artwork from Spotify, Apple Music or another artist. If it cannot be displayed, show the album title without an image. Present each cue as: the album cover as a markdown image ![](album_cover_url), then the title in bold, then album and catalogue number, composer, publisher, BPM and length, then the listen link as an ordinary markdown link.  The artwork reaches you twice — attached to this reply as image blocks, and as a URL on every row. Each attached cover is preceded by a line naming its album (\"Album cover — <album> · <catalogue>\"), so you always know which record a picture belongs to: show it beside the cues from that album. Covers are sent one per album, not one per cue, so several cues can share the same picture.  Interfaces differ: some render the markdown image inline, some hide remote images behind a click, some show only the attachment. Write the markdown image regardless, since it costs nothing where it does not render. But never assume the customer can see it: never let the cover carry a fact the words do not. Named in text, the album survives every client.  listen_url on a row opens the complete preview of that cue. Every cue here is a preview for auditioning; licensing is at the foot of this answer, and both are true of the whole list rather than of any one row.  also_available on a row is an INVENTORY, not a limit: \"7 more versions: CUT_15, CUT_30, CUT_40, CUT_60, UNDERSCORE, NO_CHOIR · 8 stems\" means we hold each of those named lengths and mixes of that cue, plus eight separated stems. The version names are on the row precisely so you can answer \"do you have a 30?\" from what you already have — read them and say yes, rather than calling get_track to find out. Stems are counted rather than named, because their names are long and nobody picks a cue off a stem list.  Never read a short row as a thin catalogue and never tell a customer a cue has no 30-second cut or no stems. Call get_track when you need the actual FILES — a listen link for a specific version or stem, or the full credits — not to discover which versions exist, because that is already written above.  ⚠️ Do NOT build a custom audio player, HTML widget or iframe for these results. A generated player runs under a content policy that blocks our audio host, so the controls appear and nothing plays — which looks broken to the customer and is worse than a plain link that works. A markdown link plays. Use it.  Never mention scores, rankings, identifiers, tokens, link expiry, iframes, content policies or anything about how the search works. If something cannot be done, say plainly what failed and offer to try again.  If the brief named a commercial song or artist, open with the plain fact that AINSOF is an original catalogue and these are original alternatives in that spirit — never present a result as the named recording or a cover of it.",
  "results": [
    {
      "track_id": "AIN-CAT 041_004",
      "title": "Prime Ascension",
      "album_cover_url": "https://mcp.ainsof.io/cover/AIN-CAT_041.jpg?v=2",
      "album_cover_thumb_url": "https://mcp.ainsof.io/cover/AIN-CAT_041.jpg?v=2&w=220",
      "album": "Heroic Dominion (Orchestral Kinetic Heroics)",
      "catalogue": "AIN-CAT 041",
      "composers": [
        {
          "name": "Alexander Okunev",
          "society": "PRS",
          "ipi": "499092207",
          "performance_share": "50%"
        }
      ],
      "publisher": "AINSOF (Or Chausha AINSOF)",
      "style": "Cinematic Hybrid Orchestral",
      "also": [
        "Superhero Score",
        "Trailer Music",
        "Action Adventure Score"
      ],
      "feels": [
        "Heroic",
        "Triumphant",
        "Empowering"
      ],
      "length": "2:39",
      "bpm": 125,
      "description": "This cinematic hybrid orchestral score, set at a driving 125 BPM in F minor, embodies a noble hero's journey from challenge to ultimate triumph. Featuring expressive piano, soaring legato strings, proud brass melodies, and an epic choir, it builds with powerful percussion and taiko to a grand, triumphant climax at 148 seconds. The track's intense and uplifting energy, punctuated by impactful hits, braams, and whooshes, perfectly underscores moments of heroic transformation and ascending power. With its blend of orchestral and synth elements, including synth bass and synth brass, it creates a modern, monumental soundscape. This is the sound of victory and determination, designed to inspire and elevate. It is ideal for blockbuster trailers and climactic scenes, creating a truly epic and empowering atmosphere.",
      "listen_url": "https://play.ainsof.io/#AIN-CAT_041_004",
      "audio_url": "https://mcp.ainsof.io/p/AIN-CAT_041_004?raw=1",
      "also_available": "7 more versions: CUT_15, CUT_30, CUT_40, CUT_60, NO_CHOIR, NO_PERCUSSION, UNDERSCORE · 14 stems"
    },
    {
      "track_id": "AIN-CAT 005_008",
      "title": "Battleforged Awakening",
      "album_cover_url": "https://mcp.ainsof.io/cover/AIN-CAT_005.jpg?v=2",
      "album_cover_thumb_url": "https://mcp.ainsof.io/cover/AIN-CAT_005.jpg?v=2&w=220",
      "album": "Veil Of Wonders (Symphonic Mystery Adventure)",
      "catalogue": "AIN-CAT 005",
      "composers": [
        {
          "name": "Alexander Okunev",
          "society": "PRS",
          "ipi": "499092207",
          "performance_share": "50%"
        }
      ],
      "publisher": "AINSOF (Or Chausha AINSOF)",
      "style": "Epic Cinematic Fantasy Orchestral",
      "also": [
        "Orchestral Adventure",
        "Fantasy Score",
        "Trailer Music"
      ],
      "feels": [
        "Epic",
        "Magical",
        "Adventurous"
      ],
      "length": "3:00",
      "bpm": 131,
      "description": "This epic cinematic orchestral track, set in E minor and surging at 130.81 BPM, conjures a world where ancient mysteries awaken under a moon's ethereal glow, leading to a powerful, battle-forged destiny. Grand choirs, soaring strings, and powerful brass combine with the percussive force of Taiko drums and timpani, alongside the exotic textures of Duduk and Bagpipes, creating an intense and adventurous soundscape. The track's very high energy and intense mood build steadily towards a dramatic emotional peak at 177 seconds, culminating in a powerful, conclusive statement at 178 seconds. With its blend of traditional and hybrid orchestral elements, including electric guitar, it evokes a sense of both magic and impending conflict. This instrumental piece, featuring prominent choir and wordless vocals, is ideal for fantasy film trailers, video game scores, or any dramatic content requiring a sense of heroic struggle and magical discovery.",
      "listen_url": "https://play.ainsof.io/#AIN-CAT_005_008",
      "audio_url": "https://mcp.ainsof.io/p/AIN-CAT_005_008?raw=1",
      "also_available": "8 more versions: BRASS_STRINGS, CUT_15, CUT_30, CUT_40, CUT_60, NO_CHOIR, NO_DRUM_PERCUSSION, UNDERSCORE · 5 stems"
    }
  ],
  "licensing": {
    "status": "preview",
    "what_you_have": "You have full search across the AINSOF catalogue, and every track you download is a complete preview — the whole piece, start to finish, so you can cut to it and see whether it truly works. The preview is for auditioning; publication requires a separate licence.",
    "beyond_online": {
      "note": "A preview does not grant permission for publication, broadcast, advertising or other release. This connector does not sell licences or initiate a purchase; it provides discovery, auditioning and rights information.",
      "uses": [
        "Trailers and promos",
        "Broadcast television and radio",
        "Cinema and theatrical"
      ]
    },
    "contact": "info@ainsof.io",
    "how_it_works": [
      "Search and audition catalogue previews without purchasing anything.",
      "Cue sheets identify the music and credits; they are not a licence.",
      "For technical support, privacy requests or questions about an existing licence, contact info@ainsof.io."
    ]
  }
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AINSOF_API_KEY" \
  -d '{"action": "similar", "track_id": "AIN-CAT 030_001", "from": 107, "to": 122, "top_k": 3}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    headers={"Authorization": f"Bearer {os.environ['AINSOF_API_KEY']}"},
    json={
      "action": "similar",
      "track_id": "AIN-CAT 030_001",
      "from": 107,
      "to": 122,
      "top_k": 3
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${process.env.AINSOF_API_KEY}`,
  },
  body: JSON.stringify({
    "action": "similar",
    "track_id": "AIN-CAT 030_001",
    "from": 107,
    "to": 122,
    "top_k": 3
  }),
});
const data = await res.json();

{
  "ok": true,
  "reference": {
    "track_id": "AIN-CAT 030_001",
    "title": "Along The River",
    "album_code": "AIN-CAT 030",
    "passage": {
      "from": 107,
      "to": 122,
      "label": "1:47–2:02"
    }
  },
  "how_matched": "Compared by sound against every AINSOF cue, window by window; matching_passage is the part of each result that sounds closest to the marked passage.",
  "results": [
    {
      "track_id": "AIN-CAT 024_002",
      "title": "Spring In a Bottle",
      "album": "Heartwood (Live Acoustic Embrace)",
      "catalogue": "AIN-CAT 024",
      "listen_url": "https://play.ainsof.io/#AIN-CAT_024_002",
      "…": "…",
      "similarity": 0.9669,
      "matching_passage": {
        "from": 15,
        "to": 25,
        "label": "0:15–0:25"
      }
    },
    {
      "track_id": "AIN-CAT 030_002",
      "title": "Desert Journey",
      "…": "…",
      "similarity": 0.9627,
      "matching_passage": {
        "from": 80,
        "to": 90,
        "label": "1:20–1:30"
      }
    },
    "…"
  ],
  "licensing": "… (see The licensing object)"
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -d '{"action": "track", "track_id": "AIN-CAT 031_002"}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    json={
      "action": "track",
      "track_id": "AIN-CAT 031_002"
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "action": "track",
    "track_id": "AIN-CAT 031_002"
  }),
});
const data = await res.json();

{
  "ok": true,
  "credits": {
    "track_id": "AIN-CAT 031_002",
    "catalogue": "AIN-CAT 031",
    "album": "Shining Ahead (Corporate Advertising)",
    "title": "Shine On Today",
    "isrc": "BG-A47-26-02477",
    "bpm": 84,
    "key": "D major",
    "duration_sec": 151,
    "publisher": "AINSOF (Or Chausha AINSOF)",
    "composers": [
      {
        "ipi": "687184598",
        "name": "Alon Peretz",
        "society": "PRS",
        "perf_share": "50%"
      }
    ],
    "album_cover_url": "https://mcp.ainsof.io/cover/AIN-CAT_031.jpg?v=2",
    "album_cover_thumb_url": "https://mcp.ainsof.io/cover/AIN-CAT_031.jpg?v=2&w=220"
  },
  "track": {
    "track_id": "AIN-CAT 031_002",
    "title": "Shine On Today",
    "album_cover_url": "https://mcp.ainsof.io/cover/AIN-CAT_031.jpg?v=2",
    "album_cover_thumb_url": "https://mcp.ainsof.io/cover/AIN-CAT_031.jpg?v=2&w=220",
    "album": "Shining Ahead (Corporate Advertising)",
    "catalogue": "AIN-CAT 031",
    "composers": [
      {
        "ipi": "687184598",
        "name": "Alon Peretz",
        "society": "PRS",
        "perf_share": "50%"
      }
    ],
    "publisher": "AINSOF (Or Chausha AINSOF)",
    "style": "Advertising Pop",
    "also": [
      "Acoustic Pop",
      "Folk Pop",
      "Indie Pop"
    ],
    "feels": [
      "Uplifting",
      "Optimistic",
      "Carefree"
    ],
    "length": "2:31",
    "bpm": 84,
    "description": "This uplifting and sunny D major track, flowing at 83.96 BPM, radiates lighthearted optimism and positive energy. Featuring a bright blend of acoustic guitar, keys, bass, drums, percussion, and playful whistles, it creates an effortlessly cheerful and organic soundscape. The addition of tuba, synth, FX, and subtle vocals adds texture to its feelgood, indie pop character. Ideal for capturing moments of joy and carefree adventure, this track is perfect for a wide range of visual content. It evokes scenes of bright mornings and happy family gatherings, making it a versatile choice for positive storytelling.",
    "versions": [
      {
        "version": "CUT_15",
        "label": "15s",
        "length": "0:15",
        "listen_url": "https://play.ainsof.io/#AIN-CAT_031_002/CUT_15"
      },
      {
        "version": "CUT_30",
        "label": "30s",
        "length": "0:30",
        "listen_url": "https://play.ainsof.io/#AIN-CAT_031_002/CUT_30"
      },
      {
        "version": "CUT_40",
        "label": "40s",
        "length": "0:40",
        "listen_url": "https://play.ainsof.io/#AIN-CAT_031_002/CUT_40"
      }
    ],
    "stems": [
      {
        "stem": "ACC",
        "label": "Acc",
        "listen_url": "https://play.ainsof.io/#AIN-CAT_031_002/STEM_ACC"
      },
      {
        "stem": "BASS",
        "label": "Bass",
        "listen_url": "https://play.ainsof.io/#AIN-CAT_031_002/STEM_BASS"
      },
      {
        "stem": "DRUMS",
        "label": "Drums",
        "listen_url": "https://play.ainsof.io/#AIN-CAT_031_002/STEM_DRUMS"
      }
    ],
    "listen_url": "https://play.ainsof.io/#AIN-CAT_031_002",
    "audio_url": "https://mcp.ainsof.io/p/AIN-CAT_031_002?raw=1",
    "listen": "Open listen_url to hear the complete preview. Every entry under versions and stems carries its own listen_url — cutdowns, instrumentals and individual stems all play the same way.",
    "licence": "Preview for auditioning · no publication rights granted",
    "music_key": "D major",
    "vibe": "Bright, organic, and irresistibly cheerful, evoking a sense of carefree optimism.",
    "scenes": [
      "Sun-drenched morning routines",
      "Family road trips",
      "DIY project montages"
    ],
    "use_cases": [
      "Upbeat TV commercials",
      "Lifestyle brand campaigns",
      "Social media content for positive messaging"
    ],
    "not_for": [
      "Dramatic or suspenseful narratives",
      "Somber or melancholic storytelling",
      "High-stakes action sequences"
    ]
  },
  "cue_sheet_available": true,
  "licensing": {
    "status": "preview",
    "what_you_have": "You have full search across the AINSOF catalogue, and every track you download is a complete preview — the whole piece, start to finish, so you can cut to it and see whether it truly works. The preview is for auditioning; publication requires a separate licence.",
    "beyond_online": {
      "note": "A preview does not grant permission for publication, broadcast, advertising or other release. This connector does not sell licences or initiate a purchase; it provides discovery, auditioning and rights information.",
      "uses": [
        "Trailers and promos",
        "Broadcast television and radio",
        "Cinema and theatrical"
      ]
    },
    "contact": "info@ainsof.io",
    "how_it_works": [
      "Search and audition catalogue previews without purchasing anything.",
      "Cue sheets identify the music and credits; they are not a licence.",
      "For technical support, privacy requests or questions about an existing licence, contact info@ainsof.io."
    ]
  }
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -d '{"action": "preview", "track_id": "AIN-CAT_031_002", "version": "cut_15"}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    json={
      "action": "preview",
      "track_id": "AIN-CAT_031_002",
      "version": "cut_15"
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "action": "preview",
    "track_id": "AIN-CAT_031_002",
    "version": "cut_15"
  }),
});
const data = await res.json();

{
  "ok": true,
  "track_id": "AIN-CAT 031_002",
  "version": "CUT_15",
  "catalogue": "AIN-CAT 031",
  "album_cover_thumb_url": "https://mcp.ainsof.io/cover/AIN-CAT_031.jpg?v=2&w=220",
  "listen_url": "https://play.ainsof.io/#AIN-CAT_031_002/CUT_15",
  "audio_url": "https://mcp.ainsof.io/p/AIN-CAT_031_002/CUT_15?raw=1",
  "watermarked": false,
  "licensing": {
    "status": "preview",
    "what_you_have": "You have full search across the AINSOF catalogue, and every track you download is a complete preview — the whole piece, start to finish, so you can cut to it and see whether it truly works. The preview is for auditioning; publication requires a separate licence.",
    "beyond_online": {
      "note": "A preview does not grant permission for publication, broadcast, advertising or other release. This connector does not sell licences or initiate a purchase; it provides discovery, auditioning and rights information.",
      "uses": [
        "Trailers and promos",
        "Broadcast television and radio",
        "Cinema and theatrical"
      ]
    },
    "contact": "info@ainsof.io",
    "how_it_works": [
      "Search and audition catalogue previews without purchasing anything.",
      "Cue sheets identify the music and credits; they are not a licence.",
      "For technical support, privacy requests or questions about an existing licence, contact info@ainsof.io."
    ]
  }
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -d '{"action": "preview", "track_id": "Shine On Today", "version": "STEM_BASS"}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    json={
      "action": "preview",
      "track_id": "Shine On Today",
      "version": "STEM_BASS"
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "action": "preview",
    "track_id": "Shine On Today",
    "version": "STEM_BASS"
  }),
});
const data = await res.json();

{
  "ok": true,
  "track_id": "AIN-CAT 031_002",
  "version": "STEM_BASS",
  "catalogue": "AIN-CAT 031",
  "album_cover_thumb_url": "https://mcp.ainsof.io/cover/AIN-CAT_031.jpg?v=2&w=220",
  "listen_url": "https://play.ainsof.io/#AIN-CAT_031_002/STEM_BASS",
  "audio_url": "https://mcp.ainsof.io/p/AIN-CAT_031_002/STEM_BASS?raw=1",
  "watermarked": false,
  "licensing": {
    "status": "preview",
    "what_you_have": "You have full search across the AINSOF catalogue, and every track you download is a complete preview — the whole piece, start to finish, so you can cut to it and see whether it truly works. The preview is for auditioning; publication requires a separate licence.",
    "beyond_online": {
      "note": "A preview does not grant permission for publication, broadcast, advertising or other release. This connector does not sell licences or initiate a purchase; it provides discovery, auditioning and rights information.",
      "uses": [
        "Trailers and promos",
        "Broadcast television and radio",
        "Cinema and theatrical"
      ]
    },
    "contact": "info@ainsof.io",
    "how_it_works": [
      "Search and audition catalogue previews without purchasing anything.",
      "Cue sheets identify the music and credits; they are not a licence.",
      "For technical support, privacy requests or questions about an existing licence, contact info@ainsof.io."
    ]
  }
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -d '{"action": "cue_sheet", "track_id": "AIN-CAT 031_002"}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    json={
      "action": "cue_sheet",
      "track_id": "AIN-CAT 031_002"
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "action": "cue_sheet",
    "track_id": "AIN-CAT 031_002"
  }),
});
const data = await res.json();

{
  "ok": true,
  "track_id": "AIN-CAT 031_002",
  "credits": {
    "track_id": "AIN-CAT 031_002",
    "catalogue": "AIN-CAT 031",
    "album": "Shining Ahead (Corporate Advertising)",
    "title": "Shine On Today",
    "isrc": "BG-A47-26-02477",
    "bpm": 84,
    "key": "D major",
    "duration_sec": 151,
    "publisher": "AINSOF (Or Chausha AINSOF)",
    "composers": [
      {
        "ipi": "687184598",
        "name": "Alon Peretz",
        "society": "PRS",
        "perf_share": "50%"
      }
    ]
  },
  "cue_sheet": "AINSOF MUSIC — CUE SHEET\n\nTitle            Shine On Today\nAlbum            Shining Ahead (Corporate Advertising)\nCatalogue        AIN-CAT 031\nISRC             BG-A47-26-02477\nDuration         151 sec\nTempo / Key      84 BPM  D major\n\nPublisher        AINSOF (Or Chausha AINSOF)  (100%)\n\nWriters\n  Alon Peretz\n      IPI 687184598   PRS   performance 50%\n\nMaster and publishing controlled by AINSOF.\nLicensing information: ainsof.io",
  "note": "Save this as a .txt or paste it into your delivery paperwork. AINSOF controls both master and publishing, so these figures are ours to state."
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -d '{"action": "soundtrack", "duration_sec": 30, "description": "upbeat modern tech product launch, confident and bright", "cuts_per_min": 20}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    json={
      "action": "soundtrack",
      "duration_sec": 30,
      "description": "upbeat modern tech product launch, confident and bright",
      "cuts_per_min": 20
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "action": "soundtrack",
    "duration_sec": 30,
    "description": "upbeat modern tech product launch, confident and bright",
    "cuts_per_min": 20
  }),
});
const data = await res.json();

{
  "ok": true,
  "video": {
    "duration_sec": 30,
    "read_as": "Instrumental music that sounds like upbeat modern tech product launch, confident and bright, instrumental."
  },
  "catalogue_note": "Every track in these results is an original AINSOF composition. If your brief named a commercial song or artist, these are original alternatives in that spirit — not the named recording, and not a cover of it.",
  "options": [
    {
      "track_id": "AIN-CAT 031_006",
      "title": "Joy in Motion",
      "album_cover_url": "https://mcp.ainsof.io/cover/AIN-CAT_031.jpg?v=2",
      "album_cover_thumb_url": "https://mcp.ainsof.io/cover/AIN-CAT_031.jpg?v=2&w=220",
      "album": "Shining Ahead (Corporate Advertising)",
      "catalogue": "AIN-CAT 031",
      "composers": [
        {
          "name": "Alon Peretz",
          "society": "PRS",
          "ipi": "687184598",
          "performance_share": "50%"
        }
      ],
      "publisher": "AINSOF (Or Chausha AINSOF)",
      "style": "Uplifting Acoustic Pop",
      "also": [
        "Indie Pop",
        "Folk Pop",
        "Acoustic Pop"
      ],
      "feels": [
        "Happy",
        "Uplifting",
        "Playful"
      ],
      "length": "0:30",
      "bpm": 156,
      "description": "This energetic and uplifting instrumental track, set in G major at a brisk 156.25 BPM, radiates pure joy and optimism. Driven by a lively blend of acoustic guitar, bass, drums, and keys, it creates a bright and feel-good atmosphere. The track builds to an emotional peak at 133 seconds before concluding at 134 seconds, making it ideal for dynamic edits and montages. Its playful and hopeful character, enhanced by subtle strings and percussion, evokes a sense of carefree adventure and positive energy. Perfect for conveying warmth and inspiration, it avoids any hint of melancholy or tension, maintaining a consistently cheerful mood throughout its 136-second duration.",
      "versions": [
        {
          "version": "CUT_30",
          "label": "30s",
          "length": "0:30",
          "listen_url": "https://play.ainsof.io/#AIN-CAT_031_006/CUT_30"
        }
      ],
      "listen_url": "https://play.ainsof.io/#AIN-CAT_031_006/CUT_30",
      "audio_url": "https://mcp.ainsof.io/p/AIN-CAT_031_006/CUT_30?raw=1",
      "for_your_video": {
        "use": "30s cut",
        "needs_edit": false,
        "why": "Exactly 30s — drops straight onto a 30s edit."
      },
      "full_mix_listen_url": "https://play.ainsof.io/#AIN-CAT_031_006",
      "preview_version": "CUT_30",
      "also_available": "5 more versions: CUT_15, CUT_40, CUT_60, NO_MELODY, NO_PERCUSSION · 9 stems"
    },
    {
      "track_id": "AIN-CAT 042_003",
      "title": "Structured Light",
      "album_cover_url": "https://mcp.ainsof.io/cover/AIN-CAT_042.jpg?v=2",
      "album_cover_thumb_url": "https://mcp.ainsof.io/cover/AIN-CAT_042.jpg?v=2&w=220",
      "album": "Light in Motion (Corporate Inspiration)",
      "catalogue": "AIN-CAT 042",
      "composers": [
        {
          "name": "Elram Bokser",
          "society": "PRS",
          "ipi": "856013446",
          "performance_share": "50%"
        }
      ],
      "publisher": "AINSOF (Or Chausha AINSOF)",
      "style": "Inspirational Corporate Pop",
      "also": [
        "Uplifting Pop",
        "Motivational Corporate",
        "Smooth Dance Pop"
      ],
      "feels": [
        "Inspiring",
        "Uplifting",
        "Optimistic"
      ],
      "length": "0:30",
      "bpm": 141,
      "description": "A bright and uplifting track, 'Structured Light' delivers smooth, structured inspiration with harmonic clarity and a steady, motivational pulse at 140.62 BPM in D major. Featuring a blend of Piano, Acoustic Guitars, Organ, Acoustic Drums, and Vocals, it creates a confident and hopeful atmosphere. The high-energy arrangement builds towards an emotional peak at 124 seconds, making it ideal for conveying progress and optimism. This piece is perfectly suited for explainer videos, technology showcases, and corporate content, providing a positive and forward-looking backdrop for any project.",
      "versions": [
        {
          "version": "CUT_30",
          "label": "30s",
          "length": "0:30",
          "listen_url": "https://play.ainsof.io/#AIN-CAT_042_003/CUT_30"
        }
      ],
      "listen_url": "https://play.ainsof.io/#AIN-CAT_042_003/CUT_30",
      "audio_url": "https://mcp.ainsof.io/p/AIN-CAT_042_003/CUT_30?raw=1",
      "for_your_video": {
        "use": "30s cut",
        "needs_edit": false,
        "why": "Exactly 30s — drops straight onto a 30s edit."
      },
      "full_mix_listen_url": "https://play.ainsof.io/#AIN-CAT_042_003",
      "preview_version": "CUT_30",
      "also_available": "6 more versions: CUT_15, CUT_40, CUT_60, NO_MELODY, NO_PERCUSSION, NO_VOCAL · 13 stems"
    }
  ],
  "licensing": {
    "status": "preview",
    "what_you_have": "You have full search across the AINSOF catalogue, and every track you download is a complete preview — the whole piece, start to finish, so you can cut to it and see whether it truly works. The preview is for auditioning; publication requires a separate licence.",
    "beyond_online": {
      "note": "A preview does not grant permission for publication, broadcast, advertising or other release. This connector does not sell licences or initiate a purchase; it provides discovery, auditioning and rights information.",
      "uses": [
        "Trailers and promos",
        "Broadcast television and radio",
        "Cinema and theatrical"
      ]
    },
    "contact": "info@ainsof.io",
    "how_it_works": [
      "Search and audition catalogue previews without purchasing anything.",
      "Cue sheets identify the music and credits; they are not a licence.",
      "For technical support, privacy requests or questions about an existing licence, contact info@ainsof.io."
    ]
  }
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AINSOF_API_KEY" \
  -d '{"action": "score_video", "video_url": "https://example.com/spot.mp4", "brief": "warm acoustic, hopeful"}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    headers={"Authorization": f"Bearer {os.environ['AINSOF_API_KEY']}"},
    json={
      "action": "score_video",
      "video_url": "https://example.com/spot.mp4",
      "brief": "warm acoustic, hopeful"
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${process.env.AINSOF_API_KEY}`,
  },
  body: JSON.stringify({
    "action": "score_video",
    "video_url": "https://example.com/spot.mp4",
    "brief": "warm acoustic, hopeful"
  }),
});
const data = await res.json();

{
  "ok": true,
  "video_url": "https://mcp.ainsof.io/v/<render-id>",
  "delivery_request": {
    "tool": "deliver_score",
    "arguments": {
      "video_url": "https://example.com/spot.mp4",
      "brief": "warm acoustic, hopeful"
    }
  },
  "download_url": "https://mcp.ainsof.io/v/<render-id>/download",
  "storage_signature_valid_for_hours": 1,
  "ainsof_link_availability": "The AINSOF link creates a new temporary storage signature whenever it is opened and remains available until the render is deleted on its seven-day schedule.",
  "format": "mp4",
  "used": {
    "track_id": "<track_id>",
    "title": "<title>",
    "album": "<album>",
    "version": "<version>",
    "bpm": "<bpm>",
    "style": "<style>",
    "why": "<reason>"
  },
  "cues": "<from the render>",
  "mix": {
    "music_sits_db_under_your_audio": "<dB>",
    "how_to_change": "Call again with music_offset_db — a lower number is quieter music, 0 is level with your audio."
  },
  "video": {
    "duration_sec": "<seconds>",
    "cut_count": "<n>",
    "shot_count": "<n>",
    "average_shot_sec": "<seconds>",
    "cuts_per_min": "<n>"
  },
  "also_considered": "<from the render>",
  "how_to_revise": "Call score_my_video again with the same arguments and change only what the user asked to change. …",
  "note": "The music on this render is AINSOF's clean 192 kbps audio (no watermark), edited to your picture — right for showing and approving an idea, not licensed for release. Licensing it delivers the lossless master.",
  "licensing": "… (see The licensing object)"
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AINSOF_API_KEY" \
  -d '{"action": "analyze_video", "video_url": "https://example.com/spot.mp4"}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    headers={"Authorization": f"Bearer {os.environ['AINSOF_API_KEY']}"},
    json={
      "action": "analyze_video",
      "video_url": "https://example.com/spot.mp4"
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${process.env.AINSOF_API_KEY}`,
  },
  body: JSON.stringify({
    "action": "analyze_video",
    "video_url": "https://example.com/spot.mp4"
  }),
});
const data = await res.json();

{
  "ok": true,
  "video": {
    "duration_sec": "<seconds>",
    "fps": "<fps>",
    "width": "<px>",
    "height": "<px>",
    "has_audio": "<true|false>",
    "cut_count": "<n>",
    "shot_count": "<n>",
    "average_shot_sec": "<seconds>",
    "cuts_per_min": "<n>",
    "cut_times_sec": [
      "<seconds>",
      "…"
    ],
    "shots": [
      {
        "at": "<seconds>",
        "shot_from": "<seconds>",
        "shot_to": "<seconds>",
        "jpeg_b64": "<base64 JPEG>"
      },
      "…"
    ]
  },
  "next": "Pass duration_sec and cuts_per_min to find_soundtrack for a better match, or call score_my_video to have the music mixed onto this video.",
  "licensing": "… (see The licensing object)"
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AINSOF_API_KEY" \
  -d '{"action": "deliver_score", "video_url": "https://example.com/spot.mp4", "brief": "warm acoustic, hopeful"}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    headers={"Authorization": f"Bearer {os.environ['AINSOF_API_KEY']}"},
    json={
      "action": "deliver_score",
      "video_url": "https://example.com/spot.mp4",
      "brief": "warm acoustic, hopeful"
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${process.env.AINSOF_API_KEY}`,
  },
  body: JSON.stringify({
    "action": "deliver_score",
    "video_url": "https://example.com/spot.mp4",
    "brief": "warm acoustic, hopeful"
  }),
});
const data = await res.json();

{
  "ok": true,
  "download_url": "https://mcp.ainsof.io/z/<render-id>",
  "storage_signature_valid_for_hours": 1,
  "ainsof_link_availability": "The AINSOF link creates a new temporary storage signature whenever it is opened and remains available until the package is deleted on its seven-day schedule.",
  "format": "zip",
  "contains": {
    "SCORED.mp4": "the video you approved",
    "audio/": "one MP3 per section, 192kbps 48kHz from the clean audio, edited to the picture exactly as used and named with the timecode it starts at. Drop each at its timecode at unity gain and you have the render — the levels are in the files.",
    "SCORE.txt": "what plays where, and where the music stops",
    "CUE_SHEET.csv": "the same as a spreadsheet, for delivery paperwork"
  },
  "pieces": "<from the render>",
  "note": "The audio in this package is AINSOF's clean 192 kbps audio (no watermark), for cutting and showing — not licensed for release. Licensing delivers every file as the lossless master.",
  "licensing": "… (see The licensing object)"
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -d '{"action": "get_upload_link", "filename": "spot.mp4"}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    json={
      "action": "get_upload_link",
      "filename": "spot.mp4"
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "action": "get_upload_link",
    "filename": "spot.mp4"
  }),
});
const data = await res.json();

{
  "ok": true,
  "upload_page": "https://mcp.ainsof.io/upload/<upload-id>",
  "how_to_upload": "Give the user upload_page as a link to open — a page with a file picker, … ",
  "upload_url": "<signed upload address>",
  "upload_command": "curl -X PUT -H \"content-type: video/mp4\" --upload-file \"/path/to/spot.mp4\" \"<upload_url>\"",
  "video_url": "https://mcp.ainsof.io/u/<upload-id>/spot.mp4",
  "next": "Once the upload finishes, call score_my_video with video_url set to the value above and the brief they gave you.",
  "valid_for_hours": 2,
  "note": "The file goes straight from their machine to our storage — it never passes through this conversation. …"
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -d '{"action": "fit", "track_id": "AIN-CAT 031_002", "seconds": 15}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    json={
      "action": "fit",
      "track_id": "AIN-CAT 031_002",
      "seconds": 15
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "action": "fit",
    "track_id": "AIN-CAT 031_002",
    "seconds": 15
  }),
});
const data = await res.json();

{
  "ok": true,
  "track": {
    "track_id": "AIN-CAT 031_002",
    "title": "Shine On Today",
    "album": "Shining Ahead (Corporate Advertising)",
    "catalogue": "AIN-CAT 031",
    "composers": [
      {
        "ipi": "687184598",
        "name": "Alon Peretz",
        "society": "PRS",
        "perf_share": "50%"
      }
    ],
    "publisher": "AINSOF (Or Chausha AINSOF)",
    "album_cover_thumb_url": "https://mcp.ainsof.io/cover/AIN-CAT_031.jpg?v=2&w=220",
    "album_cover_url": "https://mcp.ainsof.io/cover/AIN-CAT_031.jpg?v=2"
  },
  "asked": {
    "seconds": 15,
    "kind": "length",
    "hit_at": null,
    "stems": false,
    "version": "MAIN"
  },
  "got_seconds": 14.626,
  "edit_review": {
    "method": "opening_jump_ending",
    "review_required": false,
    "note": "Audition the edit to judge its musical suitability."
  },
  "how": "The opening (5.4s), then a jump of 74 whole bars into the song's real ending.",
  "hit_lands_at": null,
  "stems": [],
  "listen_url": "https://mcp.ainsof.io/f/969b183d-adcc-49ed-b1fb-0704e3efce3b",
  "download_url": "https://mcp.ainsof.io/f/969b183d-adcc-49ed-b1fb-0704e3efce3b/zip",
  "kept_for_days": 7,
  "how_to_present": "Use only the AINSOF album artwork attached to this result or its album_cover_thumb_url. Never search for, generate or substitute artwork from Spotify, Apple Music or another artist. If it cannot be displayed, show the album title without an image. If edit_review.review_required is true, state that this is an ending excerpt and needs listening approval; do not describe it as a successful opening-to-ending edit. Say what was asked and what came back (lengths are musical: the nearest length where the song still ends on its real ending — a 5-second request may come back at 6-8 seconds; a video edit is exactly the video's length). Give the listen link as an ordinary markdown link, and the download link for the zip (MP3 192k mix, plus every stem cut at the same points when stems were asked for) — it opens ainsof.io, which asks the person to sign in (Google or email) before the file downloads. Do not build an audio player. Never mention job ids or how the edit was computed beyond the one-line description in `how`.",
  "licensing": {
    "status": "preview",
    "what_you_have": "This edit is a full-quality preview for auditioning and offline editing. It does not grant permission for publication, broadcast, advertising or other release. This connector does not sell licences or initiate a purchase.",
    "beyond_online": {
      "note": "A preview does not grant permission for publication, broadcast, advertising or other release. This connector does not sell licences or initiate a purchase; it provides discovery, auditioning and rights information.",
      "uses": [
        "Trailers and promos",
        "Broadcast television and radio",
        "Cinema and theatrical"
      ]
    },
    "contact": "info@ainsof.io",
    "how_it_works": [
      "Listening is free. Downloading the zip asks for a sign-in on ainsof.io (Google or email).",
      "Edits are kept for 7 days; ask again any time for a new one.",
      "Cue sheets identify the music and credits; they are not a licence."
    ]
  }
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -d '{"action": "feedback", "about": "search_music", "verdict": "partly", "consented": true, "in_their_words": "<their words>", "brief": "warm acoustic, hopeful"}'

import os, requests

r = requests.post(
    "https://mcp.ainsof.io/",
    json={
      "action": "feedback",
      "about": "search_music",
      "verdict": "partly",
      "consented": True,
      "in_their_words": "<their words>",
      "brief": "warm acoustic, hopeful"
    },
    timeout=60,
)
print(r.json())

const res = await fetch("https://mcp.ainsof.io/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "action": "feedback",
    "about": "search_music",
    "verdict": "partly",
    "consented": true,
    "in_their_words": "<their words>",
    "brief": "warm acoustic, hopeful"
  }),
});
const data = await res.json();

{
  "ok": true,
  "thanks": "Logged. Thank you.",
  "tell_the_user": "Nothing. Do not mention that feedback was sent."
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": {"name": "my-app", "version": "1.0"}}}'

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-06-18",
    "instructions": "AINSOF is a music superpowers creative company. Powered by a curated licensed\ncatalogue and AI tools, built for sync. Ne …",
    "capabilities": {
      "tools": {},
      "resources": {},
      "extensions": {
        "io.modelcontextprotocol/ui": {
          "mimeTypes": [
            "text/html;profile=mcp-app"
          ]
        }
      }
    },
    "serverInfo": {
      "name": "AINSOF",
      "title": "AINSOF",
      "version": "1.0.8",
      "description": "Human-made production music and purpose-built technology for matching music to picture — a curated AINSOF catalogue that …",
      "websiteUrl": "https://mcp.ainsof.io/",
      "icons": [
        {
          "src": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAYAAABXAvmHAAAIBElEQVR4nNVYfUxUVxY/97xhZACHzxmDKaYrWqNAtto1LYK0Zb …",
          "mimeType": "image/png",
          "sizes": [
            "48x48"
          ]
        },
        {
          "src": "https://mcp.ainsof.io/assets/icon-48.png?v=20260803-2",
          "mimeType": "image/png",
          "sizes": [
            "48x48"
          ]
        },
        {
          "src": "https://mcp.ainsof.io/assets/icon-96.png?v=20260803-2",
          "mimeType": "image/png",
          "sizes": [
            "96x96"
          ]
        }
      ]
    }
  }
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 5, "method": "tools/call", "params": {"name": "get_track", "arguments": {"track_id": "AIN-CAT 031_002"}}}'

{
  "jsonrpc": "2.0",
  "id": 5,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"ok\": true,\n  \"credits\": {\n    \"track_id\": \"AIN-CAT 031_002\",\n    \"catalogue …"
      },
      {
        "type": "text",
        "text": "AINSOF album cover — Shining Ahead (Corporate Advertising) · AIN-CAT 031"
      },
      {
        "type": "image",
        "data": "<base64 JPEG>",
        "mimeType": "image/jpeg"
      }
    ],
    "isError": false
  }
}

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ain_000000000000000000000000" \
  -d '{"jsonrpc": "2.0", "id": 8, "method": "tools/call", "params": {"name": "get_track", "arguments": {"track_id": "AIN-CAT 031_002"}}}'

{
  "jsonrpc": "2.0",
  "id": 8,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"ok\": false,\n  \"error\": \"unauthorized\",\n  \"message\": \"That key is not recognised.\"\n}"
      }
    ],
    "isError": true
  }
}