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 Dynamics 365.
┌─────────────────────────────────────────────────────────────────────┐
│ HOW THE AGENT USES TOOLS │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ User: "Create a validation block for the Order entity" │
│ │ │
│ ▼ │
│ Agent plans: │
│ 1. list_projects → find the right project │
│ 2. get_project_details → confirm solution is unmanaged │
│ 3. metadata_get_entity_ → understand Order's attributes │
│ attributes │
│ 4. create_validation_ → create the Logic Block │
│ 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 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 | list_projects, get_project_details, create_project |
| Solution Tools | Dynamics 365 | list_all_solutions, list_managed_solutions, list_unmanaged_solutions, get_solution_details, publish_customizations |
| Logic Block Tools | FlowOn Logic | 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 | 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 | list_all_logic_recipes, list_logic_recipes_by_project, get_logic_recipe_details, list_logic_recipe_dependencies |
| Business Process Tools | FlowOn BPM | list_business_processes, get_business_process_active_version_details, get_business_process_draft_version_details |
| Metadata Tools | Dynamics 365 | 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 |