API et MCP

Serveur MCP

Un serveur MCP pour trouver des morceaux depuis un agent IA. Il parle Streamable HTTP et ne conserve aucune session : un client compatible n'a besoin que de l'URL.

https://arcalune.com/mcp

Configuration du client

{
  "mcpServers": {
    "arcalune-music": {
      "type": "http",
      "url": "https://arcalune.com/mcp"
    }
  }
}

claude mcp add --transport http arcalune-music https://arcalune.com/mcp

Outils

search_tracks

Search Arcalune Music for royalty-free BGM, sound effects, and video game fan arrangements. Every track streams on YouTube, and the returned youtubeUrl jumps straight to where that track starts. When presenting results to a user, always include the youtubeUrl so they can listen to the track. Free BGM and sound effects allow commercial use without credit; fan arrangements are streaming-only.

get_track

Get one track by id, together with related tracks from the same catalog. Returns the YouTube URL with the track's start position, the track page, and the download URL when the audio is distributed.

list_tags

List every tag that can be passed to search_tracks, grouped by production use, genre, mood, usage, scene, source game, and usage rights, with how many tracks carry each tag.

API REST

Une API JSON pour rechercher des morceaux, récupérer un morceau et lister les étiquettes. Le CORS est ouvert à toutes les origines : vous pouvez donc l'appeler directement depuis le navigateur.

Points d'accès

GET https://arcalune.com/api/v1/tracks
GET https://arcalune.com/api/v1/tracks/{id}
GET https://arcalune.com/api/v1/tags

Paramètres de requête (GET /api/v1/tracks)

qstring

Free text over titles, descriptions, and tag names (ja + en).

tagstring

Tag id. Repeat or comma-separate for an OR filter.

categoryall | bgm | se | arrangement

Catalog to search. Defaults to all.

downloadabletrue | false

Filter by whether the audio file is distributed.

sortdefault | newest | title | plays30d | playsAll | favorites | downloads30d | downloadsAll

Result order. Defaults to default (newest first).

limitinteger (max 100)

Page size. Defaults to 20.

offsetinteger

Number of tracks to skip. Defaults to 0.

localeja | en | es | pt | hi | id | fr

Language used for track titles, descriptions, and tag names.

Exemple de réponse

curl "https://arcalune.com/api/v1/tracks?category=bgm&tag=lofi&limit=1"

{
  "total": 150,
  "limit": 20,
  "offset": 0,
  "tracks": [
    {
      "id": "kohaku",
      "title": { "ja": "琥珀の書斎", "en": "The Amber Study" },
      "category": "original",
      "durationSeconds": 188,
      "tags": [{ "id": "lofi", "label": { "ja": "Lo-fi", "en": "Lo-fi" }, "group": "genre" }],
      "youtubeUrl": "https://www.youtube.com/watch?v=4i5aoHjXizI",
      "youtubeVideoId": "4i5aoHjXizI",
      "startSeconds": 0,
      "pageUrl": "https://arcalune.com/tracks/kohaku",
      "imageUrl": "https://arcalune.com/track-images/kohaku",
      "downloadUrl": "https://arcalune.com/api/tracks/kohaku/download",
      "isArrangement": false,
      "usage": {
        "type": "free-download",
        "commercialUse": true,
        "creditRequired": false,
        "restrictions": ["no-standalone-redistribution", "no-ai-training"],
        "termsUrl": "https://arcalune.com/about#usage-guide"
      },
      "publishedAt": "2026-07-21T00:00:00.000Z"
    }
  ]
}

Le tri par popularité (sort=plays30d, etc.) repose sur les écoutes, téléchargements et favoris signalés par le navigateur, comptés une fois par jour. L'émetteur n'étant pas authentifié, ce ne sont pas des valeurs mesurées : l'API ne renvoie pas les chiffres eux-mêmes. Considérez cet ordre comme une simple indication.

Essayer ici

Choisissez les paramètres et lancez la requête directement depuis cette page. Aucune authentification n'est nécessaire, et la réponse s'affiche telle quelle.

curl "https://arcalune.com/api/v1/tracks"

Lecture sur YouTube

Une vidéo contient généralement plusieurs morceaux : le lien vers un morceau précis a donc besoin de son point de départ. youtubeUrl l'inclut déjà — utilisez-le tel quel chaque fois que vous présentez un morceau.

https://www.youtube.com/watch?v=2qQ11AVavBQ&t=1233s

Conditions d'utilisation

La musique de fond et les effets sonores gratuits peuvent être utilisés commercialement sans mention de crédit. Les arrangements de fans sont non officiels, réservés à l'écoute, et ne peuvent pas être réutilisés comme ressource. Le champ usage de chaque réponse porte les conditions du morceau concerné.