Yungle

npx add-mcp 'https://yungle.co/mcp'

npm install -g yungle-cli
yungle login                  # opens your browser, once
yungle send ./render.mov      # uploads resumably, prints the link

¿Quieres que Yungle envíe el enlace por correo por ti? Inicia sesión con una clave de API (yungle login --key) y añade --to client@example.com. Un inicio de sesión en el navegador crea enlaces pero nunca envía correos a nadie, por lo que un código de inicio de sesión robado no puede usarse para enviar mensajes a desconocidos.

Qué hay aquí

	Instalación	Para qué sirve
CLI	npm i -g yungle-cli brew install heindewilde/yungle/yungle	Envía, recibe y sincroniza archivos desde una terminal o CI. Reanuda tras una conexión caída o una tapa cerrada
Servidor MCP	En el directorio de Claude https://yungle.co/mcp	Conecta Claude, Cursor o cualquier cliente MCP con un solo inicio de sesión: pregunta qué llegó, comparte archivos, aprueba cada envío
SDK de TypeScript	npm i yungle-client	Toda la API, tipada y sin dependencias. Node, Bun, Deno, entornos edge
SDK de Python	pip install yungle	La API desde Python, con una llamada send() que gestiona la subida
Acción de GitHub	uses: heindewilde/yungle-send-action@v1	Envía artefactos de compilación a un cliente desde CI y recibe el enlace como salida
Ejemplos		GitHub Actions, informes nocturnos y más en yungle.co/developers/recipes

Todo habla con la misma API REST pública (OpenAPI 3.1), contra la cual CI verifica estos clientes en cada cambio.

El CLI

Diseñado para ser agradable para una persona y predecible para un script. Bonito en una terminal, solo el enlace cuando se canaliza, JSON con --json.

yungle send ~/Shoot --to anna@studio.nl --message "Final selects"   # send a folder
yungle send dist/ --json | jq -r .url                               # in a script
yungle get https://yungle.co/t/emerald-palm-a5mt                    # download, no account needed
yungle status                                                       # who downloaded what
yungle watch ~/Renders --collection 01J8Z3M9Q0W4                    # upload new files as they land
yungle webhooks listen --forward-to http://localhost:8080/hooks     # test webhooks locally

• Subidas grandes y reanudables. Interrumpe yungle send, ejecútalo de nuevo, y continúa desde la última parte confirmada en lugar de empezar de cero.
• Guía cuando omites algo. yungle send por sí solo pregunta qué enviar y a quién. Nunca en CI, nunca con --json o --yes: un script no puede quedarse colgado en una pregunta.
• Los errores te dicen la solución. Cada fallo termina con el único comando que te saca del apuro, y un error tipográfico recibe un ¿quisiste decir?.
• Autocompletado con tabulador para zsh, bash y fish: yungle completion zsh.

Referencia completa: apps/cli · yungle.co/developers/cli

Conecta tu asistente de IA

En Claude: añade Yungle desde el directorio de conectores de Claude e inicia sesión.

En cualquier otro lugar (Cursor, VS Code, cualquier cliente MCP): añade Yungle como servidor MCP remoto e inicia sesión una vez. No hay clave que copiar.

https://yungle.co/mcp

Luego pregunta cosas como "¿Anna descargó el conjunto final?", "¿Qué entregas caducan esta semana?" o "Comparte estos tres archivos con el cliente." El asistente prepara; tú apruebas cada envío antes de que salga un correo. No hay ninguna herramienta que elimine, revoque o invite, y todo lo que el servidor devuelve está etiquetado como datos no confiables, porque un nombre de archivo puede contener una inyección de prompt.

¿Prefieres un servidor local con una clave de API? yungle mcp install escribe la configuración para Claude Desktop, Claude Code, Cursor o Windsurf. Detalles: packages/mcp-server.

Los SDK

import { YungleClient } from 'yungle-client';

const yungle = new YungleClient({ apiKey: process.env.YUNGLE_API_KEY! });
for await (const t of yungle.allTransfers()) console.log(t.title, t.downloadCount);

from yungle import Yungle

sent = Yungle().send(["render.mov"], to=["client@example.com"], message="Final cut")
print(sent["url"])

Ambos reintentan lo que es seguro reintentar, ponen un Idempotency-Key en cada POST para que un reintento nunca haga una segunda copia, siguen la paginación por cursor por ti y verifican las firmas de webhooks.

Webhooks

Que te avisen en lugar de consultar: transfer.ready, transfer.downloaded, transfer.expiring, transfer.expired, y en planes de pago collection.file_uploaded. Cada entrega está firmada con HMAC-SHA256 y se reintenta con retroceso. ¿Sin URL pública? Omítela y extrae los eventos en su lugar.

import { verifyWebhook } from 'yungle-client';
const ok = await verifyWebhook(rawBody, req.headers['yungle-signature'], process.env.YUNGLE_WEBHOOK_SECRET!);

Planes y límites

Cada cuenta puede usar la API, el CLI y el servidor MCP, el plan gratuito incluido: transferencias de hasta 10 GB, contactos, webhooks y descarga de cualquier enlace. Las colecciones y archivos que nunca caducan vienen con un plan de pago. Los primeros 10 GB de subidas de API cada mes son gratuitos, luego €0.02/GB desde crédito prepagado. Precios

Por qué Yungle

• En Europa, gestionado por una empresa europea. Tus archivos se almacenan y sirven desde infraestructura de la UE.
• Siempre cifrado. Cada archivo tiene su propia clave, y las transferencias pueden estar cifradas de extremo a extremo en el navegador cuando lo necesites.
• Sostenible. Energía hidroeléctrica renovable, en un centro de datos con un PUE de 1.13. Qué significa y qué no significa.

No accesible desde aquí: tu bóveda y las transferencias cifradas de extremo a extremo. Sus claves se derivan en tu navegador y nunca se envían a Yungle, por lo que ninguna API puede leerlas. Consulta lo que la API no puede hacer.

Contribuciones

pnpm install
pnpm typecheck && pnpm lint && pnpm test && pnpm build
pnpm contract   # check the clients against the live OpenAPI spec

Este repositorio es donde se desarrollan los clientes; el servicio Yungle en sí no es de código abierto. Las incidencias y solicitudes de extracción son bienvenidas, consulta CONTRIBUTING.md. Los informes de seguridad pasan por security.txt.

MIT