Nodaro Docs
DocumentationNode ReferenceModelsAI Agents (MCP)DevelopersSelf-hostingResearch
Tools reference

Utility, recipes and skills

Test the connection with ping, load tested recipes with get_recipe, start the Film Director skill, and prepare UGC website videos with the builder tools.

The utility, recipe and skill tools help an assistant start well. ping tests the connection, get_recipe loads tested multi-step playbooks, start_film_director loads the Film Director skill, and the three UGC builders prepare a creator video about a website. None of them generates media or spends credits.

Other tools that return instructions are documented with their family: start_workflow_editor and get_node_skill, start_video_director, get_studio_production_skill and get_recast_authoring_skill.

ping

Returns pong, your Nodaro user id and the name of the client that called it. Use it to check that the connector works.

Permission: none, always visible. Credits: free.

This tool has no parameters.

get_recipe

Lists and loads content recipes: tested playbooks that walk an assistant through a full multi-tool flow, such as a narrated animated explainer. The tool only returns text. The actions a recipe asks for are done with the other tools, each with its own permission and price. See Content recipes for the catalog.

Permission: none, always visible. Credits: free.

ParameterTypeNotes
recipestringA recipe name, such as video-explainer. Leave it out to list every recipe.
filestringA reference file inside the recipe, such as references/prompts.md. Needs recipe.

Returns: without arguments, each recipe's name, description and trigger phrases. With recipe, the recipe's full instructions. With file, that file. An unknown name returns an error with the valid names.

On Nodaro Cloud, the list also includes a UGC website video: a creator talking to the camera about a site, with its screenshots shown as cards.

start_film_director

Returns the Film Director skill: the instructions that make the assistant direct a film in 10 stages, from the script to the final cut, and build an editable workflow on your canvas as it goes. Assistants call it first for any multi-shot video request, such as a trailer, a short film, a music video, a reel or an ad. See Film Director.

Permission: none, always visible. Credits: free.

This tool has no parameters. It changes nothing.

The UGC video builders

Three free helpers used by the UGC website recipe. They generate nothing: each one checks or prepares its part and returns the exact arguments of the next generation calls. They are available on Nodaro Cloud only, and need no permission, except build_ugc_creator with a saved character, which needs assets:read.

build_ugc_creator

Prepares the creator who talks to the camera: a newly sampled person, one of your saved characters, or your own photo.

ParameterTypeNotes
sourcestringRequired. sampled, character or photo.
character_idstringFor character: the saved character.
photo_urlstringFor photo: your photo.
genderstringwoman or man.
product_category, overrides, previous, seedOptional details to steer or repeat the sampled creator.

Returns: the creator's identity images, or an image prompt with the exact arguments of the image generation to run next.

build_ugc_clips

Checks a UGC video script and turns it into clip requests. An invalid script returns every problem at once, each with its fix.

ParameterTypeNotes
planobjectRequired. The script.
genderstringRequired. woman or man.
identity_imagesarrayRequired. One or two images of the creator.
traits, seedOptional.
spent_job_idsarrayThe jobs already run for this video, which the quote lists as spent.

Returns: one ready-to-run generate_video call per clip, the call that joins the clips, and a credit quote for the rest of the video.

build_ugc_cards

Times the screenshot cards and the captions of a UGC video from its word timings.

ParameterTypeNotes
planobjectRequired. The script.
alignment or wordsarrayThe word timings, from forced_alignment or from transcribe.
video_duration_msnumberThe length of the video.

Returns: the layers for overlay_images and the caption segments for add_captions.

Frequently asked questions

Last updated on

On this page