API y MCP

Todo el catálogo se puede consultar mediante una API REST y un servidor MCP. Ninguno necesita clave de API ni autenticación, y ambos devuelven las mismas pistas. El audio vive en YouTube, y cada URL que devolvemos empieza justo donde empieza esa pista.

Servidor MCP

Un servidor MCP para encontrar pistas desde un agente de IA. Habla Streamable HTTP y no mantiene sesión, así que a un cliente compatible le basta con la URL.

https://arcalune.com/mcp

Configuración del cliente

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

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

Herramientas

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

Una API JSON para buscar pistas, obtener una sola pista y listar etiquetas. CORS está abierto a cualquier origen, así que puedes llamarla directamente desde el navegador.

Endpoints

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

Parámetros de consulta (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.

Ejemplo de respuesta

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"
    }
  ]
}

El orden por popularidad (sort=plays30d y similares) se basa en reproducciones, descargas y favoritos que informa el navegador, contados una vez al día. Quien los envía no está autenticado, así que no son valores medidos: la API no devuelve las cifras en sí. Tómalo como una pista para ordenar.

Pruébalo aquí

Elige los parámetros y lanza la petición desde esta misma página. No hace falta autenticación y la respuesta se muestra tal cual llega.

Endpoint

tag

Reproducción en YouTube

Un vídeo suele contener varias pistas, así que el enlace a una pista concreta necesita su punto de inicio. youtubeUrl ya lo incluye: úsalo tal cual siempre que presentes una pista.

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

Condiciones de uso

La BGM gratuita y los efectos de sonido se pueden usar comercialmente sin dar crédito. Los arreglos de aficionado son no oficiales, solo para escuchar, y no se pueden reutilizar como material. El campo usage de cada respuesta lleva las condiciones de esa pista.

Leer la guía de uso