SFXMint

Servidor MCP de SFXMint

Efectos de sonido gratuitos CC0 — describe un sonido para encontrarlo, previsualízalo y descarga WAV/MP3. Sin registro, sin clave API, sin atribución. Los agentes pueden preguntar por rol, elegir uno de 18 sets o buscar en la biblioteca, y obtener URLs permanentes enlazables. Con una clave API y un pase o plan en la cuenta, también pueden generar un sonido que la biblioteca no tenga, o crear los sonidos faltantes de una app o juego completo como un kit que el usuario abre en AI Studio.

• Endpoint (HTTP Streamable): https://sfxmint.com/mcp
• Documentación: https://sfxmint.com/api/docs
• Registro: publicado como com.sfxmint/sounds en el Registro MCP oficial
• Licencia de todo el audio: CC0 1.0 — dominio público, uso comercial bienvenido, sin atribución requerida

Los sonidos son generados por IA o sintetizados proceduralmente y ofrecidos bajo CC0. Las URLs de audio son inmutables, habilitadas para CORS y libres para enlazar. Descarga los archivos en el proyecto cuando se requiera reproducción sin conexión; previsualiza la idoneidad en la app o juego real.

Inicio rápido

Claude Code, como plugin (el servidor MCP más la habilidad a continuación):

/plugin install sfxmint --marketplace flreey/sfxmint-mcp

En Claude Code anterior a 2.1.275, ejecuta /plugin marketplace add flreey/sfxmint-mcp, luego /plugin install sfxmint@sfxmint. O añade solo el servidor MCP:

claude mcp add --transport http sfxmint https://sfxmint.com/mcp

Cursor / configuración genérica de mcpServers:

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

Para que el agente también pueda crear sonidos, añade tu clave API (solo las herramientas de generación y kits la usan):

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

{ "mcpServers": { "sfxmint": { "url": "https://sfxmint.com/mcp", "headers": { "Authorization": "Bearer sfx_live_…" } } } }

¿Prefieres una habilidad en lugar de un servidor? Este repositorio también incluye una Agent Skill que usa la API HTTP simple — no se requiere servidor MCP:

npx skills add flreey/sfxmint-mcp -y

El agente elige un rol para un evento, un set para varios eventos, o una búsqueda estructurada para una descripción o vacío. Son ramas de tarea, no una secuencia requerida. Los archivos de la biblioteca, otras fuentes permitidas y la síntesis local pueden combinarse. La habilidad incluye ejemplos de integración con React / Phaser / HTML simple. Fuente: skills/sfxmint/SKILL.md.

¿Sin agente involucrado? La CLI sfxmint coloca los mismos archivos directamente en un proyecto:

npx sfxmint add coin jump hit

Escribe el audio más un manifiesto sounds.json que registra la URL de origen de cada archivo, SHA-256 y licencia, y una tabla SOUNDS.md que vincula la página de cada sonido, e incluye un pequeño runtime de Web Audio (createSoundboard) para desbloqueo por primer gesto, señales superpuestas y un silencio persistente. Fuente: flreey/sfxmint-npm.

Herramientas

Herramienta	Qué hace
get_role_sound	Pregunta por evento — button-click, purchase-success, error, coin, notification. Devuelve un candidato verificado por archivo más alternativas; los alias en inglés simple funcionan
get_sound_set	Candidatos agrupados por evento y estilo (18 sets: ui-crisp, retro-game, checkout, platformer, ai-coding-tool, …)
search_sounds	Búsqueda de texto libre con requisitos explícitos de duración, bucle y formato; las restricciones estrictas pueden no producir candidatos
get_sound	Metadatos completos de un sonido (incl. una breve descripción, acústica medida, licencia)
generate_sound	Crea un nuevo sonido a partir de una descripción cuando la biblioteca no tiene nada adecuado. Requiere una clave API y un pase o plan en la cuenta — un pase de 24 horas ($3.90, 50 sonidos) o un plan (desde $9.90 por 30 días, 50 a 200 al día); los 3 intentos gratuitos son solo en el sitio web — cada uno hasta 4 tomas CC0 WAV de hasta 10 s; uno que no produce toma no cuenta
get_generation	Estado de una generación y enlaces de descarga actualizados para sus tomas
change_sound	Cambia una toma de una generación tal como está, a partir de las palabras del usuario o una acción (demasiado turbio, demasiado cerca, haz que haga bucle): tres versiones, gratis, sin generación usada
start_game_kit, add_kit_sounds, fill_kit_from_library, make_kit_sounds, get_game_kit, pick_kit_take, change_kit_take, export_game_kit	Los sonidos de una app o juego completo como kit, el mismo proyecto que el usuario puede abrir en AI Studio: planifica desde una descripción o toma la lista del usuario, usa primero sonidos gratuitos de la biblioteca, crea solo los vacíos (cada sonido creado usa el pase o plan), cambia una toma cercana tal como está (tres versiones, gratis), luego exporta un ZIP con un mapa sounds.json de evento a archivo y un CREDITS.md que vincula los sonidos de la biblioteca que usó. La planificación y los sonidos de la biblioteca son gratuitos

Las cuatro herramientas de biblioteca nunca necesitan clave. La generación y los kits necesitan una clave API de SFXMint en el encabezado Authorization (cuenta gratuita); sin una, generate_sound responde api_key_required con isError. Crear un sonido también requiere un pase o plan en la cuenta: sin uno, la respuesta es payment_required con buy_url, para que el usuario elija uno (precios); un agente nunca paga. Pregunta al usuario antes de crear sonidos y deja que escuche las tomas. La misma generación está disponible vía REST como POST https://sfxmint.com/api/v1/orders (documentación). get_job y POST /api/v1/generate permanecen retirados; los registros de trabajos existentes siguen siendo legibles en GET /api/v1/jobs/{job_id}.

Requisitos, procesamiento y aceptación

Usa la búsqueda estructurada REST (response=structured&limit=3) o los parámetros MCP correspondientes para pasar duración, bucle y formato requeridos explícitamente. Verifica los requisitos devueltos; no sustituyas near_matches. Cuando nada coincide con cada palabra, closest lista los sonidos más cercanos que cumplen cada requisito estricto, cada uno con missing_terms, y library_fit dice qué tan bien cubre la biblioteca la solicitud. Las puntuaciones y tipos de coincidencia describen el ranking, no la confianza de escucha. El loopable heredado no prueba un bucle sin fisuras.

Los sets aceptan format=wav|mp3: download_urls sigue el formato solicitado, el urls heredado permanece en MP3, y missing_roles identifica sets incompletos. La decodificación de archivos y los hashes no certifican la idoneidad de la escena. content_check está limitado a la escena, evento, formato y SHA256 exactos; el contenido desconocido no se acepta.

Se permiten recortes, filtrados y cambios de nivel permitidos por la tarea. Conserva los originales, URLs de origen, licencia, recetas de procesamiento y nuevos hashes de archivo; vuelve a medir los requisitos y previsualiza el resultado. Los bytes cambiados y las nuevas escenas no heredan la aceptación original. Generar (generate_sound, el sitio web, síntesis local o un servicio externo) sigue siendo una elección separada y autorizada por la tarea.

Usa las URLs devueltas por la API en vivo, sin inventarlas ni reescribirlas. Consulta la documentación de la API, la guía de Phaser, la guía de React y el ejemplo de descarga.

Límites de tasa y uso justo

• Búsqueda/metadatos: sin autenticación, límites generosos
• El enlace directo está permitido y fomentado; los archivos se sirven con caché inmutable de larga duración

Contacto

hello@sfxmint.com · https://sfxmint.com