Référence des outils MCP | Manuel Kirocast

Unités de mesure

Les positions vont de 0 à 1, mesurées depuis le coin supérieur gauche : celui de la capture d’écran pour piloter l’écran, celui de l’enregistrement brut pour le montage. Pendant un enregistrement, c’est la zone enregistrée, le même repère que celui du fichier d’événements.
Les temps sont en secondes sur la timeline de montage, qui raccourcit à mesure que des passages sont coupés.
Les projets sont désignés par le chemin de leur paquet .kirocast. La plupart des outils travaillent sur le projet modifié le plus récemment quand aucun n’est précisé.

Tant que Kirocast est fermé, votre agent voit un seul outil, launch_kirocast, qui l’ouvre. La liste ci-dessous apparaît dès que Kirocast est lancé. Voir Connecter un autre client MCP.

Enregistrement

Outil	Ce qu’il fait
`start_recording`	Lance l’enregistrement d’un écran, d’une fenêtre ou d’une zone, avec le micro, l’audio du système et la caméra sur demande. Se met en pause entre les actions tant que `pace_to_actions` est activé, ce qui est le réglage par défaut.
`stop_recording`	Arrête et enregistre le projet avec ses zooms et ses signaux de clic, et vous affiche la carte d’aperçu. Renvoie le chemin du projet et sa durée.
`pause_recording`	Met la prise en pause. Le passage en pause est retiré de la vidéo, de l’audio et de la piste du curseur.
`resume_recording`	Reprend une prise en pause.
`recording_status`	Indique si une prise est en cours, depuis combien de temps et sur quelle source ; les écrans disponibles ; et si Kirocast peut capturer l’écran et piloter le pointeur.

Voir et agir

screenshot utilise l’enregistrement de l’écran ; les outils de pointeur et de clavier utilisent l’accessibilité. Voir Autoriser et révoquer des agents.

Outil	Ce qu’il fait
`screenshot`	Renvoie une image fixe de l’écran, où les fenêtres de Kirocast sont laissées de côté. Les positions du pointeur se mesurent sur cette image.
`click`	Déplace le pointeur le long d’une courbe et clique : bouton gauche, droit ou du milieu, simple ou double clic. Enregistré comme vos clics, avec signal visuel et zoom automatique.
`move_mouse`	Déplace le pointeur sur une trajectoire adoucie, pour révéler un état de survol ou désigner un élément.
`drag`	Appuie à un point, se déplace vers un autre et relâche : curseurs, poignées, fichiers.
`scroll`	Fait défiler d’un nombre de pixels, de façon fluide sur une durée donnée.
`type`	Saisit du texte dans le champ actif. Accents, emoji et symboles s’affichent correctement quelle que soit la disposition du clavier.
`press_key`	Appuie sur une touche avec ses modificateurs, comme `cmd+s`, `escape` ou `return`.
`wait`	Patiente jusqu’à 30 secondes. L’enregistrement continue : le spectateur voit la pause.

Projets

Outil	Ce qu’il fait
`list_projects`	Liste les projets sur le disque, du plus récemment modifié au plus ancien, 20 par défaut.
`describe_project`	Tout ce qu’il faut pour monter un projet : durée, fragments, moments de clic, zooms et clés de position, annotations, commentaires, style, caméra, versions et arrière-plans proposés. Peut se limiter à un intervalle de temps.
`read_source_frame`	Une image de l’enregistrement brut à un instant donné, pour viser une modification.
`read_rendered_frame`	Une image exactement telle que l’export la dessinera, pour vérifier une modification avant d’exporter.
`open_project`	Ouvre un projet dans l’éditeur, où chaque modification suivante s’affiche à l’écran, en une étape d’annulation.
`rename_project`	Renomme le projet et son paquet sur le disque, et renvoie le nouveau chemin.
`duplicate_project`	Copie un projet entier, versions comprises, à côté de l’original.
`delete_project`	Place un projet dans la corbeille, après l’avoir fermé dans l’éditeur. Le projet doit être désigné explicitement.

Montage

Outil	Ce qu’il fait
`cut`	Retire un passage et referme l’espace. Les annotations entièrement comprises dans le passage partent avec lui.
`trim`	Garde seulement la partie entre un début et une fin.
`set_speed`	Change la vitesse de lecture sur un passage, de 0,2× à 20×.
`set_zoom`	Ajoute un zoom de 1× à 10× à un instant donné, éventuellement visé sur un point. Peut aussi effacer tous les zooms.
`update_zoom`	Déplace, recale dans le temps, change le niveau ou la cible d’un zoom.
`roll_zoom_seam`	Déplace la limite entre deux zooms, comme lorsqu’on la fait glisser sur la piste Zoom.
`rebuild_zoom_position_keys`	Donne à un zoom une nouvelle paire de clés de position, comme Rebuild position keys dans l’éditeur.
`remove_zoom`	Supprime un zoom. Le premier fixe le niveau d’ouverture et reste en place ; réglez-le sur 1× pour ouvrir en plan large.
`add_position_key`	Oriente le cadre vers un point à un instant donné, pour un panoramique pendant un zoom.
`update_position_key`	Déplace ou réoriente une clé de position.
`remove_position_key`	Supprime une clé de position. La première ancre la piste et reste en place.
`set_auto_timeline`	Modifie les réglages Animation (transition du zoom, anticipation du clic, délai avant dézoom, courbe) et reconstruit les zooms automatiques. Une reconstruction par-dessus des retouches manuelles demande un accord explicite.
`annotate`	Ajoute un ovale de mise en avant, une main tap-tap ou un masque de confidentialité, avec une étiquette nommant ce qu’il désigne.
`update_annotation`	Déplace, redimensionne, recale dans le temps ou renomme une annotation, ou change le flou d’un masque ou la taille d’un tap-tap.
`remove_annotation`	Supprime une annotation, toutes les annotations, ou toutes celles d’un même type.
`set_style`	Règle l’arrière-plan, les marges, l’arrondi des coins, l’ombre, les sous-titres et leur taille, les animations de clic, le style, la taille et le lissage du pointeur, et la bulle webcam.
`set_camera`	Affiche, dimensionne, place, arrondit ou retourne la bulle webcam.

Versions

Chaque modification s’applique à la version courante. La timeline d’origine reste verrouillée, telle que l’enregistrement l’a produite. Voir Versions.

Outil	Ce qu’il fait
`list_versions`	Liste les versions d’un projet et indique laquelle est courante et laquelle est l’original verrouillé.
`create_version`	Copie la version courante et bascule sur la copie.
`rename_version`	Renomme une version, la version courante par défaut.
`switch_version`	Fait d’une autre version la version courante. Choisir l’original en ouvre une nouvelle copie.
`delete_version`	Supprime définitivement une version. L’original et la version courante restent.

Sous-titres

Outil	Ce qu’il fait
`narrate`	Écrit une phrase de commentaire dans la transcription et active les sous-titres. Pendant une prise, la phrase est horodatée à cet instant.
`clear_narration`	Retire toutes les phrases de commentaire, pour tout réécrire. Les sous-titres restent activés.
`transcribe`	Transcrit l’audio de l’enregistrement sur votre Mac, en arrière-plan. La première fois, le modèle vocal se télécharge une seule fois, environ 600 Mo, après que votre agent vous l’a demandé.
`transcription_status`	L’avancement d’une transcription, et la présence du modèle vocal sur le disque.
`edit_transcript`	Remplace la transcription par un texte corrigé, en conservant le minutage des mots autant que possible.
`export_captions`	Écrit un fichier SRT ou WebVTT calé sur la vidéo montée.
`delete_transcription_model`	Retire le modèle vocal du disque. Vos transcriptions restent.

Voix

narrate écrit des lignes de sous-titres. Pour une voix qu’on entend, votre agent crée une prise ElevenLabs, une fois que vous l’y autorisez. Voir Autoriser et révoquer des agents.

Outil	Ce qu’il fait
`list_voices`	Liste les voix, les crédits restants, la limite par prise et si cet agent peut générer. Gratuit.
`generate_narration`	Lit un script comme nouvelle prise et en tire les sous-titres. `pace_to_captions` fait commencer chaque ligne avec son sous-titre ; remplacer le son d’un enregistrement demande `replace_audio`. Consomme vos crédits.
`use_narration_take`	Fait d’une prise enregistrée, ou du son d’origine, celle qu’on entend. Gratuit.

Les sous-titres retouchés à la main restent, sauf si votre agent passe replace_captions. Projet ouvert, vous voyez la prise arriver et pouvez l’annuler.

Export

Outil	Ce qu’il fait
`export`	Produit un MP4 ou un GIF, en High par défaut (1080p, jusqu’à 60 i/s), ou une vidéo destinée à un modèle avec `for_ai`. Renvoie les chemins de la vidéo, du fichier d’événements et, si le projet en a une, de la transcription. Utilise votre licence.
`read_events`	Lit le fichier d’événements d’un export : chaque clic, zoom, coupe et annotation, horodaté sur cette vidéo.

Voir Exporter en MP4 et GIF pour les cinq niveaux de qualité, et Export pour l’IA pour la vidéo à la taille d’un modèle.