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.
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.
Arguments
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:
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:
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
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
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:
Last updated
Was this helpful?