API & MCP
The whole catalog is searchable through a REST API and an MCP server. Neither requires an API key or any authentication, and both return the same tracks. The audio itself lives on YouTube, and every URL we return starts playback where that track begins. If you write your own HTTP client, set the User-Agent to your application's real name and version from the very first request. If you receive a Cloudflare 1010 error, stop automatic retries and inspect the response body and the Ray ID.
MCP server
An MCP server for finding tracks from an AI agent. It speaks Streamable HTTP and keeps no session, so a compatible client only needs the URL.
https://arcalune.com/mcpClient configuration
{
"mcpServers": {
"arcalune-music": {
"type": "http",
"url": "https://arcalune.com/mcp"
}
}
}claude mcp add --transport http arcalune-music https://arcalune.com/mcpTools
- search_tracks
- Search Arcalune Music for free BGM and sound effects, plus streaming-only video game fan arrangements and original vocal songs. Every track streams on YouTube, and the returned youtubeUrl jumps straight to where that track starts. Recommend a track as reusable audio only when usage.type is "free-download", downloadUrl is present, and usage permits the intended use. Check commercial permission, attribution, and restrictions in usage. For listening, share pageUrl and the timestamped youtubeUrl.
- 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.
REST API
A JSON API for searching tracks, fetching a single track, and listing tags. CORS is open to every origin, so you can call it straight from the browser.
Endpoints
GET https://arcalune.com/api/v1/tracks
GET https://arcalune.com/api/v1/tracks/{id}
GET https://arcalune.com/api/v1/tagsQuery parameters (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 | song | 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 of track titles, descriptions, and page URLs. Tag labels include all supported languages.
Example response
curl "https://arcalune.com/api/v1/tracks?category=bgm&tag=lofi&limit=1&locale=en"This example was captured in English from the public API. The total and returned tracks can change as the catalog changes.
{
"total": 5,
"limit": 1,
"offset": 0,
"tracks": [
{
"id": "candy-land-06-soda-rain",
"title": "Soda Rain",
"description": "Soda bubbles fall like rain over the candy kingdom. Cute chill hop with a mellow electric piano, as background for work or chatty streams.",
"category": "original",
"durationSeconds": 270,
"tags": [
{
"id": "downloadable",
"label": {
"ja": "ダウンロード可",
"en": "Free download",
"es": "Descarga gratuita",
"pt": "Download gratuito",
"hi": "मुफ़्त डाउनलोड",
"id": "Unduhan gratis",
"fr": "Téléchargement gratuit"
},
"group": "access"
},
{
"id": "lofi",
"label": {
"ja": "Lo-fi",
"en": "Lo-fi",
"es": "Lo-fi",
"pt": "Lo-fi",
"hi": "Lo-fi",
"id": "Lo-fi",
"fr": "Lo-fi"
},
"group": "genre"
},
{
"id": "cute",
"label": {
"ja": "かわいい",
"en": "Cute",
"es": "Adorable",
"pt": "Fofo",
"hi": "प्यारा",
"id": "Menggemaskan",
"fr": "Mignon"
},
"group": "mood"
},
{
"id": "chill",
"label": {
"ja": "チル",
"en": "Chill",
"es": "Relajado",
"pt": "Relaxante",
"hi": "सुकून",
"id": "Santai",
"fr": "Détendu"
},
"group": "mood"
},
{
"id": "rain",
"label": {
"ja": "雨",
"en": "Rain",
"es": "Lluvia",
"pt": "Chuva",
"hi": "बारिश",
"id": "Hujan",
"fr": "Pluie"
},
"group": "mood"
},
{
"id": "streaming",
"label": {
"ja": "生配信",
"en": "Streaming",
"es": "Directos",
"pt": "Lives",
"hi": "लाइव स्ट्रीम",
"id": "Siaran langsung",
"fr": "Direct"
},
"group": "usage"
},
{
"id": "video-production",
"label": {
"ja": "動画・配信",
"en": "Video & streaming",
"es": "Vídeo y directos",
"pt": "Vídeo e lives",
"hi": "वीडियो और स्ट्रीम",
"id": "Video & siaran",
"fr": "Vidéo et direct"
},
"group": "purpose"
}
],
"youtubeUrl": "https://www.youtube.com/watch?v=XR-j50V8SIU&t=1319s",
"youtubeVideoId": "XR-j50V8SIU",
"startSeconds": 1319,
"pageUrl": "https://arcalune.com/en/tracks/candy-land-06-soda-rain",
"imageUrl": "https://arcalune.com/track-images/candy-land-06-soda-rain",
"downloadUrl": "https://arcalune.com/api/tracks/candy-land-06-soda-rain/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-11-05"
}
]
}Popularity ordering (sort=plays30d and the like) is based on plays, downloads, and favorites reported by the browser, deduplicated to one per day. The sender is not authenticated, so these are not measured values — the counts themselves are not returned by the API. Treat the order as a hint.
Try it here
Pick the parameters and send the request straight from this page. No authentication is needed, and the response is shown exactly as it comes back.
curl "https://arcalune.com/api/v1/tracks"Playback on YouTube
One video usually holds several tracks, so a link to a single track needs its start position. youtubeUrl already includes it — use it as-is whenever you present a track.
https://www.youtube.com/watch?v=XR-j50V8SIU&t=1319sUsage terms
Before recommending a track for a video or another project, check that usage.type is free-download, downloadUrl is present, and the terms in usage cover the intended use. Downloadable BGM and sound effects can be used commercially without attribution under those terms. For listening, use youtubeUrl to start at the beginning of the track. Fan arrangements and original vocal songs are for listening only.
Read the usage guide