Power Automate MCP Server by Flow Studio

Find the right tool instead of guessing its name. Returns full JSON schemas, ready to call. Query forms: (1) "skill:<name>" — a whole bundle; call list_skills for the names; (2) "select:name1,name2" — exact tools; (3) free text like "cancel run" — ranked against name and description. Non-billable.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query. Forms: \"select:name1,name2\", \"skill:<name>\", or free-text keywords."
    },
    "max_results": {
      "type": "integer",
      "description": "Max tools to return for keyword queries (default 5). Ignored for select: and skill: queries.",
      "default": 5
    }
  },
  "required": [
    "query"
  ]
}

List all skill bundles — named groups of tools the agent typically uses together for a single user intent (diagnose-connection-references, build-flow, debug-flow, monitor-flow, discover, governance). Returns each skill's description and member tool names. Call this first when you are unsure which tools apply to a request; then call tool_search with query: "skill:<name>" to load the full bundle. Non-billable.

{
  "type": "object",
  "properties": {}
}

Report a Flow Studio MCP bug or missing capability, append text evidence, or check your reports. Free and available even after quota is reached. Do not include passwords, access tokens, secrets, or full flow definitions unless necessary.

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "report",
        "append",
        "status",
        "list"
      ]
    },
    "summary": {
      "type": "string",
      "maxLength": 200
    },
    "details": {
      "type": "string",
      "maxLength": 100000
    },
    "ticket": {
      "type": "string"
    },
    "tool_name": {
      "type": "string"
    },
    "category": {
      "type": "string",
      "enum": [
        "wrong-result",
        "error",
        "missing-capability",
        "docs-or-hints",
        "performance",
        "other"
      ],
      "default": "other"
    },
    "severity": {
      "type": "string",
      "enum": [
        "blocker",
        "major",
        "minor"
      ],
      "default": "major"
    },
    "environment_name": {
      "type": "string"
    },
    "flow_name": {
      "type": "string"
    },
    "contact_email": {
      "type": "string"
    },
    "notify": {
      "type": "boolean",
      "default": true
    },
    "include_diagnostics": {
      "type": "boolean",
      "default": true
    },
    "content_type": {
      "type": "string",
      "description": "Media type of the attachment. text/plain (default), text/csv, text/markdown, application/json, application/har+json, application/xml, image/png, image/jpeg, image/gif, image/webp, application/pdf."
    },
    "file_name": {
      "type": "string"
    },
    "content": {
      "type": "string",
      "description": "Text attachment body. Max 64 KB per call."
    },
    "content_base64": {
      "type": "string",
      "description": "Binary attachment body, base64-encoded. Max 256 KB decoded per call. Use for images/PDF; pass text through `content` instead. Do not send both."
    },
    "chunk": {
      "type": "integer",
      "minimum": 0,
      "description": "Optional. Omit to append the next chunk automatically."
    },
    "final_chunk": {
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ]
}

[Requires Pro+ plan] List Power Automate flows from the Power Clarity cache. Optionally filter by governance flags (monitor, notification rules). Returns key fields including trigger URL, state, and run failure rate. Data is from the stored snapshot — not live from the Power Automate API.

{
  "type": "object",
  "properties": {
    "monitor": {
      "type": "boolean",
      "description": "If set, only return flows where monitor equals this value."
    },
    "rule_notify_onfail": {
      "type": "boolean",
      "description": "If set, filter flows by whether on-fail notifications are enabled."
    },
    "rule_notify_onmissingdays": {
      "type": "boolean",
      "description": "If set, filter flows by whether missing-days notifications are enabled."
    }
  }
}

[Requires Pro+ plan] Get full details for a single Power Automate flow from the Power Clarity cache. Includes trigger URL, owners, state, run statistics, and governance metadata. Data is from the stored snapshot — not live from the Power Automate API.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "flowName": {
      "type": "string",
      "description": "Name (ID) of the flow."
    }
  },
  "required": [
    "environmentName",
    "flowName"
  ]
}

[Requires Pro+ plan] Get cached run history for a flow from the Power Clarity store. Defaults to the last 7 days. Returns startTime, endTime, status, duration (seconds), failedActions, and remediation hint per run. Data is from the stored snapshot — not live from the Power Automate API.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "flowName": {
      "type": "string",
      "description": "Name (ID) of the flow."
    },
    "startTime": {
      "type": "string",
      "description": "ISO 8601 start of the time window (default: 7 days ago)."
    },
    "endTime": {
      "type": "string",
      "description": "ISO 8601 end of the time window."
    },
    "status": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Running",
          "Succeeded",
          "Failed",
          "Cancelled"
        ]
      },
      "description": "Filter by status. Only the first value is used in the OData filter."
    },
    "top": {
      "type": "number",
      "description": "Maximum number of run rows to return (default 5000)."
    }
  },
  "required": [
    "environmentName",
    "flowName"
  ]
}

[Requires Pro+ plan] Get aggregated run statistics for a flow from the Power Clarity cache: total runs, success count, failure count, success rate, fail rate, and average/max duration over a time window. Data is from the stored snapshot — not live from the Power Automate API.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "flowName": {
      "type": "string",
      "description": "Name (ID) of the flow."
    },
    "startTime": {
      "type": "string",
      "description": "ISO 8601 start of the time window (default: 7 days ago)."
    },
    "endTime": {
      "type": "string",
      "description": "ISO 8601 end of the time window."
    }
  },
  "required": [
    "environmentName",
    "flowName"
  ]
}

[Requires Pro+ plan] Update governance/metadata fields on a flow record in the Power Clarity store (description, business impact, owner team, tags, monitor flag, notification settings, etc.). Only fields provided are updated (merge semantics). Writes to the cache — does not call the Power Automate API.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "flowName": {
      "type": "string",
      "description": "Name (ID) of the flow."
    },
    "description": {
      "type": "string"
    },
    "businessImpact": {
      "type": "string"
    },
    "businessJustification": {
      "type": "string"
    },
    "businessValue": {
      "type": "string"
    },
    "ownerTeam": {
      "type": "string"
    },
    "ownerBusinessUnit": {
      "type": "string"
    },
    "supportGroup": {
      "type": "string"
    },
    "supportEmail": {
      "type": "string"
    },
    "critical": {
      "type": "boolean"
    },
    "monitor": {
      "type": "boolean",
      "description": "Enable/disable monitoring for this flow."
    },
    "rule_notify_onfail": {
      "type": "boolean",
      "description": "Send notification when the flow fails."
    },
    "rule_notify_onmissingdays": {
      "type": "number",
      "description": "Send notification when flow has not run for this many days (0 = disabled)."
    },
    "rule_notify_email": {
      "type": "string",
      "description": "Comma-separated email addresses for notifications."
    },
    "tags": {
      "type": "string"
    },
    "tier": {
      "type": "string"
    },
    "security": {
      "type": "string"
    }
  },
  "required": [
    "environmentName",
    "flowName"
  ]
}

[Requires Pro+ plan] List all Power Platform environments from the Power Clarity cache.

{
  "type": "object",
  "properties": {}
}

[Requires Pro+ plan] List all makers (citizen developers / AAD users) from the Power Clarity cache.

{
  "type": "object",
  "properties": {}
}

[Requires Pro+ plan] Get details for a single maker from the Power Clarity cache by their key (usually the AAD object ID). Includes flow/app counts and whether the account has been deleted.

{
  "type": "object",
  "properties": {
    "makerKey": {
      "type": "string",
      "description": "Maker RowKey (AAD object ID of the user)."
    }
  },
  "required": [
    "makerKey"
  ]
}

[Requires Pro+ plan] List all Power Apps canvas apps from the Power Clarity cache.

{
  "type": "object",
  "properties": {}
}

[Requires Pro+ plan] List all Power Platform connections from the Power Clarity cache.

{
  "type": "object",
  "properties": {}
}

Fetch run history for a flow directly from Power Automate. Returns { runs, runCount, triggerChecks }: each run has name, status, startTime, endTime, trigger name/code, and any top-level error. IMPORTANT — no runs does NOT mean the flow is healthy. A trigger that fires and evaluates to nothing, or fails to evaluate, records a TRIGGER CHECK and never becomes a run. When there are no runs (or when includeTriggerChecks is set) this tool also reports the trigger check history, so "nothing ran" can be told apart from "the trigger has been failing". Read triggerChecks.byStatus before concluding a flow is fine.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "flowName": {
      "type": "string",
      "description": "Name (ID) of the flow."
    },
    "top": {
      "type": "number",
      "description": "Max runs to return. Paginates automatically. Default 30."
    },
    "includeTriggerChecks": {
      "type": "boolean",
      "description": "Also report trigger check history when runs DO exist. Checks are always reported when there are no runs. Costs two extra API calls."
    }
  },
  "required": [
    "environmentName",
    "flowName"
  ]
}

Fetch error details for a specific flow run from the live Power Automate API. Lists every failed action with its error code and message to help diagnose what went wrong.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "flowName": {
      "type": "string",
      "description": "Name (ID) of the flow."
    },
    "runName": {
      "type": "string",
      "description": "Run identifier (name field from get_live_flow_runs)."
    },
    "top": {
      "type": "number",
      "description": "Max actions to return. Paginates automatically. Omit for all."
    }
  },
  "required": [
    "environmentName",
    "flowName",
    "runName"
  ]
}

Read the recorded inputs and outputs of actions in one flow run. Without actionName: the top-level actions (optionally filtered by name). With actionName: every execution of that action across foreach iterations, each with repetitionIndexes, status, error, and resolved inputs/outputs. Use iterationIndex to pin one iteration; omit it for all. TRIGGER PAYLOADS: set trigger=true with a runName to get that run's trigger inputs and outputs. No Compose workaround is needed. TRIGGER CHECKS: pass checkId (from get_live_flow_runs -> triggerChecks.recent[].checkId) to read a trigger evaluation that never became a run — that is how you see WHY a trigger is failing. Do not supply runName with a checkId.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "flowName": {
      "type": "string",
      "description": "Name (ID) of the flow."
    },
    "runName": {
      "type": "string",
      "description": "Run identifier (name field from get_live_flow_runs). Required unless checkId is given."
    },
    "trigger": {
      "type": "boolean",
      "description": "Return the RUN's trigger inputs/outputs instead of its actions. Requires runName."
    },
    "checkId": {
      "type": "string",
      "description": "Trigger check id (checkId from get_live_flow_runs -> triggerChecks). Returns that check's inputs/outputs, including the failure reason. Not a run id — the two are different, which is why a check id returns WorkflowRunNotFound from the run tools."
    },
    "actionName": {
      "type": "string",
      "description": "Action name. Without iterationIndex: returns all repetitions of this action across every foreach iteration. With iterationIndex: returns the single repetition matching that iteration. Omit entirely for top-level action list."
    },
    "iterationIndex": {
      "type": "number",
      "description": "Zero-based foreach iteration index. Matched against the innermost repetitionIndexes[].itemIndex in the PA repetition record. Only meaningful when actionName is also set."
    },
    "top": {
      "type": "number",
      "description": "Max actions or repetitions to return. Paginates automatically. Omit for all."
    }
  },
  "required": [
    "environmentName",
    "flowName"
  ]
}

Run a flow on demand — the same as the maker portal's "Run flow" button. Works with Request triggers (HTTP request, manual Button, PowerApps) and with scheduled RECURRENCE flows, which run immediately; a scheduled flow takes no inputs, so passing `body` to one is refused. Pass trigger inputs as `body`. Automated connector triggers only fire from their source event.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "flowName": {
      "type": "string",
      "description": "Name (ID) of the flow."
    },
    "body": {
      "type": "object",
      "description": "JSON body to POST to the trigger URL. Omit for flows that expect an empty body."
    },
    "connections": {
      "type": "object",
      "description": "Only for a flow whose connections are provided by whoever runs it. Map of connection-reference name to the connection id to run it with, e.g. {\"shared_office365users\":\"shared-office365user-…\"}. Omit unless the result told you the connection picked was wrong; ids come from list_live_connections."
    }
  },
  "required": [
    "environmentName",
    "flowName"
  ]
}

Cancel a currently running Power Automate flow run via the live PA API. Use after get_live_flow_runs to obtain the run name. Only runs with status "Running" can be cancelled.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "flowName": {
      "type": "string",
      "description": "Name (ID) of the flow."
    },
    "runName": {
      "type": "string",
      "description": "Run identifier (name field from get_live_flow_runs)."
    }
  },
  "required": [
    "environmentName",
    "flowName",
    "runName"
  ]
}

Resubmit a failed or cancelled Power Automate flow run via the live PA API, re-using the original trigger payload. Discovers the trigger name from the flow definition automatically — no trigger name parameter needed.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "flowName": {
      "type": "string",
      "description": "Name (ID) of the flow."
    },
    "runName": {
      "type": "string",
      "description": "Run identifier (name field from get_live_flow_runs)."
    }
  },
  "required": [
    "environmentName",
    "flowName",
    "runName"
  ]
}

Start or stop the flow you name. Reads the current state first and only calls Power Automate if a change is actually needed.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "flowName": {
      "type": "string",
      "description": "Name (ID) of the flow."
    },
    "state": {
      "type": "string",
      "enum": [
        "Started",
        "Stopped"
      ],
      "description": "Desired state for the flow."
    }
  },
  "required": [
    "environmentName",
    "flowName",
    "state"
  ]
}

Fetch the full native Power Automate flow JSON from the PA API, including the complete flow definition (triggers, actions, parameters, outputs). Returns the raw properties object exactly as the PA API returns it. Use this to inspect the full definition before calling update_live_flow with a modified definition.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "flowName": {
      "type": "string",
      "description": "Name (ID) of the flow."
    }
  },
  "required": [
    "environmentName",
    "flowName"
  ]
}

Update or create a flow. Use `dryRun: true` to preview any change without writing. Omit flowName to create: definition and displayName are required. Give flowName to update: displayName and/or definition and/or connectionReferences. SURGICAL EDIT: pass `operations` — an ordered list of set/add/remove/merge ops on array-of-keys paths — to change one action or parameter without resending the whole definition. Provide EITHER operations OR definition; connectionReferences may accompany either and lands in the same save. WHOLE definition: call get_live_flow, mutate properties.definition, pass it here. RENAME: pass displayName alone. Power Automate rejects a PATCH carrying no flow content, so this re-saves the unchanged definition — the maker portal does the same. definition.description is required, and must be brief — we append " #flowstudio-mcp" to it.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "flowName": {
      "type": "string",
      "description": "Name (ID) of the flow to update. Omit or leave blank to create a new flow."
    },
    "displayName": {
      "type": "string",
      "description": "Display name for the flow. Required when creating."
    },
    "definition": {
      "type": "object",
      "description": "Full flow definition as a JSON object (triggers + actions + parameters + outputs + description). MUST be a JSON object — strings are rejected. Do not JSON.stringify the definition; pass the parsed object directly. Required when creating. For updates, obtain from get_live_flow (properties.definition), modify it, then pass the modified object here. definition.description is required (a short note about what changed); when updating, if you omit it we reuse the flow's existing description."
    },
    "connectionReferences": {
      "type": "object",
      "description": "Connection references map copied from get_live_flow. Direct-flow entries use { connectionName, id }. Solution-aware entries also include { connectionReferenceLogicalName, source } and must retain those fields exactly. A freshly migrated entry may instead be keyed by the physical connection name and carry no connectionName field at all — copy it back as-is. The action/trigger inputs.host.connectionName must match the map key; the physical connectionName stays inside the entry. Never invent a solution logical name. Adding a connectionReferenceLogicalName to an entry that lacks one does not always take: the save can return success without storing it, so re-read with get_live_flow to confirm. MAY BE PASSED ALONGSIDE operations: your entries are merged over the stored map and saved in the SAME request as the edit. That is how you add the first action for a connector the flow does not use yet — a reference saved on its own does not stick, because Power Automate prunes an entry no action references. Your entries win on a key collision."
    },
    "operations": {
      "type": "array",
      "description": "SURGICAL EDIT of an existing flow (requires flowName; do not combine with definition). An ordered list applied to the LIVE definition. Each item = { op, path, value? }. path is an ARRAY of literal keys, e.g. [\"actions\",\"Send_Email\",\"inputs\",\"parameters\",\"subject\"] (each element is one key; a \"/\" inside an element is literal, so it addresses SharePoint/Dataverse columns like [\"actions\",\"Update_Item\",\"inputs\",\"parameters\",\"item/Title\"]). ops: set (create/overwrite), add (new key — errors if it already exists), remove (delete key — no-op if absent), merge (deep-merge an object value, keeping sibling keys).",
      "items": {
        "type": "object",
        "required": [
          "op",
          "path"
        ],
        "properties": {
          "op": {
            "type": "string",
            "enum": [
              "set",
              "add",
              "remove",
              "merge"
            ],
            "description": "Edit verb."
          },
          "path": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Array of literal keys, one per level, e.g. [\"actions\",\"Compose\",\"inputs\"]. A \"/\" inside an element is a literal character, so SharePoint/Dataverse column params (flat keys like \"item/Title\") are addressable: [\"actions\",\"Update_Item\",\"inputs\",\"parameters\",\"item/Title\"]. Do NOT pass a slash-delimited string — it cannot distinguish a literal \"/\" from a separator."
          },
          "value": {
            "description": "New value (required for set/add/merge; merge requires an object)."
          }
        }
      }
    },
    "dryRun": {
      "type": "boolean",
      "description": "Preview only, on BOTH paths: with flowName, apply the change to the live definition and return the result + what changed; without flowName, return the flow that WOULD be created. Nothing is written either way."
    }
  },
  "required": [
    "environmentName"
  ]
}

List all Power Platform environments you belong to, directly from Power Automate. Returns id, displayName, sku, location, and state for each environment. mode=all (default) and mode=member: every environment you are a member of. mode=admin: only those you administer; errors rather than guessing if admin access cannot be determined. isAdmin means you hold the ListAnyFlow permission there — the capability list_live_flows mode=admin needs. It is null, never false, when the platform did not tell us. isMember is true for every environment returned.

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "all",
        "member",
        "admin"
      ],
      "description": "all (default) and member: every environment you belong to. admin: only those where you hold ListAnyFlow; errors rather than returning a shorter list if admin access cannot be determined."
    },
    "top": {
      "type": "number",
      "description": "Max environments to return. Paginates automatically. Omit for all."
    }
  }
}

List Power Automate flows in an environment. Returns id, displayName, state, triggerType, and lastModifiedTime for each flow. mode=owner (default): flows you own plus flows shared with you (personal + team), with full definitions. mode=admin: all flows in the environment (requires an admin account). mode=admin with includeDeleted=true also returns soft-deleted flows (state=Deleted) — the only way to find a deleted flow. If search is provided, results are filtered to flows whose displayName contains the search text. For large environments pagination is time-bounded — if nextLink is returned, pass it as continuationUrl to retrieve the next batch.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "mode": {
      "type": "string",
      "enum": [
        "owner",
        "admin"
      ],
      "description": "owner (default): user-scoped — owned + shared-with-me flows (personal + team), with full definitions. admin: admin-scoped endpoint, all flows."
    },
    "includeDeleted": {
      "type": "boolean",
      "description": "Include soft-deleted flows, which come back with state=Deleted and can be restored with restore_live_flow. Requires mode=admin — the user-scoped listing never returns deleted flows. Off by default."
    },
    "top": {
      "type": "number",
      "description": "Max flows to return. Paginates automatically. Omit for all."
    },
    "search": {
      "type": "string",
      "description": "Optional case-insensitive filter applied to flow displayName."
    },
    "continuationUrl": {
      "type": "string",
      "description": "nextLink value returned by a previous call. Pass to resume pagination from where the last call stopped. Must match the same mode as the original call."
    },
    "timeoutSeconds": {
      "type": "number",
      "description": "Stop collecting pages after this many seconds and return a nextLink for the next batch. Default 25. Max 55."
    }
  },
  "required": [
    "environmentName"
  ]
}

List Power Platform connections in an environment directly from Power Automate. Returns id, displayName, connectorName, environment, createdBy (full object), authenticatedUser, statuses, overallStatus, createdTime, expirationTime, and connectionParameters for each connection. Pass search=<term> to narrow the list and receive a paste-ready connectionReferenceTemplate plus action-side hostTemplate per connection — drop these into update_live_flow's connectionReferences and inputs.host without further edits.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Required. Name of the Power Platform environment (a GUID, or a name like \"Default-<tid>\"). Call list_live_environments if you do not have one — the platform cannot list connections across environments."
    },
    "top": {
      "type": "number",
      "description": "Max connections to RETURN, applied after search. Paginates automatically. Omit for all."
    },
    "search": {
      "type": "string",
      "description": "Optional case-insensitive substring filter applied to id, displayName, connectorName, and accountName. Adds connectionReferenceTemplate + hostTemplate to each returned connection."
    }
  },
  "required": [
    "environmentName"
  ]
}

Describe a live Power Platform connector/API and its operations. Aligned with Canvas MCP describe_api. Use mode=summary (default) to get a compact operation catalog. Use operationId to describe one operation, including inputs, outputs, dynamic parameter metadata, nextTool hints to call resolve_live_parameters, and an authored hint + canonical example shape (when one exists) to copy into update_live_flow. Use search without connectorName/apiName to search operations across connectors and get connection-aware suggestions. Use mode=full only when raw OpenAPI connector metadata is required.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "connectorName": {
      "type": "string",
      "description": "Connector logical name, for example shared_teams. Either connectorName/apiName is required, unless search is provided for cross-connector operation search."
    },
    "apiName": {
      "type": "string",
      "description": "Alias for connectorName, matching Canvas MCP describe_api naming."
    },
    "mode": {
      "type": "string",
      "enum": [
        "summary",
        "full"
      ],
      "description": "summary (default): compact operation catalog. full: raw OpenAPI metadata."
    },
    "operationId": {
      "type": "string",
      "description": "Optional operation ID to describe with expanded inputs and outputs."
    },
    "type": {
      "type": "string",
      "enum": [
        "Action",
        "Trigger"
      ],
      "description": "Operation usage to include in summary mode. Default Action."
    },
    "search": {
      "type": "string",
      "description": "Optional operation search text. With connectorName, filters that connector summary. Without connectorName, searches operations across connectors."
    },
    "top": {
      "type": "number",
      "description": "Max operations to return in connector summary mode, or max top search results to show in cross-connector search. Default 250 for summary, 10 for search display."
    },
    "variant": {
      "type": "string",
      "description": "When an operation has multiple authored variants (e.g. shared_teams/PostMessageToConversation has channel/groupchat/flowbot_chat), pass a specific variantKey to get that variant's hint and exampleDefinition. Omit to receive a hint listing the available variants."
    }
  },
  "required": [
    "environmentName"
  ]
}

Move a flow into a solution. Refuses if the flow is already in one. solutionId is optional — omit for the default solution.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "flowName": {
      "type": "string",
      "description": "Name (ID) of the flow to migrate into the solution."
    },
    "solutionId": {
      "type": "string",
      "description": "Target solution ID (Dataverse solutionid GUID). Omit for the default solution. Discover IDs via resolve_live_parameters on shared_commondataserviceforapps/ListRecords with entityName \"solutions\" (value-path solutionid, value-title friendlyname); needs a Dataverse connection in the env."
    }
  },
  "required": [
    "environmentName",
    "flowName"
  ]
}

Resolve a connector operation's live input values: dropdown options, list and table columns, folder and file pickers — every input in one call, or one with parameterName. You do not need dynamicMetadata. Pass values you have in parameters; pass a display name in match to get back the value to write into the flow. An input whose parent is not known yet has status "needs". Inputs inside an object are addressed by key (body/recipient/groupId). Omit connectionName and one is chosen.

{
  "type": "object",
  "properties": {
    "environmentName": {
      "type": "string",
      "description": "Name of the Power Platform environment."
    },
    "connectorName": {
      "type": "string",
      "description": "Connector name, e.g. shared_sharepointonline."
    },
    "apiName": {
      "type": "string",
      "description": "Alias for connectorName."
    },
    "operationId": {
      "type": "string",
      "description": "Operation ID, e.g. PostItem. Not needed with flowName + actionName."
    },
    "parameterName": {
      "type": "string",
      "description": "Resolve only this input. Omit for every input."
    },
    "parameters": {
      "type": "object",
      "description": "Values already chosen, e.g. { \"dataset\": \"<site url>\" }."
    },
    "connectionName": {
      "type": "string",
      "description": "Connection to run as. Omit to have one chosen."
    },
    "flowName": {
      "type": "string",
      "description": "With actionName: take the connector, operation and connection from this flow action."
    },
    "actionName": {
      "type": "string",
      "description": "Action (or trigger) name in flowName."
    },
    "match": {
      "type": "object",
      "description": "Exact display name, or the value itself, per input, e.g. { \"folderPath\": \"Inbox\" }. Case-insensitive, never fuzzy. Folders also take /path. matchCount 0 answers status \"nomatch\"."
    },
    "browse": {
      "type": "object",
      "description": "Open a folder: { \"field\": \"<input>\", \"id\": \"<folder value>\" }."
    },
    "include": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "outputs"
        ]
      },
      "description": "Add \"outputs\" to get the fields this action returns."
    },
    "search": {
      "type": "string",
      "description": "Narrow long option or column lists by name (a filter, not a pick)."
    },
    "top": {
      "type": "number",
      "description": "Max options per dropdown (default 200). A longer list is marked truncated."
    },
    "detail": {
      "type": "string",
      "enum": [
        "compact",
        "full"
      ],
      "description": "Column detail. Default compact."
    },
    "dynamicMetadata": {
      "type": "object",
      "description": "Not needed for the operation's own inputs. For a lookup the connector does not define (e.g. Dataverse ListRecords over connectionreferences) send it and it is used as given."
    }
  },
  "required": [
    "environmentName"
  ]
}