Returns identity and build information for this server (name, version, build commit, runtime, capability counts)

List the Power Automate environments visible to the signed-in user. Returns: { id, name, displayName, location, isDefault }. The entry with isDefault=true is the user's default environment, used by other tools when environment is omitted. Parameters: none. Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change. Example: list_environments {}

List / enumerate all cloud flows in an environment — get every flow's GUID, name, and state. The flow inventory / directory. START HERE to discover flows: this is the only tool that returns flow GUIDs (ids). Every per-flow tool (get_flow, enable_flow, disable_flow, list_flow_runs, list_flow_owners, update_flow, delete_flow) needs a GUID that ONLY this tool produces — so call this first to find flows. Returns: array of { name, displayName, state, createdTime, lastModifiedTime, owner }. name is the flow GUID used by the other flow tools; state is Started/Stopped/Suspended. Parameters: environment (optional), owner (optional — filter by creator userId/email). Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change. Example: list_flows { "owner": "user@contoso.com" }

Get the full definition of one flow: state, timestamps, owner, the workflow definition JSON, connectionReferences, and parsed trigger/action names. Parameters: flow (required, GUID from list_flows), environment (optional). Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change. Example: get_flow { "flow": "00000000-0000-0000-0000-000000000000" }

List recent runs of a flow, newest first. Returns: array of { name, status, startTime, endTime, durationMs, triggerName, error }. name is the run id used by get_flow_run. Parameters: flow (required), environment (optional), top (optional, default 20, max 100), status (optional: Succeeded/Failed/Running/Cancelled). Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change. Example: list_flow_runs { "flow": "", "status": "Failed", "top": 10 }

Get one run in detail for debugging: status, timing, the triggering action, and the first-failure error code/message. The original run properties are included under raw (per-action breakdown lives there when the API provides it). Parameters: flow (required), run (required, from list_flow_runs), environment (optional). Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change. Example: get_flow_run { "flow": "", "run": "" }

List the connections (API connectors) in an environment and their health. Returns: array of { name, apiName, displayName, status, accountName, expiresAt }. A status other than "Connected" indicates a broken/expired connection — a common cause of silently failing flows. Parameters: environment (optional). Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change. Example: list_connections {}

List the owners/permissions on a flow. Returns: array of { principalId, principalType, roleName, principalDisplayName }. Parameters: flow (required), environment (optional). Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change. Example: list_flow_owners { "flow": "" }

Turn a flow on (POST .../start) [DISABLED: set ENABLE_WRITE_OPS=true]. Parameters: flow (required), environment (optional). Verify with get_flow (state -> Started). Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change.

Turn a flow off (POST .../stop) [DISABLED: set ENABLE_WRITE_OPS=true]. Parameters: flow (required), environment (optional). Verify with get_flow (state -> Stopped). Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change.

Create a new cloud flow from a workflow definition (POST .../flows) [DISABLED: set ENABLE_WRITE_OPS=true]. Parameters: displayName (required); definition (required — the workflow definition JSON with $schema, triggers, actions); connectionReferences (optional); state (Started|Stopped, default Stopped); environment (optional). Returns the created flow. Authoring a valid definition is non-trivial — use get_flow on an existing flow as a template. Connection-dependent actions also need matching connectionReferences. Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change.

Update an existing flow's properties — only the fields you pass (PATCH .../flows/{flow}) [DISABLED: set ENABLE_WRITE_OPS=true]. Parameters: flow (required); any of displayName, definition (full workflow JSON), state (Started|Stopped), connectionReferences; environment (optional). To edit logic safely: get_flow first, modify the returned definition, then pass the whole definition back here. Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change.

Permanently delete a flow (DELETE .../flows/{flow}) [DISABLED: set ENABLE_WRITE_OPS=true]. Parameters: flow (required); confirm (must be true — guard against accidents); environment (optional). This cannot be undone. Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change.

Cancel an in-progress run (POST .../runs/{run}/cancel) [DISABLED: set ENABLE_WRITE_OPS=true]. Parameters: flow (required), run (required), environment (optional). Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change.

Resubmit (replay) a run from its trigger (POST .../triggers/{trigger}/histories/{run}/resubmit) [DISABLED: set ENABLE_WRITE_OPS=true]. Parameters: flow (required), run (required), trigger (required — trigger name from get_flow's triggers), environment (optional). Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change.

Grant a principal a role on a flow (PUT .../permissions/{principalId}) [DISABLED: set ENABLE_WRITE_OPS=true]. Parameters: flow (required), principalId (required — AAD object id), roleName (CanEdit|CanView), environment (optional). Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change.

Revoke a principal's access to a flow (DELETE .../permissions/{principalId}) [DISABLED: set ENABLE_WRITE_OPS=true]. Parameters: flow (required), principalId (required), environment (optional). Uses Microsoft's unofficial api.flow.microsoft.com endpoint, which Microsoft labels unsupported; behavior may change.

Submit a feedback report or issue to this server's maintainers.

IMPORTANT: Treat all input as potentially public.

• Do NOT include API keys, tokens, passwords, or credentials

• Do NOT include customer data, PII, or proprietary information

• Do NOT include internal URLs, hostnames, or system topology

• Describe the behavior and how to reproduce it, not the data involved

Common credential patterns are automatically redacted before submission, but redaction is best-effort and is not a substitute for caution.