For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Polling rule. Save every run_id. Wait at least 15 seconds between polls, or 2 seconds per run for bigger batches (40 seconds for 20 runs). Then read every run_id in one flora_list_generations call (up to 20 per call). For example: flora_list_generations({"run_ids": ["run_a", "run_b"]}). For Technique runs, also pass "technique_id". Polling faster returns 429 or cooldown errors with retry_after_seconds.

Tool
What it does
Labels

List saved Techniques with their declared inputs, outputs and run cost.

read-only

Read one Technique's declared inputs and outputs.

read-only

Run a saved Technique on your inputs.

writes, destructive, spends money, async

List past Technique runs with their status, cost and outputs.

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

Argument
Type
Required
Notes

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:

Full description from the server

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

Argument
Type
Required
Notes

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:

Full description from the server

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.

Media inputs must be public https URLs, or the call fails with input_validation_error (HTTP 400). During the run FLORA downloads media only from its own hosts (media.flora.ai, ik.imagekit.io) and a short storage allowlist, so a URL on another host is accepted and then fails partway: upload other files with flora_create_asset and pass the url it returns. There's no workspace_id argument: the run bills the connection's workspace, and its outputs land in a private project FLORA keeps for that Technique.

Arguments

Argument
Type
Required
Notes

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 before: flora_list_generations

Example prompt: "Run our Background swap Technique on this product photo with a beach backdrop."

Example call:

Full description from the server

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

Argument
Type
Required
Notes

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:

Full description from the server

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

Argument
Type
Required
Notes

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:

Full description from the server

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

Argument
Type
Required
Notes

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

Example prompt: "What settings does FLORA's color grade action take?"

Example call:

Full description from the server

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

Argument
Type
Required
Notes

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:

Full description from the server

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

Argument
Type
Required
Notes

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

Example prompt: "Add a crop-to-4:5 action to my canvas."

Example call:

Full description from the server

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

Argument
Type
Required
Notes

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 before: flora_add_to_canvas

Example prompt: "Let me tweak the color grade on this photo before you apply it."

Example call:

Full description from the server

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.

Before writing the code, the agent loads the flora-action-studio skill with flora_discover_skills. It has a tested template for each runtime and the @flora-* annotations the code declares its inputs, outputs and params with.

Arguments

Argument
Type
Required
Notes

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.

Example prompt: "Write a pixelate action for my canvas with an adjustable block size."

Example call:

Full description from the server

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

Argument
Type
Required
Notes

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:

Full description from the server

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

Argument
Type
Required
Notes

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:

Full description from the server

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

Argument
Type
Required
Notes

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.

Example prompt: "Run the crop action on my canvas again at 4:5."

Example call:

Full description from the server

Last updated

Was this helpful?