Tunetank MCP

Tunetank MCP Server

Der Musik- und Soundeffekte-Katalog von Tunetank als MCP-Server — damit jeder KI-Assistent (Claude, ChatGPT, Cursor, …) den passenden lizenzfreien Track oder SFX für ein Video, eine Werbung, einen Podcast oder Stream finden kann.

Stellen Sie Fragen wie „Finde einen energiegeladenen Rock-Track mit etwa 60 Sekunden für ein YouTube-Intro“ oder „einen Whoosh-SFX unter 2 Sekunden“ und der Assistent durchsucht den echten Katalog von Tunetank und gibt einen Vorschau-Link sowie die Track-Seite auf tunetank.com zurück.

• 🎵 Musik suchen nach Stimmung, Genre, Thema, Künstler, Name und Ziellänge (± Toleranz)
• 🔊 Soundeffekte (SFX) suchen nach Kategorie und Länge
• 📚 Genres, Stimmungen, Themen und kuratierte Playlists durchstöbern
• ▶️ Jedes Ergebnis enthält eine Audio-Vorschau-URL und die kanonische Track-Seite (https://tunetank.com/track/<id>-<slug>/)
• 🆓 Vollkommen kostenlos — kein API-Schlüssel, keine Authentifizierung, keine Anmeldung für Ratenbegrenzung. Nur Lesezugriff.

---

Server

Endpunkt	https://mcp.tunetank.com
Transport	Streamable HTTP (JSON‑RPC 2.0)
Authentifizierung	Keine (öffentlich, nur Lesezugriff)
Kosten	Kostenlos

---

Einrichtung

Richten Sie jeden MCP-fähigen Client auf den obigen Endpunkt aus. Beispiele für gängige Clients:

Claude Desktop / Claude.ai (Connectors)

Fügen Sie einen benutzerdefinierten Connector mit der URL hinzu:

https://mcp.tunetank.com

Oder über die Konfigurationsdatei (claude_desktop_config.json) mit der mcp-remote-Brücke:

{
  "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 / andere Clients

Jeder Client, der entfernte (HTTP) MCP-Server unterstützt — verwenden Sie einfach die URL https://mcp.tunetank.com. Für Clients, die nur stdio unterstützen, überbrücken Sie mit npx -y mcp-remote https://mcp.tunetank.com.

---

Werkzeuge

Werkzeug	Argumente	Rückgaben
search_music	query, name, artist, genre, mood, theme, duration, tolerance, limit	Tracks: Name, Künstler, Dauer, BPM, Vorschau-URL, Track-Seiten-URL, Genres/Stimmungen/Themen
search_sfx	query, category, duration, tolerance, limit	Soundeffekte: Name, Dauer, Vorschau-URL, Wellenform
list_genres	—	Alle Musikgenres (id, name, alias)
list_moods	—	Alle Musikstimmungen (id, name, alias)
list_themes	—	Alle Musikthemen (id, name, alias)
list_playlists	limit	Kuratierte Playlists (Name, Beschreibung, Track-Anzahl)

Hinweise zu den Argumenten

• query (search_music) — Freitext; gleicht den Track-Namen oder den Künstlernamen ab.
• genre / mood / theme — akzeptieren entweder einen Namen/Alias (z. B. "rock", "happy") oder eine numerische ID (aus den list_*-Werkzeugen).
• duration — Ziellänge in Sekunden.
• tolerance — erlaubte ± Sekunden um duration (Standard 5). Beispiel: duration: 60, tolerance: 10 → Tracks zwischen 50s und 70s.
• category (search_sfx) — SFX-Kategoriename oder -ID.
• limit — maximale Ergebnisse (Standard 20, max. 50; Playlists Standard 50, max. 200).

Alle Zeichenkettenfilter sind teilweise Übereinstimmungen, Groß-/Kleinschreibung wird nicht beachtet. Es werden nur veröffentlichte Tracks/SFX zurückgegeben.

---

Beispiele

„Energiegeladener Rock, ~60s, für ein Intro“

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

„Ein kurzer Whoosh-Soundeffekt unter 2 Sekunden“

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

Beispiel für ein Track-Ergebnis

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

---

Ausprobieren (rohes JSON‑RPC)

Der Transport ist spezifikationskonform, daher müssen sowohl der Content-Type- als auch der Accept-Header enthalten sein:

# 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}}}'

---

Lizenzierung

Alle Musik ist kostenlos für persönliche und nicht-kommerzielle Zwecke.

Für alles andere (kommerzielle Projekte, Werbung, monetarisierte Inhalte, Kundenarbeit usw.) besuchen Sie tunetank.com und lesen Sie dort die Lizenzbedingungen.

---

Über

Musik und Soundeffekte stammen von Tunetank — lizenzfreies Audio für Kreative. Dieser MCP-Server ist ein Entdeckungs-Kanal: Er gibt Vorschauen und Track-Seiten zurück, damit Sie anhören und den Track auf tunetank.com herunterladen können. Herunterladen und Lizenzierung erfolgen auf der Website.

Fragen oder Probleme? Kontaktieren Sie uns unter support@tunetank.com.