Soundza

npx add-mcp 'https://mcp.soundza.com/mcp/oauth'

Cómo conectarse

Usa soundza desde un asistente de IA o desde tu propio código. Ambos son gratuitos y obtienen los mismos sonidos.

En un asistente de IA

En Claude, ChatGPT, Claude Code o cualquier aplicación MCP, añade el servidor MCP de soundza e inicia sesión una vez con una cuenta gratuita. Los pasos para cada uno están abajo.

En tu propio código

En aplicaciones, juegos, scripts y herramientas de compilación, llama a la API REST con una clave API gratuita. Obtén una clave.

REST

https://api.soundza.com/v1

MCP, inicio de sesión

https://mcp.soundza.com/mcp/oauth

MCP, clave API

https://mcp.soundza.com/mcp

OpenAPI

soundza.com/openapi.json

Para agentes

soundza.com/llms.txt

El servidor MCP tiene cinco herramientas: search_sounds, get_sound, search_packs, get_pack y download_sound, que devuelve un enlace de 15 minutos, un comando curl listo y la página del sonido.

Claude

1. Haz clic en Añadir a Claude. Claude se abre con el nombre y la URL ya rellenados. Haz clic en Añadir.
2. Inicia sesión en soundza y aprueba. Una cuenta gratuita es todo lo que necesitas.
3. En un chat, haz clic en +, abre Conectores y activa Soundza.

Añadir a Claude o añade un conector personalizado con https://mcp.soundza.com/mcp/oauth

ChatGPT

1. Abre plugins de ChatGPT y añade un servidor MCP personalizado. Nómbralo Soundza y mantén OAuth.
2. Pega la URL de abajo y luego inicia sesión en soundza.
3. En un chat nuevo, elige Soundza desde el menú de herramientas.

URL https://mcp.soundza.com/mcp/oauth

Los servidores personalizados dependen de tu plan de ChatGPT; algunos necesitan el modo Desarrollador activado en los ajustes.

Claude Code

Añádelo, luego ejecuta /mcp, elige soundza e inicia sesión en el navegador.

claude mcp add --transport http soundza https://mcp.soundza.com/mcp/oauth

¿Prefieres usar una clave? Establece SOUNDZA_API_KEY y añade https://mcp.soundza.com/mcp con una cabecera Authorization. La página de claves muestra este comando con tu clave ya rellenada:

claude mcp add --transport http soundza https://mcp.soundza.com/mcp --header "Authorization: Bearer $SOUNDZA_API_KEY"

Codex, Cursor y otros agentes

Cualquier cliente que hable HTTP transmisible. Usa https://mcp.soundza.com/mcp/oauth si admite inicio de sesión; de lo contrario, https://mcp.soundza.com/mcp con una cabecera Authorization. Para Cursor, añade esto a ~/.cursor/mcp.json; lee la clave desde tu entorno, así la clave no queda en archivos que podrías subir.

{
  "mcpServers": {
    "soundza": {
      "url": "https://mcp.soundza.com/mcp",
      "headers": { "Authorization": "Bearer ${env:SOUNDZA_API_KEY}" }
    }
  }
}

Obtén una clave API

Usa una clave en tu propio código. Envíala como Authorization: Bearer <key>. Las claves empiezan con sz_live_. Mantén la tuya en tu servidor o en un .env ignorado por git, nunca en código de cliente.

Créala tú mismo

Inicia sesión y crea una clave en la página de claves. Se muestra una sola vez, con el comando MCP ya rellenado.

O deja que tu agente inicie sesión

Pide a tu agente de codificación que busque sonidos en soundza.com. Lee llms.txt, te envía un enlace para aprobar y guarda la clave él mismo.

Soundza is free, but every call needs an API key tied to a person's account. Get one with a one-click sign-in:

1. Start the sign-in. Include what the person is building, if you know it from the project: project_kind (one of game, video_tool, own_content, app, agent, music, trying, other) and project, one plain line about it. After approving, the person sees both and can change them; leave out anything you'd have to guess.
   curl -s -X POST https://api.soundza.com/v1/auth/device -H "content-type: application/json" -d '{"client_name":"<your tool> on <this machine>","project_kind":"game","project":"<one line, e.g. A retro sci-fi shooter in Godot>"}'
   It returns device_code, user_code, verification_uri_complete, expires_in (600 seconds) and interval (5 seconds).
2. Tell the human: "Open <verification_uri_complete> and approve code <user_code> (sign in with Google if it asks)." Nothing else is needed from them.
3. Right after telling them, poll every <interval> seconds until they approve. Run the polling loop in the foreground and wait for it; don't end your turn while the sign-in is pending (the code lasts 10 minutes).
   curl -s -X POST https://api.soundza.com/v1/auth/token -H "content-type: application/json" -d '{"device_code":"<device_code>"}'
   While it returns {"error":"authorization_pending"} keep polling; on "slow_down" wait the "interval" it returns. On approval it returns {"access_token":"sz_live_...","token_type":"Bearer",...} once: access_token is the API key. "expired_token" or "access_denied" means stop (start again only if the human asks).
4. Save the key as SOUNDZA_API_KEY in the project's .env and make sure .env is in .gitignore. Never commit the key or put it in a project-scope .mcp.json.
5. Optional: connect this MCP server with the key. The command reads $SOUNDZA_API_KEY from the shell, so load .env first (set -a; . ./.env; set +a). It stores the key in Claude Code's own settings (local scope), not in the project. If soundza is already added without a key, run "claude mcp remove soundza" first.
   claude mcp add --transport http soundza https://mcp.soundza.com/mcp --header "Authorization: Bearer $SOUNDZA_API_KEY"
   The tools load in the next session (or after /mcp). Until then, and in any tool that can't add MCP servers, use the REST API at https://api.soundza.com/v1 with the header "Authorization: Bearer $SOUNDZA_API_KEY". It does everything the MCP tools do.

A person can also create a key at https://soundza.com/developers/keys and set it the same way.

Inicio rápido

Busca y luego descarga lo que uses. Establece SOUNDZA_API_KEY primero.

curl -s "https://api.soundza.com/v1/sounds/search?type=sound_effect&q=whoosh&per_page=5" \
  -H "Authorization: Bearer $SOUNDZA_API_KEY"

# download_url redirects to the file: -L follows it, -OJ saves it under its own name
curl -LOJ "https://api.soundza.com/v1/sounds/SOUND_ID/file" \
  -H "Authorization: Bearer $SOUNDZA_API_KEY"

Cada resultado tiene preview_files, MP3 de 128 kbps que se reproducen directamente desde nuestra CDN sin clave, y un download_url para el archivo de calidad completa.

Endpoints

Cada endpoint es una solicitud GET bajo https://api.soundza.com/v1. La especificación completa está en /openapi.json.

Endpoint	Qué hace
GET /sounds/search	Busca por palabras y filtros. Devuelve una página de sonidos y un search_id.
GET /sounds/{id}	Un sonido, por id.
GET /sounds/{id}/file	El archivo de calidad completa, normalmente WAV, con nivel ajustado al catálogo;?variant=original para el original sin tocar. Un 302 a un enlace que funciona durante 5 minutos. search_id y user opcionales.
GET /packs	Packs públicos, mejores primero. q, page y per_page opcionales.
GET /packs/{id}	Un pack, luego una página de sus sonidos. Cada sonido nombra su pack.
GET /removals?since=	Sonidos eliminados desde una fecha ISO, para quien almacene archivos.

Parámetros de búsqueda

Proporciona un q, al menos un filtro, o ambos. Las duraciones están en segundos.

Parámetro	Tipo	Descripción
q	string	Palabras a coincidir, p. ej. "portazo" o "bucle de batería lofi". Los errores tipográficos se perdonan.
type	string	Qué es el sonido: music, sound_effect o ambience (ver Tipo y datos). No distingue mayúsculas. Una búsqueda con q que no encuentre nada dentro de su tipo busca en todos los tipos y lo indica en relaxed_filters.
form	string	Solo música: track, excerpt, loop, one_shot o stem.
parts	string	Solo música: full_mix o single_part. Sin él, type=music ordena primero las mezclas completas, luego los bucles, luego las partes individuales.
vocals	string	Solo música: none, backing o lead.
style	string	Solo efectos de sonido: retro o cartoon. Se establece por pack, así que la mayoría de los sonidos no tienen ninguno; con una q que no encuentre nada con él, se descarta y se lista en relaxed_filters.
min_duration	number	Duración mínima, en segundos.
max_duration	number	Duración máxima, en segundos.
min_bpm	number	Tempo más lento. Solo la música tiene tempo.
max_bpm	number	Tempo más rápido.
key	string	Tonalidad musical, p. ej. "C", "F# minor" o "Bbm". Coincide solo con las tonalidades que muestran los sonidos: indicadas por la fuente o una persona, o detectadas con alta confianza.
chord	string	Acorde que reproduce un one-shot de acorde, p. ej. "Am", "C#m7" o "Fmaj7".
note	string	Nota que reproduce un one-shot afinado: "D3" para esa octava (C3 es el do central), o "D" para cualquier octava.
mood	list	Palabras de ambiente separadas por comas; los sonidos que coincidan con cualquiera vuelven, y más coincidencias rankean más alto. Una de: airy, heavy, metallic, bright, dark, punchy, soft, warm, glitchy, organic, cinematic, cartoony, retro.
good_for	list	Trabajos separados por comas para los que el sonido debería servir. Solo ranking: los sonidos que coinciden rankean más alto y nada se filtra. Una de: transition, reveal, build_up, impact_on_beat, title_or_logo, notification, ui_click, menu, game_pickup, game_hit, game_power_up, footsteps, background_bed, intro, outro.
fit_seconds	number	La duración que el sonido debe cubrir, p. ej. 20 para un anuncio de 20 segundos. Rankea sonidos que puedan cubrirla (una pista de al menos esa duración, o un bucle sin costuras) y añade una pista de ajuste a cada resultado. No filtra nada.
pack	string	El id o slug de un pack: solo los sonidos de ese pack.
loop_seamless	boolean	true: solo sonidos que se repiten sin costuras, medido desde el audio (el final vuelve al inicio sin clic ni salto). Para música de juegos y fondos de ambiente que se repiten bajo una escena.
category	string	Una categoría superior del Sistema Universal de Categorías ("CROWDS") o CatID ("CRWDCheer"). Efectos de sonido y ambiente.
page	integer	Número de página, desde 1.
per_page	integer	Resultados por página: predeterminado 15, como máximo 50. Los resultados se detienen en 500 por consulta.

Respuesta

Una página de resultados, con un enlace a la siguiente página. bpm y key describen música; creator es null cuando un sonido no tiene creador público.

Los archivos tienen nivel ajustado, así que los sonidos se combinan sin ajustar cada uno: una ganancia por sonido, sin compresión, picos a −1 dBTP o menos. El ambiente apunta a −20 LUFS, la música, pads y bucles largos a −16, todo lo demás a −13 en sus 400 ms más fuertes. lufs, true_peak_db y loudness describen el original; gain_db es lo que el archivo predeterminado le añade. Añade ?variant=original a la ruta del archivo para el original tal como se subió.

{
  "page": 1,
  "per_page": 5,
  "total_results": 38,
  "next_page": "https://api.soundza.com/v1/sounds/search?q=whoosh&type=SOUND_EFFECT&per_page=5&page=2",
  "search_id": "x7k2m9q4r1t8v3w6y0z5a2b4",
  "sounds": [
    {
      "id": "cm9w2k4e30001",
      "url": "https://soundza.com/sounds/fast-air-whoosh",
      "title": "Fast Air Whoosh",
      "description": "A quick, bright air whoosh that sweeps left to right.",
      "type": "sound_effect",
      "form": null,
      "parts": null,
      "vocals": null,
      "style": null,
      "good_for": ["transition"],
      "duration": 0.84,
      "bpm": null,
      "key": null,
      "chord": null,
      "note": null,
      "mood": ["airy", "bright"],
      "tags": ["whoosh", "swipe", "air", "airy", "bright"],
      "sync_ms": 310,
      "lufs": -19.4,
      "true_peak_db": -6.1,
      "loudness": { "value": -18.2, "basis": "momentary_max" },
      "gain_db": 5.1,
      "loop_seamless": null,
      "file_type": "audio/wav",
      "file_extension": "wav",
      "sample_rate": 48000,
      "bit_depth": 24,
      "channels": 2,
      "size_bytes": 322604,
      "category": { "id": "WHSH", "label": "Swooshes › Whoosh" },
      "pack": {
        "id": "cm8p1x7a20004",
        "name": "Air and Motion",
        "slug": "air-and-motion",
        "sound_count": 42,
        "url": "https://soundza.com/packs/air-and-motion"
      },
      "creator": null,
      "preview_files": [
        { "type": "audio/mpeg", "bitrate": 128, "link": "https://media.soundza.com/public/previews/4fJ9aQx2LmP0sT7vKc1Rb8Ze.mp3" }
      ],
      "download_url": "https://api.soundza.com/v1/sounds/cm9w2k4e30001/file",
      "license": { "name": "Soundza Standard License", "url": "https://soundza.com/license" },
      "attribution": "\"Fast Air Whoosh\" on Soundza (https://soundza.com/sounds/fast-air-whoosh)"
    }
  ]
}

Tipo y datos

type dice qué es un sonido. Filtra primero por tipo, luego por los datos que conozcas, y pon el resto en q.

type	Qué incluye	Datos
music	Pistas, extractos, bucles, one-shots, stems, stingers, jingles y cortes vocales, incluida la música de juegos.	form (track, excerpt, loop, one_shot, stem), parts (full_mix, single_part), vocals (none, backing, lead), bpm, key, note, chord
sound_effect	Whooshes, impactos, foley, sonidos de interfaz y de juegos, voces como efectos.	category (UCS), style (retro, cartoon; establecido por pack)
ambience	Lugares, tono de sala y fondos de ruido.	category (UCS)

"Música de fondo corporativa, sin voces" es type=music&vocals=none&q=corporate. Con type=music, las mezclas completas van primero, luego los bucles, luego las partes individuales, a menos que establezcas parts. good_for mueve sonidos adecuados para un trabajo (transition, ui_click, background_bed …) hacia arriba en los resultados sin filtrar ninguno. Una búsqueda con q que no encuentre nada dentro de su tipo busca en todos los tipos y lista type en relaxed_filters.

Límites

Las claves gratuitas obtienen:

• 60 búsquedas por minuto
• 250 descargas por hora
• 350 descargas por día

Cada respuesta incluye estas cabeceras. Un 429 también incluye Retry-After, en segundos:

• X-RateLimit-Limit
• X-RateLimit-Remaining
• X-RateLimit-Reset
• X-RateLimit-Policy

Todas las claves de una cuenta comparten estos límites. Prueba los sonidos con sus preview_files, que son gratuitos y no cuentan, y descarga solo los sonidos que uses.

Solo los sonidos diferentes cuentan como descargas, así que obtener el mismo sonido de nuevo dentro de 24 horas es gratuito. Las descargas totales de archivos están limitadas al doble de los límites de descarga. Guarda cada archivo una vez y reutilízalo por el id del sonido. Consultar un solo sonido o pack tiene un límite separado, cinco veces el límite de búsqueda.

¿Pones un selector de sonidos en tu aplicación? Adelante: una clave gratuita cubre una aplicación pequeña con unos pocos usuarios al día. Cuando tenga tráfico real, solicita límites más altos desde la página de claves y cuéntanos un poco sobre ello, o escribe a admin@soundza.com. Responderemos por correo.

Solicitar límites más altos

Dar crédito

Todo es completamente gratuito. Lo único que pedimos es que acredites a soundza.com (y/o al creador original del sonido si corresponde) en algún lugar que tenga sentido para tu proyecto. Idealmente, incluye un enlace a soundza.com en algún lugar de tu sitio web/blog/página de itch (p. ej. 'Gracias a soundza.com por los sonidos gratuitos'). Si no tienes un sitio, nos encantaría una mención en redes sociales o en la descripción de un video de Youtube, etc. ¡Ayuda a correr la voz!

Abajo hay algunos ejemplos. Somos flexibles en cómo nos acreditas, pero pedimos que lo hagas de alguna manera que funcione naturalmente para tu proyecto.

Lo que haces	Cómo acreditar
Una aplicación o herramienta con selector de sonidos	Powered by soundza en el selector, más un enlace a soundza.com en el pie de página de tu sitio, página Acerca de, blog u otro lugar que tenga sentido.
Un juego, incluso pequeño	Donde lo compartas (una publicación en Reddit o Discord, X, tu devlog o sitio, itch.io o Steam), un agradecimiento rápido a soundza.com, con un enlace donde puedas.
Videos	Sound effects: soundza.com en la descripción de YouTube. En TikTok o Instagram, etiqueta @soundza_audio si puedes.
Un bot, agente o herramienta de código abierto	Una línea en tu README, texto de ayuda o página de listado.
Algo solo para ti	No se necesita nada.

¿Quieres usar nuestro logotipo? Eres bienvenido a mostrarlo con tu enlace: el logotipo completo (PNG) o la marca por separado (SVG). Solo no lo uses como ícono de tu aplicación.

¿Hiciste algo con soundza? Nos encantaría verlo. Envía un correo a admin@soundza.com o etiqueta @soundza_audio. Recompartimos proyectos geniales.

Errores

Los errores son JSON: {"error": {"code", "message", "details"?}}.

Estado	Código	Significado
400	invalid_request	Un parámetro es incorrecto. details lista cada uno.
401	missing_key	No hay cabecera Authorization: Bearer.
401	invalid_key	La clave no existe.
401	revoked_key	La clave fue revocada.
404	not_found	Ningún sonido público tiene ese id.
429	rate_limited	Se alcanzó un límite. Espera los segundos de Retry-After.
500	server_error	Algo salió mal en nuestro lado. Inténtalo de nuevo en breve.

Licencias

Todo sonido está cubierto por la Licencia Estándar de Soundza, enlazada desde su campo license: libre de regalías para trabajo personal y comercial, sin necesidad de atribución para los propios sonidos (consulta dar crédito para lo que pedimos a cambio). Revisamos los sonidos con cuidado, pero los proporcionamos tal cual, sin garantía de que un sonido esté libre de reclamaciones de terceros. La licencia contiene los términos completos.

Pautas

• Una vez que personas fuera de tu equipo vean lo que creas, enlaza de vuelta a soundza.com de la forma que mejor encaje: "Powered by soundza" junto a tu selector de sonidos más un enlace en tu sitio, un agradecimiento donde compartas tu juego, o una línea en la descripción de tu video. Consulta soundza.com/developers#credit.
• Solicita el download_url de un sonido cuando se añada a un proyecto, guarda el archivo una vez y reutilízalo mediante el id del sonido.
• Las vistas previas son para escuchar. Usa los archivos descargados en el trabajo final.
• No copies la funcionalidad principal de Soundza ni construyas una biblioteca de sonidos o API competidora.
• Una clave gratuita puede almacenar hasta 500 sonidos descargados. Elimina cualquier sonido listado en GET /v1/removals y revísalo al menos mensualmente.
• Respeta los límites de tasa y pregunta cuando necesites más. Podemos suspender o finalizar el acceso a la API para cualquier persona, en cualquier momento, por cualquier motivo.

El uso de la API se rige por los Términos de Servicio y la Licencia.

Selector de Soundza

Un selector de sonidos para tu producto en tres archivos: dos rutas de servidor que mantienen tu clave privada, y un componente con chips, vistas previas y el enlace de crédito. Estilízalo para que coincida con tu aplicación.

// app/api/sounds/route.ts: search, with your key kept on the server
export async function GET(req: Request) {
  const params = new URL(req.url).searchParams;
  const res = await fetch(\`https://api.soundza.com/v1/sounds/search?${params}\`, {
    headers: { Authorization: \`Bearer ${process.env.SOUNDZA_API_KEY}\` },
  });
  return new Response(res.body, { status: res.status, headers: { "Content-Type": "application/json" } });
}

// app/api/sounds/[id]/file/route.ts: call it from your server when a user adds a sound
export async function GET(req: Request, { params }: { params: Promise<{ id: string }> }) {
  const { id } = await params;
  const query = new URL(req.url).searchParams; // search_id, and your own user id as user
  const res = await fetch(\`https://api.soundza.com/v1/sounds/${encodeURIComponent(id)}/file?${query}\`, {
    headers: { Authorization: \`Bearer ${process.env.SOUNDZA_API_KEY}\` },
    redirect: "manual",
  });
  const location = res.headers.get("location");
  return location ? Response.redirect(location, 302) : new Response(res.body, { status: res.status });
}

Cuando un usuario añade un sonido, obtén la ruta del archivo desde tu servidor y guarda el archivo en tu propio almacenamiento. Eso cuenta la descarga. La ruta redirige a un enlace firmado que dura 5 minutos y no puede leerse desde un navegador en otro sitio, así que no lo obtengas desde el cliente ni conserves el enlace. Pasa tu propio ID de usuario como user si deseas informes por usuario.

Preguntas frecuentes

¿La API es gratuita?

Sí. La API y las claves son gratuitas. A cambio, nos encantaría un enlace de vuelta a soundza donde encaje con lo que creas.

¿Necesito dar crédito a soundza?

Lo pedimos una vez que personas fuera de tu equipo vean lo que creas, en la forma que mejor encaje: un enlace en tu sitio, tu página de tienda o la descripción de tu video. No se necesita nada mientras construyes o pruebas, ni para cosas que son solo para ti.

¿Qué cuenta como crédito?

Un enlace a soundza.com donde la gente pueda verlo. Para una aplicación, Powered by soundza junto a tu selector de sonidos más un enlace en el pie de página de tu sitio, la página Acerca de, el blog u otro lugar que tenga sentido. Para un juego, un agradecimiento donde lo compartas: una publicación en Reddit o Discord, tu devlog o sitio, o su página de itch.io o Steam. Para un video, Sound effects: soundza.com en la descripción. Una mención en X, Discord o YouTube también es bienvenida.

¿Compartirás lo que creo?

Nos encantaría saber qué construyes. Envía un correo a admin@soundza.com o etiqueta @soundza_audio y cuéntanos qué hiciste. Recompartimos proyectos geniales hechos con soundza.

¿Puedo usar el logotipo de soundza?

Sí, nos encantaría que lo mostraras con tu enlace "Powered by soundza", aunque es opcional. Por favor, no lo uses como ícono de tu aplicación. Descarga el logotipo completo (soundza.com/logo-wordmark.png) o la marca por separado (soundza.com/logo.svg).

¿Cuáles son los límites?

Las claves gratuitas obtienen 60 búsquedas por minuto, 250 descargas por hora y 350 al día, compartidas por todas las claves de tu cuenta. Las vistas previas no cuentan. Cada respuesta tiene encabezados X-RateLimit-*.

¿Cómo obtengo límites más altos?

Los límites gratuitos cubren crear un juego, editar videos o una aplicación pequeña con un selector de sonidos. Si estás poniendo un selector de sonidos en una aplicación con tráfico real, usa "Solicitar límites más altos" en la página de claves y cuéntanos un poco al respecto, o envía un correo a admin@soundza.com con el prefijo de tu clave y lo que estás construyendo. Responderemos por correo.

¿Puedo usar los sonidos en proyectos comerciales?

Sí. Cada sonido es libre de regalías para trabajo personal y comercial bajo la Licencia Estándar de Soundza, e incluir un sonido dentro de un juego o aplicación que crees está bien.

¿Puedo almacenar los archivos?

Sí. Guarda cada archivo una vez y reutilízalo mediante el id del sonido. Una clave gratuita puede almacenar hasta 500 sonidos descargados. No conserves el enlace firmado al que download_url redirige; dura 5 minutos.

¿Qué pasa si un sonido se elimina?

Llama a GET /v1/removals?since=<date> de vez en cuando (al menos mensualmente) y elimina cualquier sonido que liste.

¿Puedo usar los sonidos para entrenar IA?

No. Los sonidos no pueden usarse para entrenar, ajustar o construir un modelo de IA o aprendizaje automático.

¿Puedo construir una biblioteca de sonidos con la API?

No. Por favor, no redistribuyas sonidos como archivos independientes o paquetes de muestras, ni construyas una biblioteca de sonidos o API competidora.

¿REST o MCP?

Ambos usan la misma clave, límites y catálogo. Usa REST desde tu código y MCP (mcp.soundza.com/mcp) para que un agente como Claude Code o Cursor pueda buscar y descargar por ti.

¿Puede mi agente de codificación obtener una clave por sí mismo?

Sí. Pídele que busque sonidos en soundza.com. Lee llms.txt, te envía un enlace para aprobar y guarda la clave.