Technique and action tools
Reference for the FLORA MCP tools that find and run saved Techniques, and run prebuilt or custom actions headless or on a canvas.
These FLORA MCP tools run saved Techniques (your team's multi-step workflows) and actions (deterministic transforms such as crop, stitch and color grading). Techniques spend money on every run; actions are free but need a workspace plan that includes them. Actions run headless with inputs you pass (flora_run_action) or as a node on the canvas (flora_add_action, then flora_run_canvas_action).
For a worked example, see Run your team's Technique.
List saved Techniques with their declared inputs, outputs and run cost.
read-only
Search the prebuilt action registry (crop, stitch, split, color grade and more) and read each action's inputs and params.
read-only
Read one prebuilt action's definition: its inputs, outputs and the params it accepts, with their types and defaults.
read-only
Run a prebuilt action headless on inputs you pass by URL or text. Nothing appears on the canvas.
writes, destructive, async
Place a prebuilt action node on a canvas. It runs nothing until flora_run_canvas_action runs it.
writes
Open FLORA's action studio on a prebuilt action and the inputs you pass, without running it, so the user can tune its params first.
read-only
Add a custom action node to a canvas from Python or JavaScript code you write. The code is stored on the node, not run.
writes
Change an action node on a canvas in place: its label and params, and for a custom action its code, language and runtime.
writes, destructive
Open FLORA's action studio on an action node already on a canvas, without running it, so the user can tune its params first.
read-only
Run an action node that's already on a canvas, using the nodes wired into it as inputs.
writes, destructive, async
flora_list_techniques
List saved Techniques with their declared inputs, outputs and run cost.
Labels: read-only
Shown in clients as: List techniques
Use when: The user names a Technique or asks what workflows their team has saved.
Don't use when: You already have the technique_id: use flora_get_technique for its inputs.
Arguments
workspace_id
string
no
Filter by workspace (ws_…).
query
string
no
Filter by technique name.
limit
number
no
Max items to return (default 20).
cursor
string
no
Pagination cursor from a previous call's meta.next_cursor.
Returns: A page of Techniques with their IDs (tech_…), inputs, outputs and run_cost in US dollars, and meta.next_cursor.
Cost: Free. This tool doesn't spend money.
Usually comes after: flora_list_workspaces
Usually comes before: flora_get_technique
Example prompt: "What Techniques does my team have in FLORA?"
Example call:
flora_get_technique
Read one Technique's declared inputs and outputs.
Labels: read-only
Shown in clients as: Get technique
Use when: Right before flora_run_technique: the input IDs it returns are the keys inputs expects.
Don't use when: You don't have the ID yet: find it with flora_list_techniques or flora_list_technique_runs.
Arguments
technique_id
string
yes
Technique to describe (tech_…).
Returns: The Technique's technique_id, name, description, run_cost (US dollars per run), and its declared inputs (IDs and types) and outputs.
Cost: Free. This tool doesn't spend money.
Usually comes after: flora_list_techniques
Usually comes before: flora_run_technique
Example prompt: "What inputs does our Background swap Technique need?"
Example call:
flora_run_technique
Run a saved Technique on your inputs.
Labels: writes · destructive · spends money · async
Shown in clients as: Run technique
Use when: The user wants their team's saved workflow, such as a background swap, relight or upscale, applied to their images or text.
Don't use when: You don't know the input IDs: call flora_get_technique first. For a one-off prompt without a saved workflow, use flora_create_generations.
Arguments
technique_id
string
yes
Technique to run (tech_…).
inputs
object
yes
Input values keyed by the technique's input ids.
open_only
boolean
no
Open the FLORA action studio on these inputs without running or billing: the user's Apply runs the technique once (each Apply bills run_cost). Hosts without MCP Apps cannot show the studio; leave it out there.
Returns: Starts the run right away and returns its run_id. Poll it with flora_list_generations, passing the same technique_id. In clients that show FLORA's in-chat views (MCP Apps hosts such as Claude and ChatGPT), the action studio also opens on that run and waits for it, so don't poll there; Apply runs it again. With open_only: true nothing runs until the user clicks Apply, and run_id is null.
Cost: Spends the Technique's run_cost on every run (returned by flora_get_technique and flora_list_techniques). Tell the user the cost in US dollars first: without open_only, the call itself starts and bills a run, and each Apply in the studio bills again. With open_only: true nothing is billed until the user clicks Apply.
Usually comes after: flora_get_technique, flora_create_asset
Usually comes before: flora_list_generations
Example prompt: "Run our Background swap Technique on this product photo with a beach backdrop."
Example call:
flora_list_technique_runs
List past Technique runs with their status, cost and outputs.
Labels: read-only
Shown in clients as: List technique runs
Use when: The user asks what a Technique produced before, or you need a technique_id from work already done in a workspace.
Don't use when: You're polling runs you just started: use flora_list_generations with run_ids and technique_id.
Arguments
workspace_id
string
no
Filter by workspace (ws_…).
project_id
string
no
Filter by project (prj_…). Use project_id from flora_list_projects or flora_create_project. An API-issued canvas URL's /projects/<id> segment becomes prj_<id>.
technique_id
string
no
Filter by technique (tech_…).
status
string
no
Filter by run status. One of pending, running, completed, failed.
limit
number
no
Max items to return (default 20).
cursor
string
no
Pagination cursor from a previous call's meta.next_cursor.
Returns: A page of runs with status, cost and outputs, and meta.next_cursor.
Cost: Free. This tool doesn't spend money.
Usually comes before: flora_get_technique
Example prompt: "Show me the last five runs of our Background swap Technique."
Example call:
flora_search_actions
Search the prebuilt action registry (crop, stitch, split, color grade and more) and read each action's inputs and params.
Labels: read-only
Shown in clients as: Search actions
Use when: The user wants a deterministic edit, such as cropping, stitching or splitting media, rather than a new generation.
Don't use when: You want generated output: use flora_create_generations or flora_run_technique.
Arguments
query
string
no
Match against action name, id, and description.
limit
number
no
Max items to return (default 10).
Returns: Matching actions, each with its action_id, declared inputs and params (with defaults and options), and charged_cost, plus total_matched.
Cost: Free. Running an action is free too, but the workspace plan must include actions.
Usually comes before: flora_run_action, flora_add_action
Example prompt: "Is there a FLORA action that crops an image to a set aspect ratio?"
Example call:
flora_get_action
Read one prebuilt action's definition: its inputs, outputs and the params it accepts, with their types and defaults.
Labels: read-only
Shown in clients as: Get action
Use when: You know the action_id and need its exact inputs and param keys before flora_run_action, flora_add_action or flora_open_action_studio.
Don't use when: You don't know which action fits: search with flora_search_actions. For a custom action on a canvas, read its node with flora_get_canvas.
Arguments
action_id
string
yes
The prebuilt catalog action. One of color-grade-image-browser, overlay-image-browser, draw-image-browser, pixel-remover-image-browser, magic-eraser-image-browser, crop-image-browser, scene-3d-image-browser, blur-image-browser, change-image-ar-browser, rotate-image-browser, color-filter-image-browser, color-tint-image-browser, filter-color-image-browser, duplicate-image-browser, side-by-side-composite-browser, add-shape-to-image-browser, add-text-to-image-browser, qr-code-generator-browser, resize-image-browser, shader-effect-browser, split-text-browser, find-and-replace-text-browser, concat-text-browser, ken-burns-video, stitch-videos, split-video, extract-video-frames, color-grade-video, video-to-frame-grid, boomerang-video, reverse-video, video-to-long-exposure, video-effect, color-filter-video, speed-up-video, slow-down-video, duplicate-video, greenscreen-video, resize-video, change-video-ar, split-audio-from-video, merge-audio-into-video.
Returns: The action's name, description, declared inputs and outputs, and params with their types and defaults. It runs nothing.
Cost: Free. This tool doesn't spend money.
Usually comes after: flora_search_actions
Usually comes before: flora_run_action, flora_open_action_studio
Example prompt: "What settings does FLORA's color grade action take?"
Example call:
flora_run_action
Run a prebuilt action headless on inputs you pass by URL or text. Nothing appears on the canvas.
Labels: writes · destructive · async
Shown in clients as: Run action
Use when: You need an action's output, such as a crop or a stitched video, without adding nodes to the canvas.
Don't use when: The user wants the result on the canvas: use flora_add_action, then flora_run_canvas_action. Don't pass canvas node IDs or generation IDs as inputs; pass URLs.
Arguments
workspace_id
string
yes
Workspace (ws_…).
project_id
string
yes
Project canvas to run in (prj_…). Use project_id from flora_list_projects or flora_create_project. An API-issued canvas URL's /projects/<id> segment becomes prj_<id>.
action_id
string
yes
The prebuilt catalog action, from flora_search_actions or flora_get_action. One of color-grade-image-browser, overlay-image-browser, draw-image-browser, pixel-remover-image-browser, magic-eraser-image-browser, crop-image-browser, scene-3d-image-browser, blur-image-browser, change-image-ar-browser, rotate-image-browser, color-filter-image-browser, color-tint-image-browser, filter-color-image-browser, duplicate-image-browser, side-by-side-composite-browser, add-shape-to-image-browser, add-text-to-image-browser, qr-code-generator-browser, resize-image-browser, shader-effect-browser, split-text-browser, find-and-replace-text-browser, concat-text-browser, ken-burns-video, stitch-videos, split-video, extract-video-frames, color-grade-video, video-to-frame-grid, boomerang-video, reverse-video, video-to-long-exposure, video-effect, color-filter-video, speed-up-video, slow-down-video, duplicate-video, greenscreen-video, resize-video, change-video-ar, split-audio-from-video, merge-audio-into-video.
inputs
array of object
yes
Inputs in the order the action expects. Media inputs are passed by URL, never by canvas node id or generation id: image, video and audio each need url (a public HTTPS URL, e.g. an asset's url from flora_create_asset/flora_complete_asset or a generation output url from flora_list_generations). text takes text or url. model3d takes url or asset_id. To run an action on a canvas node instead, use flora_run_canvas_action.
inputs[].type
string
yes
Input kind. One of image, video, audio, text, model3d.
inputs[].url
string
no
Public HTTPS URL. Required for image, video and audio; accepted for text and model3d.
inputs[].text
string
no
Inline text value for text inputs; alternatively provide url.
inputs[].asset_id
string
no
Asset ID (asset_…). Only for model3d inputs, as an alternative to url.
inputs[].name
string
no
Optional input name when the action names its inputs.
params
object
no
Values for the action's declared params, keyed as flora_get_action (or flora_search_actions) lists them. The API rejects any key the action does not declare.
state
object
no
Interaction state the FLORA action studio's live preview committed (JSON, at most 256 KiB), replayed by the run. Only the studio sets this; leave it out when calling by hand.
Returns: The run, with a canvas_url to give the user; its outputs come back from flora_list_generations. In clients that show FLORA's action studio, the studio opens, waits for the run itself and hands back its ID, status and outputs, so don't poll.
Cost: Free, but the workspace plan must include actions. A 403 means the plan lacks actions or the credential can't write to that workspace; don't retry either way.
Usually comes after: flora_search_actions
Usually comes before: flora_list_generations
Example prompt: "Crop this product photo to a square."
Example call:
flora_add_action
Place a prebuilt action node on a canvas. It runs nothing until flora_run_canvas_action runs it.
Labels: writes
Shown in clients as: Add action
Use when: The user wants a prebuilt action as a node on the canvas, wired to other nodes.
Don't use when: The node already exists: run it with flora_run_canvas_action, or change it with flora_update_canvas_action instead of adding a second node. For a custom action from code, use flora_create_custom_action. For a one-off result off the canvas, use flora_run_action.
Arguments
project_id
string
yes
Project canvas to add to (prj_…). Use project_id from flora_list_projects or flora_create_project. An API-issued canvas URL's /projects/<id> segment becomes prj_<id>.
action_id
string
yes
The prebuilt catalog action, from flora_search_actions or flora_get_action. One of color-grade-image-browser, overlay-image-browser, draw-image-browser, pixel-remover-image-browser, magic-eraser-image-browser, crop-image-browser, scene-3d-image-browser, blur-image-browser, change-image-ar-browser, rotate-image-browser, color-filter-image-browser, color-tint-image-browser, filter-color-image-browser, duplicate-image-browser, side-by-side-composite-browser, add-shape-to-image-browser, add-text-to-image-browser, qr-code-generator-browser, resize-image-browser, shader-effect-browser, split-text-browser, find-and-replace-text-browser, concat-text-browser, ken-burns-video, stitch-videos, split-video, extract-video-frames, color-grade-video, video-to-frame-grid, boomerang-video, reverse-video, video-to-long-exposure, video-effect, color-filter-video, speed-up-video, slow-down-video, duplicate-video, greenscreen-video, resize-video, change-video-ar, split-audio-from-video, merge-audio-into-video.
params
object
no
Starting values for the action's declared params, keyed as flora_get_action lists them.
label
string
no
Node label on the canvas. Defaults to the action's name.
Returns: The action node, including the UUID that flora_run_canvas_action accepts. The node does nothing until it runs.
Cost: Free, but the workspace plan must include actions.
Usually comes after: flora_search_actions
Usually comes before: flora_add_to_canvas, flora_run_canvas_action
Example prompt: "Add a crop-to-4:5 action to my canvas."
Example call:
flora_open_action_studio
Open FLORA's action studio on a prebuilt action and the inputs you pass, without running it, so the user can tune its params first.
Labels: read-only
Shown in clients as: Open action studio
Use when: The user wants to see or adjust an action's settings before it runs, in a client that shows MCP Apps.
Don't use when: Your client can't show MCP Apps, or the user just wants the result: run it with flora_run_action. For an action node already on a canvas, use flora_open_canvas_action_studio.
Arguments
workspace_id
string
yes
Workspace (ws_…).
project_id
string
yes
Project canvas to run in (prj_…). Use project_id from flora_list_projects or flora_create_project. An API-issued canvas URL's /projects/<id> segment becomes prj_<id>.
action_id
string
yes
The prebuilt catalog action, from flora_search_actions or flora_get_action. One of color-grade-image-browser, overlay-image-browser, draw-image-browser, pixel-remover-image-browser, magic-eraser-image-browser, crop-image-browser, scene-3d-image-browser, blur-image-browser, change-image-ar-browser, rotate-image-browser, color-filter-image-browser, color-tint-image-browser, filter-color-image-browser, duplicate-image-browser, side-by-side-composite-browser, add-shape-to-image-browser, add-text-to-image-browser, qr-code-generator-browser, resize-image-browser, shader-effect-browser, split-text-browser, find-and-replace-text-browser, concat-text-browser, ken-burns-video, stitch-videos, split-video, extract-video-frames, color-grade-video, video-to-frame-grid, boomerang-video, reverse-video, video-to-long-exposure, video-effect, color-filter-video, speed-up-video, slow-down-video, duplicate-video, greenscreen-video, resize-video, change-video-ar, split-audio-from-video, merge-audio-into-video.
inputs
array of object
yes
Inputs in the order the action expects. Media inputs are passed by URL, never by canvas node id or generation id: image, video and audio each need url (a public HTTPS URL, e.g. an asset's url from flora_create_asset/flora_complete_asset or a generation output url from flora_list_generations). text takes text or url. model3d takes url or asset_id. To run an action on a canvas node instead, use flora_run_canvas_action.
inputs[].type
string
yes
Input kind. One of image, video, audio, text, model3d.
inputs[].url
string
no
Public HTTPS URL. Required for image, video and audio; accepted for text and model3d.
inputs[].text
string
no
Inline text value for text inputs; alternatively provide url.
inputs[].asset_id
string
no
Asset ID (asset_…). Only for model3d inputs, as an alternative to url.
inputs[].name
string
no
Optional input name when the action names its inputs.
params
object
no
Values for the action's declared params, keyed as flora_get_action (or flora_search_actions) lists them. The API rejects any key the action does not declare.
Returns: The studio view. It starts no run and writes nothing. When the user clicks Apply, the studio calls flora_run_action once with the chosen params, waits for the run and hands you its run ID, status, outputs and final params, so don't start a run or poll yourself.
Cost: Free. Applying runs the action, which is free too, but the workspace plan must include actions.
Usually comes after: flora_search_actions, flora_get_action
Usually comes before: flora_add_to_canvas
Example prompt: "Let me tweak the color grade on this photo before you apply it."
Example call:
flora_create_custom_action
Add a custom action node to a canvas from Python or JavaScript code you write. The code is stored on the node, not run.
Labels: writes
Shown in clients as: Create custom action
Use when: No prebuilt action does what the user wants, and they want a custom transform as a node on the canvas.
Don't use when: A prebuilt action fits: place it with flora_add_action. The node already exists: change its code with flora_update_canvas_action instead of adding a second node.
Arguments
project_id
string
yes
Project canvas to add to (prj_…). Use project_id from flora_list_projects or flora_create_project. An API-issued canvas URL's /projects/<id> segment becomes prj_<id>.
code
string
yes
Source of the custom action, with its @flora-* annotations.
language
string
yes
Language of code. One of javascript, python.
runtime
string
no
Where custom code runs: python for Python; node (harness helpers) or browser (ES module with a live preview) for JavaScript. Defaults to browser when the JavaScript exports execute, otherwise the language's sandbox. One of node, python, browser.
label
string
no
Node label on the canvas. Defaults to the action's declared name.
params
object
no
Starting values for the params the code declares, keyed as declared.
Returns: The new action node, including the UUID that flora_run_canvas_action accepts. The node does nothing until it runs.
Cost: Free, but the workspace plan must include custom actions.
Usually comes after: flora_discover_skills, flora_get_canvas
Usually comes before: flora_add_to_canvas, flora_run_canvas_action
Example prompt: "Write a pixelate action for my canvas with an adjustable block size."
Example call:
flora_update_canvas_action
Change an action node on a canvas in place: its label and params, and for a custom action its code, language and runtime.
Labels: writes · destructive
Shown in clients as: Update canvas action
Use when: The user wants different settings saved on an action node, or a custom action's code fixed or rewritten.
Don't use when: You want the node to run: this runs nothing, so call flora_run_canvas_action afterwards. Never add a second node to fix a broken action.
Arguments
project_id
string
yes
Project holding the node (prj_…). Use project_id from flora_list_projects or flora_create_project. An API-issued canvas URL's /projects/<id> segment becomes prj_<id>.
node_id
string
yes
The action node to change: its persisted short id (n7) from flora_get_canvas or its UUID. Never predict an id.
label
string
no
New node label.
params
object
no
Param values to store on the node, merged key by key (omitted keys keep their values). Keys as flora_get_canvas lists them for the node.
code
string
no
Custom nodes only: the complete new source, with its @flora-* annotations.
language
string
no
Language of code. One of javascript, python.
runtime
string
no
Where custom code runs: python for Python; node (harness helpers) or browser (ES module with a live preview) for JavaScript. Defaults to browser when the JavaScript exports execute, otherwise the language's sandbox. One of node, python, browser.
Returns: The updated node. It keeps its ID and wiring, and param values the new code still declares survive.
Cost: Free. This tool doesn't spend money.
Usually comes after: flora_get_canvas
Usually comes before: flora_run_canvas_action
Example prompt: "Set the crop action on my canvas to 4:5."
Example call:
flora_open_canvas_action_studio
Open FLORA's action studio on an action node already on a canvas, without running it, so the user can tune its params first.
Labels: read-only
Shown in clients as: Open canvas action studio
Use when: The user wants to see or adjust a canvas action node's settings before it runs, in a client that shows MCP Apps.
Don't use when: Your client can't show MCP Apps, or the user just wants the node run: use flora_run_canvas_action. For an action that isn't on the canvas, use flora_open_action_studio.
Arguments
project_id
string
yes
Project holding the node (prj_…). Use project_id from flora_list_projects or flora_create_project. An API-issued canvas URL's /projects/<id> segment becomes prj_<id>.
node_id
string
yes
Action node to open: the persisted short id (n7) from flora_get_canvas or the UUID flora_add_action or flora_create_custom_action returned. Use the UUID if the short id is ambiguous.
params
object
no
Suggested starting values the studio shows over the node's stored ones, keyed as flora_get_canvas lists them. Nothing is saved: the node keeps its values until the user's Apply runs it with the values on screen.
Returns: The studio view, showing the node's stored params and wired inputs. It starts no run and saves nothing. When the user clicks Apply, the studio calls flora_run_canvas_action once with the values on screen, waits for the run and hands you its run ID, status, outputs and final params, so don't start a run or poll yourself.
Cost: Free. Applying runs the action, which is free too, but the workspace plan must include actions.
Usually comes after: flora_get_canvas
Usually comes before: flora_list_generations
Example prompt: "Open the crop action on my canvas so I can adjust it."
Example call:
flora_run_canvas_action
Run an action node that's already on a canvas, using the nodes wired into it as inputs.
Labels: writes · destructive · async
Shown in clients as: Run canvas action
Use when: An action node exists with its inputs connected, and the user wants its result on the canvas.
Don't use when: The node doesn't exist yet (add it with flora_add_action), or you want a result without touching the canvas (use flora_run_action). Never add a duplicate node to rerun an action.
Arguments
project_id
string
yes
Project holding the node (prj_…). Use project_id from flora_list_projects or flora_create_project. An API-issued canvas URL's /projects/<id> segment becomes prj_<id>.
node_id
string
yes
Action node to run: the persisted short id (n7) from flora_get_canvas or the UUID flora_add_action or flora_create_custom_action returned. Use the UUID if the short id is ambiguous.
params
object
no
Parameter values to store on the node before running, merged key by key into what it holds (a named key is overwritten, omitted keys survive). Keys as flora_get_canvas lists them for the node.
state
object
no
Interaction state the FLORA action studio's live preview committed (JSON, at most 256 KiB). It is saved on the node, replacing the state the node held, and the run replays it. Only the studio sets this; leave it out when calling by hand.
Returns: The run, with a canvas_url to give the user. Params you pass are saved on the node first, and the outputs replace what its result nodes show. In clients that show FLORA's action studio, the studio waits for the run itself, so don't poll.
Cost: Free, but the workspace plan must include actions.
Usually comes after: flora_add_action, flora_add_to_canvas
Usually comes before: flora_list_generations, flora_get_canvas
Example prompt: "Run the crop action on my canvas again at 4:5."
Example call:
Last updated
Was this helpful?