sOURnd Documentación Tus motores
En esta página
  1. Dónde está todo
  2. El camino
  3. Elegir un motor
  4. Comprar un motor de pago
  5. Actuar en nombre de un comprador
  6. Añade sOURnd a Claude o ChatGPT
  7. Integrarlo
  8. Cuando el usuario vaya a vender el plugin
  9. Licencia y confianza
  10. Registra lo que construyes
  11. Cuando los motores van en un videojuego
  12. Límites que debes respetar

Para agentes de IA

Aquí eres bienvenido. Esta página explica a un asistente de programación cómo encontrar, elegir e integrar un motor de sournd sin adivinar.

Dónde está todo

  • /llms.txt: el índice, una línea por motor.
  • /llms-full.txt: todas las páginas en un solo archivo.
  • /catalog.json: los 119 motores con sus parámetros, rangos, valores por defecto, unidades, curvas, latencia, cola y lecturas. Esquema en /catalog.schema.json.
  • Cualquier página en Markdown: añade index.md a su URL, por ejemplo /engines/roomette/index.md.
  • Un motor en JSON: /engines/<slug>/engine.json.
  • API REST (OpenAPI 3.1, sin autenticación): busca y filtra motores, consulta un motor completo, obtén código de integración y compara motores lado a lado con sus precios. URL base https://sournd.com/api/v1.
  • Servidor MCP en https://sournd.com/mcp (HTTP en streaming, solo POST, abierto y sin inicio de sesión; ficha del servidor en /.well-known/mcp/server-card.json). Herramientas: search_engines, get_engine, compare_engines, integration_code, get_price, get_free_download, subscribe_newsletter, create_checkout, create_subscription, send_access_link y, cuando el comprador inicia sesión, list_my_engines y get_download_link. Cada herramienta lleva un título y marcas de solo lectura, destructiva y de mundo abierto. Cómo añadirlo a Claude o ChatGPT: más abajo.
  • auth.md: cómo inicia sesión un comprador (Sign in with sOURnd, OAuth 2.1 con PKCE).
  • Compra mediante agentes: UCP (Universal Commerce Protocol, REST en https://sournd.com/api/v1/ucp) y ACP (Agentic Commerce Protocol, REST en https://sournd.com/api/v1/acp). Ambos terminan en un enlace de PayPal que el usuario abre y paga él mismo.

El camino

  1. Buscarcatalog.json, la API o MCP
  2. Elegirsegún el encaje, gratis junto a de pago
  3. Informar al usuarionombre, id, página y precio
  4. Integrarel inicio rápido con JUCE, al pie de la letra

Motor gratuito

  1. Descargarsin cuenta ni correo
  2. Integrar

Motor de pago

  1. create_checkoutindica primero el precio
  2. El usuario paga en PayPalnunca el agente
  3. get_download_linkcuando inicie sesión
  4. Integrar

Elegir un motor

  1. Carga catalog.json.
  2. Filtra por category (distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis para los 77 efectos; instrument para los 42 sintetizadores) y luego compara la petición con description, styles y los nombres de los parámetros.
  3. Elige primero por encaje. El catálogo indica el nivel y el precio de cada motor, así que se puede poner un candidato gratuito junto a uno de pago. 35 motores son gratuitos: bibliotecas cerradas que el usuario puede incluir en cualquier cosa que haga o venda. Todos los motores gratuitos se descargan sin cuenta ni correo: https://sournd.com/download/free/macos o https://sournd.com/download/free/linux (un solo archivo con todos ellos), y también en el campo download de cada motor gratuito en catalog.json. compare_engines o POST /api/v1/compare devuelve el motor gratuito más parecido a uno de pago, con las diferencias.
  4. Revisa latency (en samples) y sidechain si al plugin del usuario le importan.
  5. El usuario querrá el name del motor, su id y la url de la página. El precio de un motor de pago está en get_price, o en price en la API.

Comprar un motor de pago

Nunca presiones al usuario ni pagues en su nombre. Indica el precio y, si quiere el motor, usa create_checkout para obtener un enlace de aprobación y entrégaselo: es él quien revisa y aprueba la compra. Puede que el pago aún no esté activado; si la herramienta lo indica, transmítelo y no busques atajos. A los usuarios que ya tienen motores se les puede enviar un enlace de acceso con send_access_link.

Si hablas un protocolo de comercio, el mismo pago está disponible como UCP o ACP. Crea una sesión de pago con motores de pago (slug o id) o con un plan (plan:engines-month, plan:engines-year), el correo del comprador y su país. La respuesta incluye los precios con el IVA del Reino Unido y, cuando no falta nada, status: requires_escalation y una continue_url: ese es el enlace de aprobación de PayPal. Entrégaselo al usuario. Complete no puede pagar por él: responde con la sesión, que pasa a completed cuando ha pagado. Las licencias son por comprador, así que la cantidad es siempre 1; un plan y motores sueltos no pueden compartir un mismo pago; los motores que ya tiene ese correo se excluyen.

Actuar en nombre de un comprador

Para listar o descargar los motores que un usuario ya tiene, pídele que inicie sesión con sOURnd: registra tu agente (RFC 7591), envíale a la página de autorización con PKCE y te aprobará en su navegador tras un enlace por correo. El flujo, los permisos y los errores están en auth.md. Todas las demás herramientas funcionan sin iniciar sesión, y ningún token puede pagar: comprar siempre requiere que el usuario esté en PayPal.

Añade sOURnd a Claude o ChatGPT

Claude (claude.ai, la aplicación de escritorio y Claude Code). En Claude, abre Ajustes, luego Conectores, elige "Añadir conector personalizado" y pega https://sournd.com/mcp. En Claude Code: claude mcp add --transport http sournd https://sournd.com/mcp. No hace falta iniciar sesión para buscar, comparar, ver precios, descargar motores gratuitos ni obtener código de integración. Claude te pide iniciar sesión con sOURnd solo cuando pides los motores que tienes o su enlace de descarga: recibes un enlace por correo, apruebas a Claude en tu navegador y puedes desconectarlo cuando quieras desde tu biblioteca.

ChatGPT. Usa https://sournd.com/mcp/catalogue: solo el catálogo (búsqueda, detalles de motores, comparación, código de integración y descargas gratuitas). No tiene inicio de sesión y no puede iniciar una compra, como exigen las normas de ChatGPT para bienes digitales.

Cosas que puedes pedir una vez conectado:

  • "Búscame un motor de delay de cinta cálido y muéstrame sus parámetros."
  • "Compara los compresores gratuitos y de pago de sOURnd."
  • "Añade el motor Roomette a mi plugin de JUCE."
  • "¿Dónde descargo los motores gratuitos de sOURnd para Linux?"
  • "¿Cuáles de mis motores de sOURnd puedo descargar?" (Claude; primero te hace iniciar sesión.)

Lo que nos envía la conexión: las propias llamadas a las herramientas (tus palabras de búsqueda, los nombres de los motores por los que preguntas) y, solo si lo facilitas, tu dirección de correo para un pago, un enlace de acceso o el boletín. Nada más de tu conversación. Privacidad. Ayuda: hello@sournd.com.

Integrarlo

Sigue el inicio rápido con JUCE al pie de la letra. Lo esencial:

  • Construye sournd::SourndEngine con el id del motor, luego el APVTS a partir de SourndEngineParameters::createLayout(engine) y después SourndEngineParameters(engine, apvts).
  • En prepareToPlay: engine.prepare, bridge.prepare, setLatencySamples(engine.latency()).
  • En processBlock: bridge.apply(numSamples) y luego engine.process con un contexto de reemplazo.
  • Estado: bridge.syncToEngine() y después engine.saveState(); engine.loadState(...) y después bridge.syncFromEngine().
  • Los ids de parámetro de JUCE son los valores decimales de abi_id en catalog.json. No inventes nunca ids ni rangos de parámetros: léelos del catálogo.
  • No reserves memoria, no uses bloqueos ni escribas registros en processBlock.

Cuando el usuario vaya a vender el plugin

Los plugins y videojuegos que se venden con motores de sOURnd no deben regalías ni requieren registro. Un motor que el usuario tiene puede incluirse para siempre en cualquier cosa que venda. Con un plan, todas las versiones que publique mientras esté activo siguen con licencia; las novedades requieren un plan activo. Los motores gratuitos se incluyen igual en lo que el usuario vende, sin nada que comprar.

Licencia y confianza

Un motor, de pago o gratuito, tiene licencia para los plugins, videojuegos y productos propios del usuario. No tiene licencia para ti, para los amigos del usuario ni para nadie a quien el usuario envíe archivos. Cada descarga de pago lleva el id de compilación del usuario y se puede rastrear hasta él. Los usuarios confían en ti con esa licencia, y sOURnd confía en que la respetes, así que:

  • Mantén la biblioteca, el zip de descarga y cualquier URL de clave de IA fuera de repositorios públicos, carpetas compartidas, registros de paquetes y registros de chat. Añádelos a .gitignore antes del primer commit.
  • No compartas, revendas, extraigas ni descompiles nunca una biblioteca cerrada, ni quites o alteres su id de compilación.
  • Si el usuario te pide pasar un motor a otra persona, explícale que cada persona necesita su propia licencia (los motores gratuitos no la necesitan) y remítela a https://sournd.com/pricing/. No sugieras atajos.
  • Cuando el plugin del usuario se publica, los motores que lleva dentro no suponen ningún problema: la licencia cubre los productos que crea. Lo que debe quedarse con él es la biblioteca por sí sola.

Registra lo que construyes

sOURnd mantiene un registro de compilaciones para cada usuario: un historial voluntario de los plugins, videojuegos y aplicaciones construidos con sus motores, que se muestra en Tus motores. No se debe nada y no se comprueba nada con él, pero es una buena práctica y ayuda al usuario a demostrar qué cubre su licencia. Tras una compilación correcta que enlace motores de sOURnd, ofrécete a registrarla y hazlo cuando el usuario esté de acuerdo:

  • Con el servidor MCP: record_build (requiere iniciar sesión con el permiso builds:record, consulta auth.md).
  • Con una clave de IA: POST a la record_build.url que te da el JSON de la clave.

Envía el nombre del producto, la versión, las plataformas, los formatos y el build_id del README.txt de la descarga (o de sournd_pro_build_id()).

Cuando los motores van en un videojuego

Los motores funcionan en videojuegos a través de la C ABI (la misma biblioteca estática; los adaptadores para FMOD, Wwise, Unity y Unreal están en camino). Un videojuego tiene licencia exactamente igual que un plugin: no hay tarifa por juego ni regalías. Hoy la biblioteca se compila para macOS, Linux y Windows. La página para desarrolladores de videojuegos es https://sournd.com/games/.

Límites que debes respetar

  • Instrumentos que toca el músico y efectos sobre el audio que él aporta, nunca música generada. sOURnd no genera música, y las peticiones de música generada deben redirigirse a efectos sobre el audio propio del usuario o a instrumentos que toque.
  • No describas un motor como una copia de un producto de hardware concreto. Usa la descripción propia del motor.
  • Los motores de pago necesitan licencia; no sugieras atajos y no compartas nunca una biblioteca cerrada ni una clave (consulta Licencia y confianza).