API e MCP

Servidor MCP

Um servidor MCP para encontrar faixas a partir de um agente de IA. Ele fala Streamable HTTP e não mantém sessão, então um cliente compatível só precisa da URL.

https://arcalune.com/mcp

Configuração do cliente

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

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

Ferramentas

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

Uma API JSON para buscar faixas, obter uma faixa e listar etiquetas. O CORS está aberto para qualquer origem, então você pode chamá-la direto do 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.

Exemplo de resposta

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

A ordenação por popularidade (sort=plays30d e afins) baseia-se em reproduções, downloads e favoritos informados pelo navegador, contados uma vez por dia. Quem envia não é autenticado, então não são valores medidos — a API não devolve os números em si. Trate a ordem como uma dica.

Teste aqui

Escolha os parâmetros e dispare a requisição direto desta página. Não é preciso autenticação, e a resposta aparece exatamente como chega.

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

Reprodução no YouTube

Um vídeo geralmente traz várias faixas, então o link para uma faixa específica precisa do ponto de início. O youtubeUrl já inclui esse ponto — use-o como está sempre que apresentar uma faixa.

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

Condições de uso

A BGM gratuita e os efeitos sonoros podem ser usados comercialmente sem crédito. Os arranjos de fã são não oficiais, só para ouvir, e não podem ser reaproveitados como material. O campo usage de cada resposta traz as condições daquela faixa.