World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Inspect, operate, and author Microsoft Power Automate cloud flows from an agent context.
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 6/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 18/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install Power Automate MCP Server. Follow https://mcp.popnx.com/i/sapientsai-power-automate-mcp-server.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Power Automate MCP Server for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "power-automate": { "command": "npx", "args": [ "-y", "power-automate-mcp-server" ], "env": { "AZURE_CLIENT_ID": "your-value", "AZURE_TENANT_ID": "your-value", "AZURE_AUTH_MODE": "your-value", "AZURE_CLIENT_SECRET": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For AZURE_AUTH_MODE, AZURE_CLIENT_SECRET, AZURE_CLIENT_ID, AZURE_TENANT_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Power Automate MCP Server tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
AZURE_CLIENT_ID Application (client) ID of your Entra app registration (multi-tenant public client).AZURE_TENANT_ID Tenant GUID. Required for the Flow audience ('common' fails with AADSTS50059).Descriptions are as written by the maker.
SettingsDeveloperEdit Config
{
"mcpServers": {
"power-automate": {
"command": "npx",
"args": [
"-y",
"power-automate-mcp-server"
],
"env": {
"AZURE_CLIENT_ID": "your-value",
"AZURE_TENANT_ID": "your-value",
"AZURE_AUTH_MODE": "your-value",
"AZURE_CLIENT_SECRET": "your-value"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use Power Automate MCP Server and tell me what you can do for me, then show me one thing✓ If Claude says it is using Power Automate MCP Server or shows a Power Automate MCP Server tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
FLOW_SCOPES Comma-separated OAuth scopes (e.g. .../Flows.Read.All,.../Flows.Manage.All).ENABLE_WRITE_OPS Set to 'true' to enable mutating tools (default read-only).DEFAULT_ENVIRONMENT Environment id used when a tool omits 'environment'.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Power Automate MCP Server yet
Power Automate MCP Server runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Power Automate MCP Server
B · Others in Other that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
You need a Power Automate MCP Server key (create it on the maker’s site) · 2 setting(s) to fill in (AZURE_CLIENT_ID, AZURE_TENANT_ID) · Install Node.js on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Power Automate MCP Server for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user power-automate --env AZURE_CLIENT_ID=your-value --env AZURE_TENANT_ID=your-value --env AZURE_AUTH_MODE=your-value --env AZURE_CLIENT_SECRET=your-value -- npx -y power-automate-mcp-server 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For AZURE_AUTH_MODE, AZURE_CLIENT_SECRET, AZURE_CLIENT_ID, AZURE_TENANT_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Power Automate MCP Server tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
AZURE_CLIENT_ID Application (client) ID of your Entra app registration (multi-tenant public client).AZURE_TENANT_ID Tenant GUID. Required for the Flow audience ('common' fails with AADSTS50059).Descriptions are as written by the maker.
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user power-automate --env AZURE_CLIENT_ID=your-value --env AZURE_TENANT_ID=your-value --env AZURE_AUTH_MODE=your-value --env AZURE_CLIENT_SECRET=your-value -- npx -y power-automate-mcp-serverReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see Power Automate MCP Server listed as connected
Use Power Automate MCP Server and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Power Automate MCP Server or shows a Power Automate MCP Server tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
FLOW_SCOPES Comma-separated OAuth scopes (e.g. .../Flows.Read.All,.../Flows.Manage.All).ENABLE_WRITE_OPS Set to 'true' to enable mutating tools (default read-only).DEFAULT_ENVIRONMENT Environment id used when a tool omits 'environment'.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a Power Automate MCP Server key (create it on the maker’s site) · 2 setting(s) to fill in (AZURE_CLIENT_ID, AZURE_TENANT_ID) · Install Node.js on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Power Automate MCP Server for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "power-automate": { "command": "npx", "args": [ "-y", "power-automate-mcp-server" ], "env": { "AZURE_CLIENT_ID": "your-value", "AZURE_TENANT_ID": "your-value", "AZURE_AUTH_MODE": "your-value", "AZURE_CLIENT_SECRET": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For AZURE_AUTH_MODE, AZURE_CLIENT_SECRET, AZURE_CLIENT_ID, AZURE_TENANT_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Power Automate MCP Server tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
AZURE_CLIENT_ID Application (client) ID of your Entra app registration (multi-tenant public client).AZURE_TENANT_ID Tenant GUID. Required for the Flow audience ('common' fails with AADSTS50059).Descriptions are as written by the maker.
In the Power Automate MCP Server settings, AZURE_AUTH_MODE, AZURE_CLIENT_SECRET, AZURE_CLIENT_ID, AZURE_TENANT_ID is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Power Automate MCP Server and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Power Automate MCP Server or shows a Power Automate MCP Server tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
FLOW_SCOPES Comma-separated OAuth scopes (e.g. .../Flows.Read.All,.../Flows.Manage.All).ENABLE_WRITE_OPS Set to 'true' to enable mutating tools (default read-only).DEFAULT_ENVIRONMENT Environment id used when a tool omits 'environment'.Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a Power Automate MCP Server key (create it on the maker’s site) · 2 setting(s) to fill in (AZURE_CLIENT_ID, AZURE_TENANT_ID) · Install Node.js on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Power Automate MCP Server for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "power-automate": { "type": "stdio", "command": "npx", "args": [ "-y", "power-automate-mcp-server" ], "env": { "AZURE_CLIENT_ID": "your-value", "AZURE_TENANT_ID": "your-value", "AZURE_AUTH_MODE": "your-value", "AZURE_CLIENT_SECRET": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For AZURE_AUTH_MODE, AZURE_CLIENT_SECRET, AZURE_CLIENT_ID, AZURE_TENANT_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Power Automate MCP Server tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
AZURE_CLIENT_ID Application (client) ID of your Entra app registration (multi-tenant public client).AZURE_TENANT_ID Tenant GUID. Required for the Flow audience ('common' fails with AADSTS50059).Descriptions are as written by the maker.
In the Power Automate MCP Server settings, AZURE_AUTH_MODE, AZURE_CLIENT_SECRET, AZURE_CLIENT_ID, AZURE_TENANT_ID is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Power Automate MCP Server and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Power Automate MCP Server or shows a Power Automate MCP Server tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
FLOW_SCOPES Comma-separated OAuth scopes (e.g. .../Flows.Read.All,.../Flows.Manage.All).ENABLE_WRITE_OPS Set to 'true' to enable mutating tools (default read-only).DEFAULT_ENVIRONMENT Environment id used when a tool omits 'environment'.Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add --scope user power-automate --env AZURE_CLIENT_ID=your-value --env AZURE_TENANT_ID=your-value --env AZURE_AUTH_MODE=your-value --env AZURE_CLIENT_SECRET=your-value -- npx -y power-automate-mcp-serverClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"power-automate": {
"command": "npx",
"args": [
"-y",
"power-automate-mcp-server"
],
"env": {
"AZURE_CLIENT_ID": "your-value",
"AZURE_TENANT_ID": "your-value",
"AZURE_AUTH_MODE": "your-value",
"AZURE_CLIENT_SECRET": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"power-automate": {
"command": "npx",
"args": [
"-y",
"power-automate-mcp-server"
],
"env": {
"AZURE_CLIENT_ID": "your-value",
"AZURE_TENANT_ID": "your-value",
"AZURE_AUTH_MODE": "your-value",
"AZURE_CLIENT_SECRET": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"power-automate": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"power-automate-mcp-server"
],
"env": {
"AZURE_CLIENT_ID": "your-value",
"AZURE_TENANT_ID": "your-value",
"AZURE_AUTH_MODE": "your-value",
"AZURE_CLIENT_SECRET": "your-value"
}
}
}
}AZURE_CLIENT_ID required envAZURE_TENANT_ID required envFLOW_SCOPES envAZURE_AUTH_MODE secret required envAZURE_CLIENT_SECRET secret required envENABLE_WRITE_OPS envDEFAULT_ENVIRONMENT envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
The registry name was verified with the GitHub account sapientsai, which owns the repo
Code last changed yesterday
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
No entries on OSV.dev for power-automate-mcp-server@0.2.4
Checks only this package version, not every dependency · checked Nov 15, 2026
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/sapientsai-power-automate-mcp-server)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: AZURE_AUTH_MODE, AZURE_CLIENT_SECRET
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed yesterday, and the latest version (0.2.4) reached the registry 5 months ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| This one Power Automate MCP Server | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | Yes | No | No | No | No | No |
| Add with + in Claude | No | No | No | No | No | No |
| Basic checks | 3/3 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| License | MIT | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
An MCP server that lets agents inspect, operate, and author Microsoft Power Automate cloud flows from a CLI/agent context — list and inspect flows, debug runs, check connections and owners, and (when explicitly enabled) enable/disable flows, cancel/resubmit runs, manage owners, and create/update/delete flows.
Primarily a management surface — the Power Automate portal's visual designer remains the better place to author complex flow logic — but create_flow/update_flow/delete_flow are also available (write-gated) for programmatic authoring. Built on SomaMCP (telemetry, health/info/ dashboard, error classification) over FastMCP.
⚠️ Unofficial API. v1 targets
api.flow.microsoft.com— the surface the Power Automate
portal itself uses. Microsoft labels it _"isn't supported. Customers should instead use the
Dataverse Web APIs."_ It is stable in practice and, unlike Dataverse, sees all flows
(including personal "My Flows") and works on M365‑seeded entitlements (no Premium license).
Every tool's description carries this disclaimer. A supported Dataverse backend is stubbed
for the future (see
src/backend/dataverse/README.md).
pnpm install
cp .env.example .env # set AZURE_CLIENT_ID (see "App registration" below) pnpm build pnpm dev:stdio # local agent over stdio (device-code sign-in to stderr)
On first use the server prints a device-code prompt to stderr; open https://microsoft.com/devicelogin, enter the code, and sign in. The token is cached (TOKEN_CACHE_PATH, mode 0600) and silently refreshed thereafter.
{
"mcpServers": { "power-automate": { "command": "npx", "args": ["-y", "power-automate-mcp-server", "--stdio"], "env": { "AZURE_CLIENT_ID": " " }, }, }, }
Developing on this repo? It ships a project-scoped .mcp.json (stdio, local dist/bin.js). After pnpm build, export AZURE_CLIENT_ID and open the repo in Claude Code — the power-automate server loads automatically (complete the device-code sign-in once; the cached token is then reused).
This server ships no default client id — you register your own (one‑time):
power-automate-mcp). Supported account types: multitenant (or single‑tenant if you'll only ever use one org).http://localhost (unused by device code, but required to register the platform). Set "Allow public client flows" = Yes.AZURE_CLIENT_ID.For unattended clientCredentials mode instead: add a client secret, grant application permissions with admin consent, and set AZURE_AUTH_MODE=clientCredentials, AZURE_TENANT_ID= , AZURE_CLIENT_SECRET=.... Note app‑only has limited Flow reach (it generally cannot see personal "My Flows").
Confirmed against a real tenant. Interactive Flow auth needs all four of these — each one, if missing, fails with a different cryptic AADSTS… (details in docs/api-notes.md):
AZURE_TENANT_ID= , not `common`. common + a resource scope → AADSTS50059 (and MSAL hides it as an empty device-code response).7df0a125-d3be-4c96-aa54-591f83ff541c). Missing → AADSTS650057..default validates the whole app and can fail with AADSTS650051. A _dedicated_ app may use .default. Pin via FLOW_SCOPES.isFallbackPublicClient=true). Off → token redemption fails with invalid_client.Verified FLOW_SCOPES: https://service.flow.microsoft.com/Flows.Read.All,https://service.flow.microsoft.com/Flows.Manage.All
azAPP=<your-app-client-id>; FLOW=7df0a125-d3be-4c96-aa54-591f83ff541c
az ad app permission add --id "$APP" --api "$FLOW" --api-permissions \ e45c5562-459d-4d1b-8148-83eb1b6dcf83=Scope 30b2d850-00c3-4802-b7ae-ece9af9de5c6=Scope az ad app permission admin-consent --id "$APP"
az ad app update --id "$APP" --set isFallbackPublicClient=true
Recommended: a dedicated public-client app with only the Flow delegated permissions
avoids the
.default/shared-app pitfalls (#3) entirely — cleaner than reusing a Graph app.
All tools are read‑only by default. Write tools are registered but refuse unless ENABLE_WRITE_OPS=true.
| Tool | Parameters | Returns |
|---|---|---|
list_environments | — | { id, name, displayName, location, isDefault }[] |
list_flows | environment?, owner? | { name, displayName, state, createdTime, lastModifiedTime, owner }[] |
get_flow | environment?, flow | full flow incl. definition, connectionReferences, trigger/action names |
list_flow_runs | environment?, flow, top? (≤100), status? | { name, status, startTime, endTime, durationMs, triggerName, error }[] |
get_flow_run | environment?, flow, run | run detail + first‑failure + raw properties (debugging) |
list_connections | environment? | { name, apiName, displayName, status, accountName, expiresAt }[] |
list_flow_owners | environment?, flow | { principalId, principalType, roleName, principalDisplayName }[] |
ENABLE_WRITE_OPS=true)| Tool | Parameters | |
|---|---|---|
create_flow | environment?, displayName, definition, connectionReferences?, state? | |
update_flow | environment?, flow, any of displayName / definition / state / connectionReferences | |
delete_flow | environment?, flow, confirm (must be true) | |
enable_flow / disable_flow | environment?, flow | |
cancel_flow_run | environment?, flow, run | |
resubmit_flow_run | environment?, flow, run, trigger | |
add_flow_owner | environment?, flow, principalId, roleName (CanEdit\ | CanView) |
remove_flow_owner | environment?, flow, principalId |
Authoring (`create_flow`/`update_flow`):
definitionis the raw Logic Apps-style
workflow JSON (see
get_flowoutput as a template). The visual designer is better for
complex logic; for edits,
get_flow→ modify thedefinition→ pass it back toupdate_flow.
When environment is omitted, tools use DEFAULT_ENVIRONMENT if set, else the discovered default environment (isDefault: true).
info MCP tool — server name, version, git SHA, capability counts.report_feedback — file API‑drift/bug reports as GitHub issues (FEEDBACK_GITHUB_REPO, GITHUB_TOKEN)./health, /health/detail, /info, /dashboard (the detailed ones are protected by MCP_API_KEY when set).See .env.example for the full list. Highlights: AZURE_CLIENT_ID (required), AZURE_TENANT_ID (common), AZURE_AUTH_MODE, TRANSPORT (stdio\|http), PORT, ENABLE_WRITE_OPS, DEFAULT_ENVIRONMENT, MCP_API_KEY, TELEMETRY, TOKEN_CACHE_PATH.
| Scenario | Transport | Auth | Notes |
|---|---|---|---|
| Local agent | stdio | device-code | Primary. Full reach. pnpm dev:stdio. |
| Docker, single operator | http | device-code + mounted token volume | Auth once via docker logs; persists. Full reach. docker compose up. |
| Docker, unattended | http | clientCredentials | No human, but no personal flows; verify it can mint a Flow token at all. |
[!WARNING]
The HTTP transport is single-operator. Every caller shares one Power Automate
identity: the server holds a single process-wide token (one device-code sign-in, or one
app identity), and
MCP_API_KEYis a shared static bearer that gates _access_, not
_identity_. Do not expose the HTTP endpoint to multiple users expecting per-user
separation — they would all see and mutate the same person's flows. For per-user
isolation, run stdio (one process per user, how Claude Desktop already runs it) or
wait for the v2 per-user OAuth path
(#9).
v2: per‑user browser OAuth over HTTP via FastMCP's
AzureProvider+ disk token cache
(the upstream token surfaces on the session). Reachable through SomaMCP's
backendOptions
passthrough without a fork — not wired in v1.
# Docker (single-operator device-code with a persisted token volume)
AZURE_CLIENT_ID=... docker compose up --build docker compose logs -f # grab the device code on first run curl -s http://localhost:3333/health
pnpm validate # format + lint + typecheck + test + build
pnpm run ci # validate's checks without fixing, as CI runs them (type run: pnpm ci is a clean install) pnpm test # vitest (unit) pnpm dev # http transport, watch pnpm