Tool Reference
What is an MCP Tool?
In the Model Context Protocol, a tool is a discrete, callable operation that the AI agent can invoke to interact with an external system. Think of tools as the verbs available to the agent — each one does exactly one thing, has a defined set of inputs, and returns a structured result.
When you give an AI agent a task in natural language, the agent does not execute it directly. Instead, it plans a sequence of tool calls and executes them one at a time, reading the result of each before deciding what to do next. Tools are the only mechanism through which the agent can read data from or write data to Flowon and Dataverse.
Tool Characteristics
Every Flowon MCP tool has the following characteristics:
| Characteristic | Description |
|---|---|
| Name | A unique identifier the agent uses to call the tool, e.g. list_projects |
| Description | A plain-language explanation of what the tool does and any restrictions. The agent reads this before every call. |
| Parameters | Typed, named inputs the agent must provide. Required parameters are enforced — the tool will not execute without them. |
| Return value | A structured result the agent can read and act on. Errors are returned as typed exceptions with clear messages. |
| Scope | Tools are only registered if the corresponding Flowon product is licensed in the connected environment. Calling an unregistered tool returns an error. |
Tool Groups
The Flowon AI MCP Server exposes 30+ tools across 7 tool groups. Tools are registered conditionally based on which Flowon products are installed in the connected environment.
| Tool Group | Required Product | Tools |
|---|---|---|
| Project Tools | Flowon Logic Composer | list_projects, get_project_details, create_project |
| Solution Tools | Dataverse | list_all_solutions, list_managed_solutions, list_unmanaged_solutions, get_solution_details, publish_customizations |
| Logic Block Tools | Flowon Logic Composer | list_all_logic_blocks, list_logic_blocks_by_project, get_logic_block_details, create_formula_logic_block, create_decision_table_logic_block, create_decision_tree_logic_block, create_validation_logic_block, create_validation_set_logic_block, update_logic_block_metadata, list_logic_block_dependencies |
| Logic Flow Tools | Flowon Logic Composer | list_all_logic_flows, list_logic_flows_by_project, get_logic_flow_details, create_logic_flow, update_logic_flow_metadata, list_logic_flow_dependencies |
| Logic Recipe Tools | Flowon Logic Composer | list_all_logic_recipes, list_logic_recipes_by_project, get_logic_recipe_details, list_logic_recipe_dependencies |
| Business Process Tools | Flowon Process Orchestrator | list_business_processes, get_business_process_active_version_details, get_business_process_draft_version_details |
| Metadata Tools | Dataverse | metadata_list_all_entities, metadata_list_all_global_optionsets, metadata_get_global_optionset_details, metadata_get_local_optionset_details, metadata_list_all_relationships, metadata_get_entity_attributes |