Copilot Studio
A single entry point for working across the Copilot Studio agent and automation lifecycle.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@microsoft/copilot-studio-mcpclaude mcp add copilot-studio -- npx -y @microsoft/copilot-studio-mcp@1.0.2
{
"mcpServers": {
"copilot-studio": {
"command": "npx",
"args": [
"-y",
"@microsoft/copilot-studio-mcp@1.0.2"
]
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
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.
Frequently asked questions
What is Copilot Studio?
A single entry point for working across the Copilot Studio agent and automation lifecycle.
How do I install Copilot Studio?
It runs on your machine. In Claude Code: claude mcp add copilot-studio -- npx -y @microsoft/copilot-studio-mcp@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Copilot Studio need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Copilot Studio open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Copilot Studio?
It is published by microsoft. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.