Referencia de herramientas MCP de Scenaloom

Estas son todas las herramientas que el servidor MCP de Scenaloom ofrece a una aplicación de IA conectada, con el permiso que necesita cada una. Los nombres de las herramientas y las descripciones que lee la aplicación están en inglés; la aplicación te responde en tu idioma. Para conectar una aplicación, consulta Conecta Scenaloom a tus aplicaciones de IA.

Herramientas

Herramienta	Permiso	Qué hace
list_projects	Leer	Lista los proyectos del guionista, del más reciente al más antiguo, con un filtro opcional por búsqueda o por tipo (guion, novela o cine).
get_project	Leer	Devuelve el título, la descripción y el tipo de un proyecto, el rol del guionista, sus episodios con el número de escenas y el recuento de personajes, lugares y comentarios abiertos.
read_script	Leer	Lee el guion de un episodio como bloques tipados (encabezado de escena, acción, personaje, diálogo, acotación, transición, plano) o en Fountain, por tramos o escena a escena, con la revisión y los hashes que necesitan los cambios.
list_scenes	Leer	Enumera las escenas de un episodio en orden, con su encabezado, lugar, personajes, rango de bloques y resumen.
list_entities	Leer	Devuelve los personajes, lugares o elementos de utilería del proyecto con sus datos, el número de escenas en que aparecen y las relaciones entre personajes.
get_story_structure	Leer	Devuelve los beats, el esquema del proyecto y el esquema del episodio.
read_novel	Leer	Devuelve la lista de capítulos de una novela o el texto de un capítulo en páginas de hasta 40.000 caracteres, con la revisión que necesitan los cambios.
search_project	Leer	Busca una línea, un nombre o una frase en el guion, la novela, los personajes y lugares, los comentarios y los beats de un proyecto.
list_comments	Leer	Lista los comentarios abiertos o resueltos de un proyecto, con su anclaje, su autor y la aplicación que los escribió.
list_generations	Leer	Lista las tareas de generación de imagen, video y audio con su estado y sus créditos.
get_generation	Leer	Devuelve el estado y el progreso de una tarea de generación, los créditos usados o reembolsados y su resultado.
propose_script_edits	Editar	Prepara hasta seis cambios en un episodio (insertar una acción, reescribir una línea, sustituir texto, sustituir en todo el guion o añadir un beat) y devuelve vistas previas del antes y el después, sin cambiar nada hasta apply_script_edits.
apply_script_edits	Editar	Aplica una propuesta que el guionista ha aprobado, integrada con los cambios en directo, registrada en el historial de versiones y reversible.
undo_script_edits	Editar	Deshace un lote de cambios aplicado, salvo que choque con cambios posteriores.
propose_novel_edits	Editar	Prepara cambios de buscar y sustituir o un pasaje que se añade al final de un capítulo y devuelve vistas previas; cada texto buscado debe aparecer exactamente una vez.
apply_novel_edits	Editar	Aplica una propuesta aprobada en una novela, integrada con lo que escriba cualquier otra persona en el capítulo en ese momento.
undo_novel_edits	Editar	Retira de su capítulo las ediciones aplicadas a una novela y conserva lo escrito después; no lo hace si alguien ha reescrito esas palabras.
update_entity	Editar	Cambia los detalles de un personaje, una localización o un objeto. Se rechaza si alguien cambió la ficha después de leerla; quien escribe puede deshacerlo desde el panel de IA durante un día.
undo_entity_update	Editar	Deshace un cambio de update_entity, siempre que esos campos sigan como los dejó.
create_project	Editar	Crea un proyecto de guion o de novela dentro de los límites del plan del guionista.
create_episode	Editar	Añade un episodio a una serie.
add_comment	Comentar	Deja una nota en un bloque del guion, marcada como escrita por la aplicación conectada, y solo avisa a los colaboradores cuando el guionista lo confirma.
resolve_comment	Comentar	Marca un comentario como resuelto o lo vuelve a abrir.
get_credits	Gastar créditos	Devuelve el saldo de créditos y el plan del guionista, la configuración de gasto y el límite diario de esta aplicación, y lo que ha gastado hoy.
quote_generation	Gastar créditos	Calcula el precio de una generación de imagen, video o audio sin gastar nada y devuelve un presupuesto de un solo uso válido durante cinco minutos.
start_generation	Gastar créditos	Gasta los créditos presupuestados e inicia la generación, solo después de que el guionista confirme el coste.
cancel_generation	Gastar créditos	Cancela una generación en curso; los créditos se reembolsan según la Política de créditos.

Las herramientas de lectura nunca cambian nada. Las de edición solo modifican tu trabajo mediante una propuesta que has aprobado, y cada lote aplicado se puede deshacer. La única herramienta que gasta créditos es start_generation, y solo después de que confirmes el coste presupuestado.

Cómo funciona un cambio

La aplicación lee la escena con read_script, que devuelve cada bloque con su id y la revisión del guion.
Llama a propose_script_edits con hasta seis cambios. Scenaloom los comprueba y devuelve una vista previa del antes y el después de cada uno; la propuesta espera 30 minutos y también aparece en el panel de IA del editor.
La aplicación te muestra las vistas previas. Cuando das tu visto bueno, llama a apply_script_edits. Si alguien ha cambiado el guion entretanto, el cambio se rechaza y la aplicación vuelve a leer.
El resultado indica el id del lote. undo_script_edits con ese id revierte el lote y, en cualquier caso, el historial de versiones conserva el borrador anterior.

Las novelas funcionan igual con read_novel, propose_novel_edits y apply_novel_edits: cada pasaje que se sustituye debe aparecer exactamente una vez en el capítulo, así que un cambio nunca puede caer en el sitio equivocado.

Cómo se paga una generación

quote_generation calcula el precio de la solicitud sin gastar nada y devuelve un presupuesto válido durante cinco minutos que solo se puede usar una vez.
La aplicación te indica el coste y el saldo que te quedará, y solo llama a start_generation si estás de acuerdo. Las aplicaciones que admiten confirmaciones te muestran la confirmación de Scenaloom; las demás solo pueden gastar dentro del límite diario que hayas fijado.
get_generation informa del progreso y del resultado. Si el precio ha cambiado después del presupuesto, Scenaloom no inicia la generación, y una generación fallida se reembolsa según la Política de créditos.

Recursos y prompts

Las aplicaciones que permiten explorar recursos pueden adjuntar a una conversación un proyecto, un episodio en Fountain, un capítulo de novela o la biblia de la historia del proyecto (personajes, lugares, utilería, relaciones, beats y esquema). Los prompts ponen en marcha tareas habituales: una revisión a fondo del guion al estilo script doctor, notas sobre la estructura de beats, la reescritura de una escena, notas de una lectura en mesa y una logline con su sinopsis. Los títulos de los prompts siguen el idioma de tu interfaz de Scenaloom.

Errores que puede mostrar una aplicación

Mensaje	Qué hacer
El guion cambió después de la propuesta (The script changed after the proposal)	Vuelve a leer la escena y propón el cambio de nuevo.
Permiso insuficiente (Insufficient scope)	A la aplicación le falta un permiso. Desconéctala en Aplicaciones conectadas y vuelve a conectarla marcando ese permiso.
No encontrado (Not found)	El proyecto se ha eliminado o ya no tienes acceso a él.
Esta aplicación no puede confirmar gastos (This app can't confirm spending)	Fija un límite diario de créditos para la aplicación o inicia la generación en Scenaloom.
Demasiadas solicitudes (Rate limited)	Espera los segundos indicados y vuelve a intentarlo.