Tunetank MCP

Serveur MCP Tunetank

Le catalogue de musique et d'effets sonores Tunetank en tant que serveur MCP — pour que tout assistant IA (Claude, ChatGPT, Cursor, …) puisse trouver la piste ou l'effet sonore libre de droits idéal pour une vidéo, une publicité, un podcast ou un stream.

Posez des questions comme « trouve un morceau rock énergique d'environ 60 secondes pour une intro YouTube » ou « un effet sonore whoosh de moins de 2 secondes » et l'assistant recherche dans le catalogue réel de Tunetank et renvoie un lien de prévisualisation ainsi que la page de la piste sur tunetank.com.

• 🎵 Recherchez de la musique par humeur, genre, thème, artiste, nom et durée cible (± tolérance)
• 🔊 Recherchez des effets sonores (SFX) par catégorie et durée
• 📚 Parcourez les genres, humeurs, thèmes et playlists organisées
• ▶️ Chaque résultat inclut une URL de prévisualisation audio et la page canonique de la piste (https://tunetank.com/track/<id>-<slug>/)
• 🆓 Totalement gratuit — pas de clé API, pas d'authentification, pas d'inscription pour une limite de débit. Lecture seule.

---

Serveur

Point de terminaison	https://mcp.tunetank.com
Transport	HTTP streamable (JSON‑RPC 2.0)
Authentification	Aucune (public, lecture seule)
Coût	Gratuit

---

Configuration

Pointez n'importe quel client compatible MCP vers le point de terminaison ci-dessus. Exemples pour les clients courants :

Claude Desktop / Claude.ai (Connecteurs)

Ajoutez un Connecteur personnalisé avec l'URL :

https://mcp.tunetank.com

Ou, via le fichier de configuration (claude_desktop_config.json) en utilisant le pont 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 / autres clients

Tout client prenant en charge les serveurs MCP distants (HTTP) — utilisez simplement l'URL https://mcp.tunetank.com. Pour les clients qui ne prennent en charge que stdio, faites le pont avec npx -y mcp-remote https://mcp.tunetank.com.

---

Outils

Outil	Arguments	Retourne
search_music	query, name, artist, genre, mood, theme, duration, tolerance, limit	Pistes : nom, artiste, durée, bpm, URL de prévisualisation, URL de la page de la piste, genres/humeurs/thèmes
search_sfx	query, category, duration, tolerance, limit	Effets sonores : nom, durée, URL de prévisualisation, forme d'onde
list_genres	—	Tous les genres musicaux (id, name, alias)
list_moods	—	Toutes les humeurs musicales (id, name, alias)
list_themes	—	Tous les thèmes musicaux (id, name, alias)
list_playlists	limit	Playlists organisées (nom, description, nombre de pistes)

Notes sur les arguments

• query (search_music) — texte libre ; correspond au nom de la piste ou au nom de l'artiste.
• genre / mood / theme — acceptent soit un nom/alias (par ex. "rock", "happy") soit un identifiant numérique (provenant des outils list_*).
• duration — durée cible en secondes.
• tolerance — ± secondes autorisées autour de duration (par défaut 5). Exemple : duration: 60, tolerance: 10 → pistes entre 50s et 70s.
• category (search_sfx) — nom ou identifiant de la catégorie SFX.
• limit — résultats max (par défaut 20, max 50 ; playlists par défaut 50, max 200).

Tous les filtres de chaîne sont des correspondances partielles, insensibles à la casse. Seules les pistes/SFX publiés sont retournés.

---

Exemples

« Rock énergique, ~60s, pour une intro »

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

« Un effet sonore whoosh court de moins de 2 secondes »

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

Exemple de résultat de piste

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

---

Essayez-le (JSON‑RPC brut)

Le transport est strictement conforme à la spécification, incluez donc les en-têtes Content-Type et 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}}}'

---

Licence

Toute la musique est libre d'utilisation à des fins personnelles et non commerciales.

Pour tout autre usage (projets commerciaux, publicités, contenu monétisé, travail pour des clients, etc.), rendez-vous sur tunetank.com et consultez les conditions de licence qui s'y trouvent.

---

À propos

La musique et les effets sonores proviennent de Tunetank — audio libre de droits pour les créateurs. Ce serveur MCP est un canal de découverte : il renvoie des prévisualisations et des pages de pistes pour que vous puissiez écouter et récupérer la piste sur tunetank.com. Le téléchargement et l'octroi de licence se font sur le site.

Des questions ou des problèmes ? Contactez-nous à support@tunetank.com.