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.
How the Agent Uses Toolsplan → execute → verify → continue
User instruction
"Create a validation block for the Order entity"
Agent plans a sequence of tool calls
1
list_projects→find the right project
2
get_project_details→confirm solution is unmanaged
3
metadata_get_entity_attributes→understand the entity attributes
4
create_validation_logic_block→create the Logic Block
Each tool call returns a structured result - the agent reads it, verifies success, and continues.
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 MCP Server for Dataverse exposes 101 tools across 13 tool groups. Tools are registered conditionally based on which Flowon products are installed in the connected environment.
| Tool Group | Required Product | Tools |
|---|---|---|
| Project Tools | Logic Composer | list_projects, get_project_details, create_project |
| Solution Tools | Dataverse | list_all_solutions, list_managed_solutions, list_unmanaged_solutions, get_solution_details, publich_customizations |
| Data Tools | Dataverse | lookup_entity_record_by_displayname, list_entity_records |
| 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 |
| Logic Block Tools | Logic Composer | list_all_logic_blocks, list_logic_blocks_by_project_name, list_logic_blocks_by_project_id, get_logic_block_details_by_name, get_logic_block_details_by_id, create_formula_logic_block, get_formula_logic_block_preview_url, create_decision_table_logic_block, get_decision_table_logic_block_preview_url, create_decision_tree_logic_block, get_decision_tree_logic_block_preview_url, create_validation_logic_block, get_validation_logic_block_preview_url, create_validation_set_logic_block, get_validation_set_logic_block_preview_url, update_logic_block_metadata, list_logic_block_dependencies |
| Logic Flow Tools | Logic Composer | list_all_logic_flows, list_logic_flows_by_project_name, list_logic_flows_by_project_id, get_logic_flow_details_by_name, get_logic_flow_details_by_id, get_logic_flow_preview_url, create_logic_flow, update_logic_flow_metadata, list_logic_flow_dependencies |
| Logic Recipe Tools | Logic Composer | list_all_logic_recipes, list_logic_recipes_by_project (by name), list_logic_recipes_by_project (by ID), get_logic_recipe_details, create_logic_recipe, update_logic_recipe_metadata, get_logic_recipe_preview_url, list_logic_recipe_dependencies |
| Business Process Tools | Process Orchestrator | create_business_process, list_business_processes, list_business_process_versions, get_business_process_active_version_details, get_business_process_draft_version_details, update_business_process_draft_version, publish_business_process_draft_version, activate_business_process_version |
| Configuration Tools | Logic Composer | list_all_configurations, list_configurations_by_project_name, list_configurations_by_project_id, get_configuration_details_by_name, get_configuration_details_by_id, get_configuration_preview_url, create_configuration, update_configuration_value |
| Localized Resource Tools | Logic Composer | list_all_localized_resources, list_localized_resources_by_project_name, list_localized_resources_by_project_id, get_localized_resource_details_by_name, get_localized_resources_details_by_id, get_localized_resource_preview_url, create_localized_resource, update_localized_resource_value |
| Service Connection Tools | Logic Composer | list_all_service_connections, list_service_connections_by_project_name, list_service_connections_by_project_id, get_service_connection_details_by_name, get_service_connection_details_by_id, get_service_connection_preview_url, create_service_connection, update_service_connection_configuration |
| Schedule Tools | Logic Composer | list_all_schedules, list_schedules_by_project_name, list_schedules_by_project_id, get_schedule_details_by_name, get_schedule_preview_url, create_schedule, update_schedule_value |
| Event Tools | Logic Composer | list_all_event_definitions, list_event_definitions_by_project_name, list_event_definitions_by_project_id, get_event_definition_details_by_name, get_event_definition_details_by_id, get_event_definition_preview_url, create_event_definition, update_event_definition_metadata, get_event_definition_handlers, create_event_handler, update_event_handler |