Tunetank MCP

Servidor MCP Tunetank

O catálogo de música e efeitos sonoros do Tunetank como um servidor MCP — para que qualquer assistente de IA (Claude, ChatGPT, Cursor, …) possa encontrar a faixa ou efeito sonoro royalty-free ideal para um vídeo, anúncio, podcast ou transmissão.

Faça perguntas como "encontre uma faixa de rock energética com cerca de 60 segundos para uma introdução no YouTube" ou "um efeito sonoro de whoosh com menos de 2 segundos" e o assistente pesquisa o catálogo real do Tunetank e retorna um link de prévia junto com a página da faixa em tunetank.com.

• 🎵 Pesquise música por humor, gênero, tema, artista, nome e duração alvo (± tolerância)
• 🔊 Pesquise efeitos sonoros (SFX) por categoria e duração
• 📚 Navegue por gêneros, humores, temas e playlists selecionadas
• ▶️ Cada resultado inclui uma URL de prévia de áudio e a página canônica da faixa (https://tunetank.com/track/<id>-<slug>/)
• 🆓 Completamente gratuito — sem chave de API, sem autenticação, sem inscrição para limite de taxa. Somente leitura.

---

Servidor

Endpoint	https://mcp.tunetank.com
Transporte	HTTP Transmissível (JSON‑RPC 2.0)
Autenticação	Nenhuma (público, somente leitura)
Custo	Gratuito

---

Configuração

Aponte qualquer cliente compatível com MCP para o endpoint acima. Exemplos para clientes comuns:

Claude Desktop / Claude.ai (Conectores)

Adicione um Conector Personalizado com a URL:

https://mcp.tunetank.com

Ou, através do arquivo de configuração (claude_desktop_config.json) usando a ponte mcp-remote:

{
  "mcpServers": {
    "tunetank": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tunetank.com"]
    }
  }
}

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "tunetank": {
      "url": "https://mcp.tunetank.com"
    }
  }
}

VS Code / outros clientes

Qualquer cliente que suporte servidores MCP remotos (HTTP) — basta usar a URL https://mcp.tunetank.com. Para clientes que só se comunicam via stdio, faça a ponte com npx -y mcp-remote https://mcp.tunetank.com.

---

Ferramentas

Ferramenta	Argumentos	Retorna
search_music	query, name, artist, genre, mood, theme, duration, tolerance, limit	Faixas: nome, artista, duração, bpm, URL de prévia, URL da página da faixa, gêneros/humores/temas
search_sfx	query, category, duration, tolerance, limit	Efeitos sonoros: nome, duração, URL de prévia, forma de onda
list_genres	—	Todos os gêneros musicais (id, name, alias)
list_moods	—	Todos os humores musicais (id, name, alias)
list_themes	—	Todos os temas musicais (id, name, alias)
list_playlists	limit	Playlists selecionadas (nome, descrição, contagem de faixas)

Notas sobre os argumentos

• query (search_music) — texto livre; corresponde ao nome da faixa ou ao nome do artista.
• genre / mood / theme — aceitam um nome/apelido (ex.: "rock", "happy") ou um id numérico (das ferramentas list_*).
• duration — duração alvo em segundos.
• tolerance — ± segundos permitidos em torno de duration (padrão 5). Exemplo: duration: 60, tolerance: 10 → faixas entre 50s e 70s.
• category (search_sfx) — nome ou id da categoria de SFX.
• limit — máximo de resultados (padrão 20, máx. 50; playlists padrão 50, máx. 200).

Todos os filtros de string são parciais e não diferenciam maiúsculas de minúsculas. Apenas faixas/SFX publicados são retornados.

---

Exemplos

"Rock energético, ~60s, para uma introdução"

{
  "name": "search_music",
  "arguments": { "genre": "rock", "mood": "energetic", "duration": 60, "tolerance": 10, "limit": 5 }
}

"Um efeito sonoro de whoosh curto com menos de 2 segundos"

{
  "name": "search_sfx",
  "arguments": { "query": "whoosh", "duration": 1.5, "tolerance": 1.5 }
}

Exemplo de resultado de faixa

{
  "id": 2270,
  "name": "Adventures",
  "artist": "A Himitsu",
  "duration": 138,
  "bpm": 120,
  "url": "https://tunetank.com/track/2270-adventures/",
  "preview": "https://…/preview.mp3",
  "genres": ["Pop"],
  "moods": ["Happy", "Inspiring"],
  "themes": ["Vlog"]
}

---

Experimente (JSON‑RPC bruto)

O transporte é estritamente conforme a especificação, então inclua ambos os cabeçalhos Content-Type e Accept:

# List available tools
curl -s https://mcp.tunetank.com \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Search music
curl -s https://mcp.tunetank.com \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_music","arguments":{"mood":"happy","duration":60,"tolerance":10,"limit":3}}}'

---

Licenciamento

Toda a música é gratuita para uso pessoal e não comercial.

Para qualquer outra finalidade (projetos comerciais, anúncios, conteúdo monetizado, trabalho para clientes, etc.), acesse tunetank.com e revise os termos de licenciamento lá.

---

Sobre

A música e os efeitos sonoros vêm do Tunetank — áudio royalty-free para criadores. Este servidor MCP é um canal de descoberta: ele retorna prévias e páginas de faixas para que você possa ouvir e obter a faixa em tunetank.com. O download e o licenciamento ocorrem no site.

Dúvidas ou problemas? Entre em contato em support@tunetank.com.