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

Skill and discovery tools

Reference for the FLORA MCP tools that list and read skills, create workspace skills, and list the tools on your connection.

These FLORA MCP tools help an agent find out what it can do. Skills are step-by-step playbooks for common jobs, such as batch generation or building a deck, and flora_list_tools lists the tools on the current connection. See FLORA MCP skills and plugins for every skill and how to install them in your client.

Tool
What it does
Labels

List FLORA's skills, or read one skill's instructions by name.

read-only

List the tools on this connection with a short purpose and safety hints for each.

read-only

Save a shared skill to a workspace so every agent there can load it with flora_discover_skills.

writes

flora_discover_skills

List FLORA's skills, or read one skill's instructions by name.

Labels: read-only

Shown in clients as: Discover skills

Use when: Before a multi-step job such as a batch, a product-photo deck or a canvas iteration, or when a tool's description says to load a skill (for example flora-deck-editor or flora-action-studio).

Don't use when: You want the list of tools: use flora_list_tools. If a skill is missing, fetch https://raw.githubusercontent.com/florafauna-ai/flora-mcp-skills/main/skills/<name>/SKILL.md instead.

On signed-in connections where the skill API is live, this tool also lists your own skills and your workspace's shared skills, and takes scope (flora, user or workspace) and workspace_id.

Arguments

Argument
Type
Required
Notes

name

string, number or boolean

no

Omit to list skills. Otherwise, use the exact name from a discovery result.

skill

string, number or boolean

no

Alias for name.

skill_name

string, number or boolean

no

Alias for name.

query

string, number or boolean

no

Alias for name.

Returns: Without name: each skill's name and description. With name: the skill's name, description and full instruction content, plus references when it has any.

Cost: Free. This tool doesn't spend money.

Usually comes before: flora_create_generations

Example prompt: "Which FLORA skills can you use?"

Example call:

Full description from the server

flora_list_tools

List the tools on this connection with a short purpose and safety hints for each.

Labels: read-only

Shown in clients as: List tools

Use when: You need to know which FLORA tools this account and client can use, for example before telling the user a capability is missing.

Don't use when: You need a tool's calling details: the purposes are short previews, so read the tool's full description and schema from your client's tools/list.

Arguments

None. Call it with {}.

Returns: {guidance, tools}: each tool's name, title, a description_preview (up to 480 characters) and its annotations. App UI entry points aren't included.

Cost: Free. This tool doesn't spend money.

Usually comes before: flora_discover_skills

Example prompt: "Which FLORA tools can you use right now?"

Example call:

Full description from the server

flora_create_skill

Save a shared skill to a workspace so every agent there can load it with flora_discover_skills.

Labels: writes

Shown in clients as: Create skill

Availability: Only on signed-in connections, once the FLORA API serves skills. Creating a skill also needs the paid workspace-skills feature and write access to the workspace.

Use when: The user wants to turn a workflow into a reusable skill for their team.

Don't use when: The user wants a personal skill: the API can't write those. If the call is refused with 402 or 403, ask for access or use a workspace that has the workspace-skills feature.

Arguments

Argument
Type
Required
Notes

workspace_id

string

yes

Workspace (ws_…) from flora_list_workspaces or current_workspace_id to create the skill in.

name

string

yes

Display name; the API derives the unique slug from it.

description

string

yes

One-line summary shown in skill pickers.

content

string

yes

Skill body — the instruction text agents follow.

Returns: The new skill's slug, which flora_discover_skills reads it by.

Cost: Free. This tool doesn't spend money.

Usually comes after: flora_list_workspaces

Usually comes before: flora_discover_skills

Example prompt: "Save these steps as a skill called Weekly social posts in our FLORA workspace."

Example call:

Full description from the server

Last updated

Was this helpful?