WhipScribe
Transcribe audio y video (archivos o enlaces de YouTube/podcasts) en más de 99 idiomas, luego busca, resume, traduce y exporta transcripciones como TXT, SRT, VTT o DOCX desde tu asistente de IA.
Servidor MCP alojado
npx add-mcp 'https://whipscribe.com/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
whipscribe-mcp
mcp-name: io.github.neugence/whipscribe-mcp
Servidor MCP para Whipscribe — transcribe audio y video desde una URL o archivo local mediante Claude Desktop, Claude Code, Cursor, Windsurf, o cualquier cliente compatible con MCP.
⚠️ Servicio en beta
whipscribe-mcpy la API de Whipscribe están en beta. Los endpoints, las formas de respuesta y las cuotas pueden cambiar sin previo aviso.- Los trabajos pueden fallar, quedarse bloqueados o devolver resultados parciales. La lógica de reintentos es tu responsabilidad.
- Los créditos beta pueden invalidarse sin previo aviso — por ejemplo, por migración de infraestructura, compromiso de claves o restablecimiento de precios. Los créditos beta no se convierten en efectivo.
- Daremos un aviso por escrito de 7 días antes de cualquier cambio de precios que afecte a claves activas, y honraremos los créditos no utilizados a la tarifa anterior durante 7 días después del aviso.
- No es adecuado para casos de uso en producción donde el fallo de transcripción tenga consecuencias legales, de seguridad o financieras.
- Al instalar y usar este paquete, aceptas los términos completos en whipscribe.com/terms.
Instalación
uvx whipscribe-mcp
Alternativas:
pipx install whipscribe-mcp
pip install whipscribe-mcp
Requiere Python 3.10+.
Claude Desktop
Añade a claude_desktop_config.json:
{
"mcpServers": {
"whipscribe": {
"command": "uvx",
"args": ["whipscribe-mcp"]
}
}
}
Opcional: establece WHIPSCRIBE_API_KEY en env para desbloquear la cuota de pago.
{
"mcpServers": {
"whipscribe": {
"command": "uvx",
"args": ["whipscribe-mcp"],
"env": {
"WHIPSCRIBE_API_KEY": "your-key"
}
}
}
}
Reinicia Claude Desktop. Escribe "transcribe esta URL de podcast: …" y Claude llamará a la herramienta.
Herramientas
| Herramienta | Descripción |
|---|---|
transcribe_url(url, language?, diarize?, word_timestamps?) | Transcribe audio/video desde cualquier URL (YouTube, fuentes de podcasts, enlaces directos a archivos). |
transcribe_file(path, language?, diarize?, word_timestamps?) | Transcribe un archivo de audio/video local. |
get_job_status(job_id) | Comprueba el progreso de un trabajo en ejecución. |
get_transcript(job_id, format) | Obtén la transcripción en txt, json, srt, vtt o docx. |
list_recent_jobs(limit?) | Explora tus trabajos recientes (caché local). |
Todas las herramientas devuelven un objeto JSON con la siguiente forma:
{
"ok": true,
"job_id": "...",
"status": "done",
"transcript_preview": "first 300 chars...",
"url_to_full": "https://whipscribe.com/view?id=...",
"duration_sec": 967.3,
"beta_notice": "..."
}
En caso de error:
{
"ok": false,
"error": {
"code": "upload_failed",
"message": "human-readable explanation",
"retryable": true
}
}
Variables de entorno
| Variable | Requerida | Predeterminado | Propósito |
|---|---|---|---|
WHIPSCRIBE_API_KEY | No | — | Clave de API (vincula los trabajos a tu cuenta y sus créditos; sin ella, cada grabación sigue obteniendo una vista previa gratuita) |
WHIPSCRIBE_API_BASE | No | https://whipscribe.com/api/v1 | Sobrescribe la URL base de la API (por ejemplo, para staging) |
WHIPSCRIBE_MCP_TELEMETRY | No | 1 | Establécelo en 0 para desactivar la telemetría anónima de uso |
WHIPSCRIBE_MCP_POLL_TIMEOUT_SECONDS | No | 600 | Máximo de segundos que transcribe_url / transcribe_file espera antes de devolver el job_id con un estado no terminal |
WHIPSCRIBE_MCP_POLL_INTERVAL_SECONDS | No | 3 | Segundos entre sondeos de estado del trabajo durante la transcripción |
Privacidad
Telemetría anónima opcional (activada por defecto; desactívala con WHIPSCRIBE_MCP_TELEMETRY=0):
Lo que recopilamos (solo metadatos):
- Hash de instalación anónimo:
sha256(machine_id + salt)[:16] - Versión del paquete, sistema operativo, versión de Python
- Nombre de la herramienta, duración en milisegundos, código de error
Lo que nunca recopilamos:
- URLs que transcribes
- Rutas de archivos locales
- Claves de API
- Texto de transcripciones
- Correo electrónico ni ninguna información de identificación personal
El algoritmo de anonimización está en este repositorio (src/whipscribe_mcp/telemetry.py). Inspecciónalo. Si no te resulta aceptable, desactívalo.
Precios
Consulta whipscribe.com/pricing para ver las tarifas actuales. Cada grabación obtiene una vista previa gratuita, con o sin clave de API; los paquetes de créditos comienzan en $4 y nunca caducan, y el plan Workspace cuesta $19 al mes (uso justo de 300 horas al mes).
Licencia
Licencia Apache 2.0. Copyright 2026 Neugence Technology Pvt. Ltd.
Contacto
- Sitio web: whipscribe.com
- Correo electrónico: contact@neugence.ai
- Problemas: github.com/neugence/whipscribe-mcp/issues