El servidor MCP de ToRun
Última actualización: 11 nov 2026
Qué es
El servidor MCP de ToRun permite que un agente de programación use ToRun mientras trabaja en tu proyecto. Un agente compatible con servidores MCP remotos, como Claude Code, Cursor u opencode, puede crear imágenes, voz, música y vídeo, editar imágenes, transcribir audio, ejecutar investigaciones profundas y las plantillas de workflow de ToRun, y publicar una página HTML o un juego de navegador como enlace, sin que salgas de tu editor. Lo que crea el agente se paga desde tu cuenta de ToRun a los mismos precios que en la app y se guarda en tu cuenta de ToRun como todo lo que creas en la app.
Dirección e inicio de sesión
| Dirección del servidor | https://mcp.torun.ai/mcp |
| Transporte | HTTP (servidor MCP remoto) |
| Inicio de sesión | Authorization: Bearer <your developer key> |
Una clave de desarrollador empieza por trn_live_. La creas en la página Desarrolladores de tu cuenta de ToRun: consulta Claves de desarrollador. Configuración de cada herramienta:
Herramientas
| Herramienta | Qué hace | De pago |
|---|---|---|
image_generate |
Crea imágenes a partir de un prompt: sprites, iconos, fondos, ilustraciones. Devuelve las imágenes, o un id de trabajo si tardan más de lo que el agente decidió esperar. | Sí |
image_edit |
Cambia una imagen a partir de una instrucción escrita: un fondo nuevo, otro color, un objeto añadido o eliminado, otro estilo. La imagen es una que el agente creó con ToRun o un enlace a un archivo PNG, JPEG o WebP de hasta 20 MB; una imagen indicada por enlace se guarda primero en tu biblioteca de ToRun. Devuelve las imágenes o un id de trabajo, como image_generate. |
Sí |
tts_generate |
Convierte texto en voz y devuelve el archivo de audio y cuánto dura, medido a partir del archivo. | Sí |
stt_transcribe |
Convierte en texto lo que se dice en un archivo de audio o vídeo, con segmentos temporizados para subtítulos cuando el agente los pide. Acepta archivos mp3, m4a, wav, webm, ogg, opus, flac, aac y mp4 de hasta 25 MB. | Sí |
music_generate |
Compone una pista, con o sin voces, y devuelve un id de trabajo. | Sí |
video_generate |
Crea un clip corto a partir de un prompt y devuelve un id de trabajo. | Sí |
job_status |
Informa del estado de un trabajo de imagen, música o vídeo y devuelve el archivo cuando está listo. | Gratis |
deep_research_start |
Inicia una investigación profunda sobre una pregunta: busca en la web en muchas fuentes y escribe un informe con sus fuentes citadas. Devuelve un id de trabajo. | Sí |
deep_research_status |
Informa del estado de una investigación profunda y devuelve el informe cuando está listo. | Gratis |
workflow_template_search |
Encuentra las plantillas de workflow de ToRun, procesos de varios pasos ya preparados, y muestra lo que genera cada una, lo que suele costar y los datos que necesita. | Gratis |
workflow_run |
Ejecuta una plantilla de workflow con los datos que le da el agente y devuelve un id de trabajo. | Sí |
workflow_run_status |
Informa del estado de una ejecución de workflow y de los Runs que ha costado hasta ahora, y devuelve sus resultados cuando están listos. | Gratis |
canvas_publish |
Publica como enlace una página HTML de un solo archivo o un juego de navegador. | Gratis |
account_balance |
Muestra la asignación del plan y el monedero restantes, y el límite mensual y el gasto de esta clave. | Gratis |
Un enlace a un archivo que devuelve una herramienta se descarga sin iniciar sesión, así que el agente puede guardar el archivo en tu proyecto. Conserva el enlace completo, incluida la parte que va después del signo de interrogación.
Una página publicada no está listada: cualquiera que tenga el enlace puede abrirla, pero no aparece en Explorar de ToRun y los buscadores no la indexan.
Trabajos largos
La música, el vídeo, las investigaciones profundas y las ejecuciones de workflow tardan más que una llamada. La herramienta devuelve un id de trabajo, y el agente vuelve a preguntar hasta que el resultado está listo: job_status para imágenes, música y vídeo, deep_research_status para un informe de investigación y workflow_run_status para una ejecución de workflow. Una imagen que no está lista dentro del tiempo de espera que eligió el agente también vuelve como un id de trabajo.
Una investigación tarda de 1 a 10 minutos y sigue adelante aunque termine la conversación con tu agente; el informe también aparece como una conversación propia en tu lista de chats de ToRun. Una ejecución de workflow tarda desde un minuto hasta decenas de minutos, y la ejecución y sus archivos aparecen en tu cuenta de ToRun. Un informe largo o un conjunto largo de resultados llega por partes, y el agente pide el resto.
Cómo se pagan las llamadas
- Cada llamada de pago se cobra en Runs a los mismos precios que en la app.
- Se paga primero con la asignación de tu plan y después con tu monedero, si lo permitiste en la clave.
- La asignación gratuita nunca paga llamadas a la API.
- Una ejecución de workflow se cobra paso a paso mientras se ejecuta.
- Cada cargo aparece en tu página de facturación bajo la clave que lo hizo.
Una llamada que supera el umbral de la clave pregunta primero
Cada clave tiene un umbral. Cuando una sola llamada costaría más que eso, la herramienta todavía no la ejecuta. En una ejecución de workflow, lo que se compara es la estimación de la ejecución.
- Si tu herramienta puede mostrar un formulario cuando un servidor MCP hace una pregunta (MCP elicitation), ToRun te pregunta ahí: el formulario muestra el precio y pregunta si continuar. La llamada se ejecuta si dices que sí; si la rechazas, no se ejecuta nada.
- Si no, la herramienta responde con el precio, tu agente te lo muestra y la llamada solo se ejecuta cuando el agente la repite después de que aceptes.
Preguntar no tiene coste.
Límites
Cada clave tiene un límite de gasto mensual y otro diario, y un límite de llamadas por minuto. Cada cuenta también tiene un límite diario de páginas publicadas. El límite mensual y el umbral de una clave los fijas al crearla; los valores predeterminados aparecen en torun.ai/developers. Para cambiarlos, crea una clave nueva con los ajustes que quieras y revoca la antigua.
Cuando se rechaza una llamada
| Al agente se le dice | Qué hacer |
|---|---|
| La llamada necesita una clave de desarrollador | Comprueba que TORUN_API_KEY contiene la clave completa y que la clave no se ha revocado. |
| La asignación del plan se ha agotado y la clave no puede gastar del monedero | Espera a que se renueve la asignación, o crea una clave que pueda gastar del monedero. |
| Las claves de desarrollador solo gastan la asignación de un plan de pago o el monedero | Recarga o suscríbete. |
| La clave ha alcanzado su límite de gasto mensual o diario | Espera al día o mes siguiente, o crea una clave con un límite más alto. |
| La clave hizo demasiadas llamadas en un minuto | Espera un momento e inténtalo de nuevo. |
| La clave no tiene el ámbito que necesita una herramienta | Los ámbitos de una clave no se pueden cambiar. Crea una clave nueva: una clave nueva incluye todos los ámbitos. |
| El archivo debe indicarse como un id de la biblioteca de ToRun o como un enlace https, no ambos | Indica exactamente uno de los dos. |
| No hay ningún archivo así en la biblioteca de ToRun de la cuenta | Usa un archivo de esta cuenta. Un enlace de ToRun al archivo de otra cuenta se rechaza de la misma forma. |
| El archivo es demasiado grande, no está en un formato que acepte la herramienta o no se pudo descargar | Imágenes para image_edit: PNG, JPEG o WebP, de hasta 20 MB. Archivos para stt_transcribe: mp3, m4a, wav, webm, ogg, opus, flac, aac o mp4, de hasta 25 MB. Un enlace debe poder descargarse sin iniciar sesión. |