Skip to content

feat: add power-automate-mcp skill#896

Merged
aaronpowell merged 2 commits intogithub:stagedfrom
ninihen1:add-power-automate-mcp
Mar 6, 2026
Merged

feat: add power-automate-mcp skill#896
aaronpowell merged 2 commits intogithub:stagedfrom
ninihen1:add-power-automate-mcp

Conversation

@ninihen1
Copy link
Contributor

@ninihen1 ninihen1 commented Mar 5, 2026

New Skill: power-automate-mcp

Connect to and operate Power Automate cloud flows via a FlowStudio MCP server.

What it does

Lets AI agents read, monitor, and operate Microsoft Power Automate cloud flows programmatically — no browser, no UI, no manual steps. Covers:

  • Listing flows and reading definitions
  • Checking run history and inspecting action outputs
  • Resubmitting/cancelling runs
  • Viewing connections and trigger URLs
  • Validating definitions and monitoring flow health
  • Power Platform environment discovery

Files

  • skills/power-automate-mcp/SKILL.md — Main skill file with frontmatter
  • skills/power-automate-mcp/references/tool-reference.md — Response shapes and behavioral notes
  • skills/power-automate-mcp/references/action-types.md — Power Automate action type reference
  • skills/power-automate-mcp/references/connection-references.md — Connection setup patterns
  • skills/power-automate-mcp/references/MCP-BOOTSTRAP.md — Bootstrap/quickstart guide

Checklist

  • npm run skill:validate passes
  • npm run build passes
  • Frontmatter includes name and description
  • Folder uses lowercase hyphen-separated naming
  • Dependency on FlowStudio MCP documented with link to https://mcp.flowstudio.app
  • Auth pattern uses x-api-key (not Bearer)
  • Demonstrates tools/list discovery step

Connect to and operate Power Automate cloud flows via a FlowStudio MCP server.
Includes tool reference, action types, connection references, and bootstrap guide.
@ninihen1 ninihen1 requested a review from aaronpowell as a code owner March 5, 2026 22:48
Copilot AI review requested due to automatic review settings March 5, 2026 22:48
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new power-automate-mcp skill that documents how to use the FlowStudio MCP server to discover, inspect, and operate Power Automate cloud flows programmatically.

Changes:

  • Introduces the main skill guide (SKILL.md) with end-to-end workflows and helper functions (Python/Node).
  • Adds reference documentation for tool response shapes, action types, connection references, and MCP bootstrap details.
  • Provides behavioral notes and “gotchas” intended to supplement tools/list.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
skills/power-automate-mcp/SKILL.md Main skill instructions, helpers, and workflows for using FlowStudio MCP with Power Automate.
skills/power-automate-mcp/references/MCP-BOOTSTRAP.md Quickstart for endpoint/auth/JSON-RPC usage and response parsing expectations.
skills/power-automate-mcp/references/tool-reference.md Catalog of response shapes and non-obvious behaviors per tool.
skills/power-automate-mcp/references/action-types.md Cheat sheet for interpreting Power Automate action types and expressions.
skills/power-automate-mcp/references/connection-references.md How to obtain and pass connectionReferences for connector-backed actions.

Copy link
Contributor

@aaronpowell aaronpowell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it would be a good idea to have Flow Studio as part of the name of this skill to ensure that people realise that this is for Power Automate with Flow Studio and not just Power Automate direction.

- Rename power-automate-mcp → flowstudio-power-automate-mcp
- Fix list_live_flows docs: returns wrapper object {mode, flows, totalCount, error}, not direct array
- Fix next() syntax: add parens for generator with default arg
- Add User-Agent header to tools/list discovery example
- Standardize User-Agent to FlowStudio-MCP/1.0 (required by Cloudflare)
- Add environmentName note for list_live_connections (required despite schema)
- Update list_live_flows response shape in tool-reference.md

All response shapes verified against live MCP server.
@ninihen1
Copy link
Contributor Author

ninihen1 commented Mar 6, 2026

Changes Addressing Review Feedback

Reviewer: @aaronpowell (Code Owner)

"have Flow Studio as part of the name"

Done — Renamed skill folder and frontmatter from power-automate-mcpflowstudio-power-automate-mcp.


Copilot AI Review — Verdict Table

All claims below were verified against the live FlowStudio MCP server (https://mcp.flowstudio.app/mcp) using real tools/call JSON-RPC requests.

# Copilot Comment Verdict Action Taken
1 list_live_flows returns a wrapper object, not a direct array Correct — server returns {mode, flows, totalCount, error} Fixed SKILL.md and tool-reference.md to document wrapper shape
2 next() missing parentheses (Python syntax) Correct — was next(...) without parens in one spot Fixed
3 Missing User-Agent header in examples Correct — Cloudflare returns 403/1010 without any User-Agent Added User-Agent: FlowStudio-MCP/1.0 to all examples
4 User-Agent value mismatch between examples Correct — different values were used Standardised to FlowStudio-MCP/1.0 everywhere
5 list_live_connections claims environmentName not needed but examples pass it Incorrect — JSON schema has required: [] (empty). The tool works with env param and the SKILL.md correctly documents typical usage patterns No change — documentation matches schema
6 update_live_flow required fields unclear ⚠️ Partially correct — schema requires only environmentName; description marked "Required" in tool description text is for create scenarios Clarified in tool-reference.md
7 environmentName availability claims in bootstrap ⚠️ Partially correct — environments are returned by list_live_environments but naming could be clearer Clarified wording in MCP-BOOTSTRAP.md
8 Table formatting issue Not reproducible — tables render correctly in GitHub markdown No change

All changes are in commit 0962c47.

@aaronpowell aaronpowell enabled auto-merge (squash) March 6, 2026 04:15
@aaronpowell aaronpowell merged commit f3142d7 into github:staged Mar 6, 2026
3 checks passed
ninihen1 added a commit to ninihen1/awesome-copilot that referenced this pull request Mar 6, 2026
…te-build skills

Two companion skills for the FlowStudio Power Automate MCP server:

- flowstudio-power-automate-debug: Debug workflow for failed Power Automate cloud flow runs
- flowstudio-power-automate-build: Build & deploy flows from natural language descriptions

Both require a FlowStudio MCP subscription: https://flowstudio.app
These complement the existing flowstudio-power-automate-mcp skill (merged in PR github#896).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants