> For the complete documentation index, see [llms.txt](https://docs.flora.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flora.ai/mcp/tools.md).

# FLORA MCP tools reference

Every tool the FLORA MCP server gives your agent, with arguments, cost, labels and example calls, generated from the live server.

This reference lists every tool the [FLORA MCP](https://flora.ai/mcp) server can give your agent, with its arguments, cost and an example call. It's generated from the live server's `tools/list`, so names and arguments match what your agent sees. The pages were last generated from the live server on 2026-11-06.

## How the tool list varies

The tools your agent sees depend on your account, so there's no single fixed count.

* **Anonymous catalog: 58 tools.** Anyone can read `tools/list` at `https://agents.flora.ai/mcp/catalog` without signing in. This reference starts from that list.
* **3 of those are app UI entry points:** [`flora_projects`](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md#flora_projects), [`flora_project_tray`](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md#flora_project_tray) and [`flora_mention_projects`](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md#flora_mention_projects). Your client calls them to show FLORA's own UI, such as the project browser in ChatGPT's sidebar or a conversation tab. The model never calls them, and `flora_list_tools` leaves them out.
* **Signed-in connections only, once the skill API is live:** [`flora_create_skill`](https://docs.flora.ai/mcp/tools/skills-and-discovery.md#flora_create_skill). The anonymous catalog doesn't list it.
* **Account features and the FLORA API decide the rest.** A tool is hidden when your account lacks the feature it needs, and tools or arguments appear only once the FLORA API serves them. Workspace plans don't hide tools: a tool your plan doesn't cover is still listed and refuses the call, for example with a `403` for actions or `paid_plan_required` for edit links.

This reference documents **59 tools**: the 58 in the catalog plus 1 that only some signed-in accounts get. An account that gets every tool can have its agent call 56 of them: all but the app UI entry points.

## See your own list

* Ask your agent: "List the FLORA tools you can use on this connection." It calls [`flora_list_tools`](https://docs.flora.ai/mcp/tools/skills-and-discovery.md#flora_list_tools), which returns each tool's name, title, a short purpose and its safety hints.
* Or open your client's tool list. In Claude Code, run `/mcp` and select `flora`.

## Start here

Most jobs need only these tools, roughly in this order.

| Tool                                                                                                        | What it does                                                                                                    | Labels                                   |
| ----------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
| [`flora_list_workspaces`](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md#flora_list_workspaces) | List the workspaces this account can use, and the current one when the user is already in one.                  | read-only                                |
| [`flora_list_projects`](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md#flora_list_projects)     | List a workspace's projects, most recently active first, with an optional name filter.                          | read-only                                |
| [`flora_list_models`](https://docs.flora.ai/mcp/tools/models-and-loras.md#flora_list_models)                | List the generation models this account can use, or read one model's full parameter list.                       | read-only                                |
| [`flora_create_generations`](https://docs.flora.ai/mcp/tools/generations.md#flora_create_generations)       | Start 1 to 20 image, video, audio, text or 3D generations in one call, or price them first with `quote: true`.  | writes, destructive, spends money, async |
| [`flora_list_generations`](https://docs.flora.ai/mcp/tools/generations.md#flora_list_generations)           | Read up to 20 runs by `run_id` in one call, or list generation history with cost and outputs.                   | read-only                                |
| [`flora_create_asset`](https://docs.flora.ai/mcp/tools/assets.md#flora_create_asset)                        | Bring files into a workspace from a public URL, or reserve a signed upload for a local file. Up to 25 per call. | writes                                   |
| [`flora_run_technique`](https://docs.flora.ai/mcp/tools/techniques-and-actions.md#flora_run_technique)      | Run a saved Technique on your inputs.                                                                           | writes, destructive, spends money, async |
| [`flora_get_usage`](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md#flora_get_usage)          | Read a workspace's balance and spend, or an organization's spend, in US dollars.                                | read-only                                |

## Labels

Each tool carries labels built from the server's annotations and how the tool behaves.

| Label        | Meaning                                                                                                                                               |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| read-only    | Reads data and changes nothing.                                                                                                                       |
| writes       | Creates or changes something in FLORA.                                                                                                                |
| destructive  | The server marks it `destructiveHint`, so most clients ask before running it. It can overwrite or delete work, change who has access, or spend money. |
| spends money | Bills the workspace. Show the user the cost in US dollars and get approval first.                                                                     |
| async        | Starts work that finishes later and returns an ID to poll.                                                                                            |
| app UI only  | Your client calls it to show FLORA's UI. The model never calls it.                                                                                    |

## Skill attribution arguments

[`flora_list_generations`](https://docs.flora.ai/mcp/tools/generations.md#flora_list_generations) and [`flora_create_generations`](https://docs.flora.ai/mcp/tools/generations.md#flora_create_generations) take two optional arguments that tag calls made while following a skill. They don't change what the tool does.

| Argument       | Type   | What to pass                                                                 |
| -------------- | ------ | ---------------------------------------------------------------------------- |
| `skill`        | string | The skill's name, such as `flora-batch-generate`.                            |
| `skill_run_id` | string | One ID the agent makes up and reuses on every call in that skill's workflow. |

See [FLORA MCP skills and plugins](https://docs.flora.ai/mcp/skills.md) for the skills.

## All tools

| Tool                                                                                                                           | What it does                                                                                                                                                                            | Labels                                   | Page                                                                                              |
| ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------- |
| [`flora_list_workspaces`](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md#flora_list_workspaces)                    | List the workspaces this account can use, and the current one when the user is already in one.                                                                                          | read-only                                | [Workspace and project tools](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md)         |
| [`flora_list_projects`](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md#flora_list_projects)                        | List a workspace's projects, most recently active first, with an optional name filter.                                                                                                  | read-only                                | [Workspace and project tools](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md)         |
| [`flora_get_project`](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md#flora_get_project)                            | Read one project's metadata.                                                                                                                                                            | read-only                                | [Workspace and project tools](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md)         |
| [`flora_create_project`](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md#flora_create_project)                      | Create an empty project canvas in a workspace, optionally filed in a shared folder.                                                                                                     | writes                                   | [Workspace and project tools](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md)         |
| [`flora_list_folders`](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md#flora_list_folders)                          | List a workspace's shared project folders with their IDs, names and project counts.                                                                                                     | read-only                                | [Workspace and project tools](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md)         |
| [`flora_rename_project`](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md#flora_rename_project)                      | Rename a project (up to 120 characters).                                                                                                                                                | writes                                   | [Workspace and project tools](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md)         |
| [`flora_open_project`](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md#flora_open_project)                          | Create a one-time sign-in link that opens a project canvas in a browser tab the agent can drive.                                                                                        | writes                                   | [Workspace and project tools](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md)         |
| [`flora_projects`](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md#flora_projects)                                  | Open FLORA's project browser from the client's sidebar.                                                                                                                                 | read-only, app UI only                   | [Workspace and project tools](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md)         |
| [`flora_project_tray`](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md#flora_project_tray)                          | Open FLORA's project tray beside a conversation.                                                                                                                                        | read-only, app UI only                   | [Workspace and project tools](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md)         |
| [`flora_mention_projects`](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md#flora_mention_projects)                  | Search projects for @-mentions while the user types in the client's message box.                                                                                                        | read-only, app UI only                   | [Workspace and project tools](https://docs.flora.ai/mcp/tools/workspaces-and-projects.md)         |
| [`flora_get_canvas`](https://docs.flora.ai/mcp/tools/canvas.md#flora_get_canvas)                                               | Read a whole canvas: every node with its short ID, settings, position, size and status, plus the edges and a revision.                                                                  | read-only                                | [Canvas tools](https://docs.flora.ai/mcp/tools/canvas.md)                                         |
| [`flora_list_canvas_nodes`](https://docs.flora.ai/mcp/tools/canvas.md#flora_list_canvas_nodes)                                 | List a canvas's media nodes with their file URLs.                                                                                                                                       | read-only                                | [Canvas tools](https://docs.flora.ai/mcp/tools/canvas.md)                                         |
| [`flora_add_to_canvas`](https://docs.flora.ai/mcp/tools/canvas.md#flora_add_to_canvas)                                         | Add nodes and edges to a canvas: generation nodes, media from a URL, notes, group frames, timelines and decks.                                                                          | writes                                   | [Canvas tools](https://docs.flora.ai/mcp/tools/canvas.md)                                         |
| [`flora_update_canvas_nodes`](https://docs.flora.ai/mcp/tools/canvas.md#flora_update_canvas_nodes)                             | Edit existing nodes and edges in place: prompt, model, params, label, position, group, notes text, or a media node's file.                                                              | writes, destructive                      | [Canvas tools](https://docs.flora.ai/mcp/tools/canvas.md)                                         |
| [`flora_run_canvas_nodes`](https://docs.flora.ai/mcp/tools/canvas.md#flora_run_canvas_nodes)                                   | Run generation and timeline nodes already on a canvas, in dependency order, with each node's own model, prompt, params and inputs.                                                      | writes, destructive, spends money, async | [Canvas tools](https://docs.flora.ai/mcp/tools/canvas.md)                                         |
| [`flora_arrange_canvas`](https://docs.flora.ai/mcp/tools/canvas.md#flora_arrange_canvas)                                       | Lay out nodes with FLORA's layout engine: Tidy, or a row, column or grid.                                                                                                               | writes, destructive                      | [Canvas tools](https://docs.flora.ai/mcp/tools/canvas.md)                                         |
| [`flora_organize_canvas_fields`](https://docs.flora.ai/mcp/tools/canvas.md#flora_organize_canvas_fields)                       | Sort existing nodes into named fields (group frames), reusing frames that already exist.                                                                                                | writes, destructive                      | [Canvas tools](https://docs.flora.ai/mcp/tools/canvas.md)                                         |
| [`flora_remove_from_canvas`](https://docs.flora.ai/mcp/tools/canvas.md#flora_remove_from_canvas)                               | Delete nodes from a canvas, with every edge that touches them. Deleting a group deletes its members.                                                                                    | writes, destructive                      | [Canvas tools](https://docs.flora.ai/mcp/tools/canvas.md)                                         |
| [`flora_get_canvas_node_document`](https://docs.flora.ai/mcp/tools/canvas.md#flora_get_canvas_node_document)                   | Read the full document of a timeline, deck or notes node, with its revision.                                                                                                            | read-only                                | [Canvas tools](https://docs.flora.ai/mcp/tools/canvas.md)                                         |
| [`flora_update_canvas_node_document`](https://docs.flora.ai/mcp/tools/canvas.md#flora_update_canvas_node_document)             | Replace a timeline's or deck's document, or apply scoped deck edits, guarded by the revision you read.                                                                                  | writes, destructive                      | [Canvas tools](https://docs.flora.ai/mcp/tools/canvas.md)                                         |
| [`flora_create_generations`](https://docs.flora.ai/mcp/tools/generations.md#flora_create_generations)                          | Start 1 to 20 image, video, audio, text or 3D generations in one call, or price them first with `quote: true`.                                                                          | writes, destructive, spends money, async | [Generation and run tools](https://docs.flora.ai/mcp/tools/generations.md)                        |
| [`flora_list_generations`](https://docs.flora.ai/mcp/tools/generations.md#flora_list_generations)                              | Read up to 20 runs by `run_id` in one call, or list generation history with cost and outputs.                                                                                           | read-only                                | [Generation and run tools](https://docs.flora.ai/mcp/tools/generations.md)                        |
| [`flora_view_model3d`](https://docs.flora.ai/mcp/tools/generations.md#flora_view_model3d)                                      | Open an interactive 3D viewer for a 3D run, with GLB links and preview images.                                                                                                          | read-only                                | [Generation and run tools](https://docs.flora.ai/mcp/tools/generations.md)                        |
| [`flora_list_techniques`](https://docs.flora.ai/mcp/tools/techniques-and-actions.md#flora_list_techniques)                     | List saved Techniques with their declared inputs, outputs and run cost.                                                                                                                 | read-only                                | [Technique and action tools](https://docs.flora.ai/mcp/tools/techniques-and-actions.md)           |
| [`flora_get_technique`](https://docs.flora.ai/mcp/tools/techniques-and-actions.md#flora_get_technique)                         | Read one Technique's declared inputs and outputs.                                                                                                                                       | read-only                                | [Technique and action tools](https://docs.flora.ai/mcp/tools/techniques-and-actions.md)           |
| [`flora_run_technique`](https://docs.flora.ai/mcp/tools/techniques-and-actions.md#flora_run_technique)                         | Run a saved Technique on your inputs.                                                                                                                                                   | writes, destructive, spends money, async | [Technique and action tools](https://docs.flora.ai/mcp/tools/techniques-and-actions.md)           |
| [`flora_list_technique_runs`](https://docs.flora.ai/mcp/tools/techniques-and-actions.md#flora_list_technique_runs)             | List past Technique runs with their status, cost and outputs.                                                                                                                           | read-only                                | [Technique and action tools](https://docs.flora.ai/mcp/tools/techniques-and-actions.md)           |
| [`flora_search_actions`](https://docs.flora.ai/mcp/tools/techniques-and-actions.md#flora_search_actions)                       | Search the prebuilt action registry (crop, stitch, split, color grade and more) and read each action's inputs and params.                                                               | read-only                                | [Technique and action tools](https://docs.flora.ai/mcp/tools/techniques-and-actions.md)           |
| [`flora_get_action`](https://docs.flora.ai/mcp/tools/techniques-and-actions.md#flora_get_action)                               | Read one prebuilt action's definition: its inputs, outputs and the params it accepts, with their types and defaults.                                                                    | read-only                                | [Technique and action tools](https://docs.flora.ai/mcp/tools/techniques-and-actions.md)           |
| [`flora_run_action`](https://docs.flora.ai/mcp/tools/techniques-and-actions.md#flora_run_action)                               | Run a prebuilt action headless on inputs you pass by URL or text. Nothing appears on the canvas.                                                                                        | writes, destructive, async               | [Technique and action tools](https://docs.flora.ai/mcp/tools/techniques-and-actions.md)           |
| [`flora_add_action`](https://docs.flora.ai/mcp/tools/techniques-and-actions.md#flora_add_action)                               | Place a prebuilt action node on a canvas. It runs nothing until [`flora_run_canvas_action`](https://docs.flora.ai/mcp/tools/techniques-and-actions.md#flora_run_canvas_action) runs it. | writes                                   | [Technique and action tools](https://docs.flora.ai/mcp/tools/techniques-and-actions.md)           |
| [`flora_open_action_studio`](https://docs.flora.ai/mcp/tools/techniques-and-actions.md#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.                                                     | read-only                                | [Technique and action tools](https://docs.flora.ai/mcp/tools/techniques-and-actions.md)           |
| [`flora_create_custom_action`](https://docs.flora.ai/mcp/tools/techniques-and-actions.md#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.                                                                 | writes                                   | [Technique and action tools](https://docs.flora.ai/mcp/tools/techniques-and-actions.md)           |
| [`flora_update_canvas_action`](https://docs.flora.ai/mcp/tools/techniques-and-actions.md#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.                                                               | writes, destructive                      | [Technique and action tools](https://docs.flora.ai/mcp/tools/techniques-and-actions.md)           |
| [`flora_open_canvas_action_studio`](https://docs.flora.ai/mcp/tools/techniques-and-actions.md#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.                                                            | read-only                                | [Technique and action tools](https://docs.flora.ai/mcp/tools/techniques-and-actions.md)           |
| [`flora_run_canvas_action`](https://docs.flora.ai/mcp/tools/techniques-and-actions.md#flora_run_canvas_action)                 | Run an action node that's already on a canvas, using the nodes wired into it as inputs.                                                                                                 | writes, destructive, async               | [Technique and action tools](https://docs.flora.ai/mcp/tools/techniques-and-actions.md)           |
| [`flora_create_asset`](https://docs.flora.ai/mcp/tools/assets.md#flora_create_asset)                                           | Bring files into a workspace from a public URL, or reserve a signed upload for a local file. Up to 25 per call.                                                                         | writes                                   | [Asset tools](https://docs.flora.ai/mcp/tools/assets.md)                                          |
| [`flora_complete_asset`](https://docs.flora.ai/mcp/tools/assets.md#flora_complete_asset)                                       | Finish a signed-url upload once the file's bytes are uploaded, or finish up to 25 at once.                                                                                              | writes                                   | [Asset tools](https://docs.flora.ai/mcp/tools/assets.md)                                          |
| [`flora_attach_asset`](https://docs.flora.ai/mcp/tools/assets.md#flora_attach_asset)                                           | Place an existing asset on a project canvas as a node.                                                                                                                                  | writes                                   | [Asset tools](https://docs.flora.ai/mcp/tools/assets.md)                                          |
| [`flora_get_asset`](https://docs.flora.ai/mcp/tools/assets.md#flora_get_asset)                                                 | Read one asset's metadata, or turn up to 100 asset IDs into URLs in one call.                                                                                                           | read-only                                | [Asset tools](https://docs.flora.ai/mcp/tools/assets.md)                                          |
| [`flora_list_assets`](https://docs.flora.ai/mcp/tools/assets.md#flora_list_assets)                                             | List the assets in a workspace or project, with an optional name filter.                                                                                                                | read-only                                | [Asset tools](https://docs.flora.ai/mcp/tools/assets.md)                                          |
| [`flora_list_models`](https://docs.flora.ai/mcp/tools/models-and-loras.md#flora_list_models)                                   | List the generation models this account can use, or read one model's full parameter list.                                                                                               | read-only                                | [Model and LoRA tools](https://docs.flora.ai/mcp/tools/models-and-loras.md)                       |
| [`flora_list_lora_trainers`](https://docs.flora.ai/mcp/tools/models-and-loras.md#flora_list_lora_trainers)                     | List LoRA trainer families with their training parameters, defaults, image limits and compatible models.                                                                                | read-only                                | [Model and LoRA tools](https://docs.flora.ai/mcp/tools/models-and-loras.md)                       |
| [`flora_train_lora`](https://docs.flora.ai/mcp/tools/models-and-loras.md#flora_train_lora)                                     | Train and save a LoRA style from your own images, the same way the FLORA web Train dialog does.                                                                                         | writes, destructive, spends money, async | [Model and LoRA tools](https://docs.flora.ai/mcp/tools/models-and-loras.md)                       |
| [`flora_get_lora`](https://docs.flora.ai/mcp/tools/models-and-loras.md#flora_get_lora)                                         | Check whether a saved LoRA style is ready, with its base model and trigger details.                                                                                                     | read-only                                | [Model and LoRA tools](https://docs.flora.ai/mcp/tools/models-and-loras.md)                       |
| [`flora_discover_skills`](https://docs.flora.ai/mcp/tools/skills-and-discovery.md#flora_discover_skills)                       | List FLORA's skills, or read one skill's instructions by name.                                                                                                                          | read-only                                | [Skill and discovery tools](https://docs.flora.ai/mcp/tools/skills-and-discovery.md)              |
| [`flora_list_tools`](https://docs.flora.ai/mcp/tools/skills-and-discovery.md#flora_list_tools)                                 | List the tools on this connection with a short purpose and safety hints for each.                                                                                                       | read-only                                | [Skill and discovery tools](https://docs.flora.ai/mcp/tools/skills-and-discovery.md)              |
| [`flora_create_skill`](https://docs.flora.ai/mcp/tools/skills-and-discovery.md#flora_create_skill)                             | Save a shared skill to a workspace so every agent there can load it with [`flora_discover_skills`](https://docs.flora.ai/mcp/tools/skills-and-discovery.md#flora_discover_skills).      | writes                                   | [Skill and discovery tools](https://docs.flora.ai/mcp/tools/skills-and-discovery.md)              |
| [`flora_get_usage`](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md#flora_get_usage)                             | Read a workspace's balance and spend, or an organization's spend, in US dollars.                                                                                                        | read-only                                | [Usage, sharing and comment tools](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md) |
| [`flora_share_project`](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md#flora_share_project)                     | Share a project by link with view or edit access, the way the canvas Share tab does, and return the link.                                                                               | writes, destructive                      | [Usage, sharing and comment tools](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md) |
| [`flora_get_project_sharing`](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md#flora_get_project_sharing)         | Read how a project is shared: link mode, the active link, owner and members.                                                                                                            | read-only                                | [Usage, sharing and comment tools](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md) |
| [`flora_update_project_sharing`](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md#flora_update_project_sharing)   | Change a project's link sharing: unshare it, limit it to view, open it for editing, or set or clear a passphrase.                                                                       | writes, destructive                      | [Usage, sharing and comment tools](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md) |
| [`flora_list_comment_threads`](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md#flora_list_comment_threads)       | List a project's comment threads, newest first, with each thread's status, pin position and a preview.                                                                                  | read-only                                | [Usage, sharing and comment tools](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md) |
| [`flora_get_comment_thread`](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md#flora_get_comment_thread)           | Read one comment thread with its live messages, oldest first.                                                                                                                           | read-only                                | [Usage, sharing and comment tools](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md) |
| [`flora_create_comment_thread`](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md#flora_create_comment_thread)     | Pin a new comment thread on a project canvas and post its first comment. Collaborators see it on the canvas.                                                                            | writes                                   | [Usage, sharing and comment tools](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md) |
| [`flora_reply_to_comment_thread`](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md#flora_reply_to_comment_thread) | Post a reply on an open comment thread.                                                                                                                                                 | writes                                   | [Usage, sharing and comment tools](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md) |
| [`flora_resolve_comment_thread`](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md#flora_resolve_comment_thread)   | Mark a comment thread resolved. Its comments are kept.                                                                                                                                  | writes                                   | [Usage, sharing and comment tools](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md) |
| [`flora_reopen_comment_thread`](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md#flora_reopen_comment_thread)     | Reopen a resolved comment thread so it accepts replies again.                                                                                                                           | writes                                   | [Usage, sharing and comment tools](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md) |
| [`flora_delete_comment`](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md#flora_delete_comment)                   | Permanently delete one comment from a thread.                                                                                                                                           | writes, destructive                      | [Usage, sharing and comment tools](https://docs.flora.ai/mcp/tools/usage-sharing-and-comments.md) |

## Rules every agent follows

{% hint style="warning" %}
**Cost rule.** Price first: call `flora_create_generations` with `quote: true` and show the user the cost in US dollars. Run the same request without `quote` only after they approve. On `insufficient_credits` or any `BILLING_*` error, stop and pass the message on. Don't retry. Check balance and spend with `flora_get_usage`. A failed run isn't charged; a retry is a new run and is billed again.
{% endhint %}

{% hint style="info" %}
**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`.
{% endhint %}

## Related

* [FLORA MCP recipes](https://docs.flora.ai/mcp/recipes.md): step-by-step jobs that combine these tools.
* [FLORA MCP cost, balance and limits](https://docs.flora.ai/mcp/cost-and-limits.md) and [FLORA MCP runs](https://docs.flora.ai/mcp/runs.md): the cost and polling rules in full.
* [Retired FLORA MCP tools](https://docs.flora.ai/mcp/retired-tools.md): older tool names and what replaced them.
* [FLORA MCP troubleshooting](https://docs.flora.ai/mcp/troubleshooting.md): errors and how to fix them.

## How this reference is made

A daily job reads the server's `tools/list`, adds the tools only some accounts get, and merges hand-written guidance (use when, cost, examples). Each tool's full server description is reproduced under **Full description from the server**, because that's the text your agent reads. To change the hand-written parts, edit `scripts/mcp_tools/overlay.json` in the docs repo. Edits made in GitBook are overwritten by the next sync.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flora.ai/mcp/tools.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
