Copilot Studio

Copilot Studio MCP

Microsoft Copilot Studio MCP brings Copilot Studio tools into Model Context Protocol (MCP)-compatible CLIs, developer tools, and agentic interfaces. It provides a single entry point for working across the agent and automation lifecycle, from creation and configuration to testing, deployment, monitoring, and ongoing management.

This repository hosts the source for the MCP server. The server itself is published and installed from the npm package @microsoft/copilot-studio-mcp. It's also discoverable through the GitHub MCP Registry and the official MCP Registry.

Your client launches this package with npx. The server connects to Copilot Studio's hosted service after you sign in and select an environment, so access stays tied to your identity, environment permissions, and organizational policies.

Notice

If your organization requires Federal Risk and Authorization Management Program (FedRAMP) High compliance, the GitHub Copilot harness agent turns off at runtime to prevent data egress from the FedRAMP High compliance boundary.

Prerequisites

• Node.js 22.18 or later (Node.js 24 LTS recommended)
• A working MCP-compatible client: GitHub Copilot CLI, Visual Studio Code, or another MCP-compatible host
• A Microsoft work account with access to a Copilot Studio environment

Install

Configure your client to launch the package with:

npx -y @microsoft/copilot-studio-mcp@latest

The client starts the server process and communicates with it over standard input/output (stdio). The package handles the connection to the hosted Copilot Studio service; you don't enter a remote MCP URL or clone this source repository. You can also install the server directly from the GitHub MCP Registry or a supported client's MCP gallery (for example, VS Code's @mcp/"Browse MCP Servers" gallery) and follow the listing's installation option for your client.

Available tools

After you sign in and select an environment, the server makes the connected service's tools available. The service catalog includes the following tools. Connection and sign-in utilities are separate.

Tool	Description
discover_resources	Discover connector operations and schemas, existing connections, dependent parameter values, and attachable resources.
get_consumption	Read historical agent or workflow credit consumption, or current environment credit capacity.
manage_agents	Manage agent inventory, complete draft authoring, lifecycle, published-agent sharing, saved-draft previews, and agent evaluation suites and runs.
manage_workflows	Manage workflow inventory, complete draft authoring, lifecycle, real tests, and run diagnostics.
get_copilot_studio_skills	Start here for Copilot Studio guidance. Read the matching core skill before authoring, then read schema.json.

The management, discovery, and consumption tools expose individual operations through action and parameters. The current tool schemas identify the advertised actions and their inputs. To read the focused contract and side-effect information for an action before you construct unfamiliar arguments, use discover_resources with action=describe_actions.

Troubleshooting

If setup fails, stop and report the error without sharing credentials or configuration JSON. DNS, refused/reset connections, and network timeouts have distinct safe cause codes. Check endpoint availability and network/proxy settings before an explicit retry; another call does not repair missing environment routing.

See SUPPORT.md for how to get help with this project.

Security

See SECURITY.md for how to report security issues.

License

Licensed under the MIT License.