PowerPlatform MCP
The PowerPlatform MCP server provides intelligent, context-aware access to Microsoft PowerPlatform/Dataverse data models and records, enabling AI-assisted exploration, querying, and understanding of your environment.
Metadata Exploration:
Retrieve comprehensive entity metadata including structure, attributes, display names, schema names, and descriptions
Access detailed information about specific entity fields including data types, formats, requirements, and usage notes
Explore and visualize one-to-many and many-to-many relationships between entities
Retrieve definitions for global option sets used across your environment
Data Access:
Fetch individual records by entity name and GUID
Query multiple records using advanced OData filter expressions with support for filtering, sorting, and pagination
AI-Assisted Context:
ENTITY_OVERVIEW: Get comprehensive entity summaries with key attributes and relationship counts
ATTRIBUTE_DETAILS: Access formatted, detailed information about specific fields
QUERY_TEMPLATE: Generate OData query templates with example filters and common patterns
RELATIONSHIP_MAP: Visualize formatted relationship maps showing entity connections
Use Cases:
Build and validate OData queries for PowerPlatform data
Understand existing data models and entity relationships
Design new solutions with awareness of existing schema
Get AI-powered assistance with query construction, field investigation, and complex data modeling decisions
Generate documentation about your PowerPlatform environment
Provides GitHub Copilot access to PowerPlatform/Dataverse entities and records, supporting entity exploration, intelligent OData filtering, and AI-assisted query building through a Model Context Protocol server.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PowerPlatform MCPshow me the account entity overview"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PowerPlatform MCP / CLI
A Model Context Protocol (MCP) server and standalone CLI for querying PowerPlatform / Dataverse environments. Supports multiple environments, entity metadata, records, plugins, flows, solutions, workflows, business rules, security roles, and more.
Why MCP + CLI?
MCP integrates directly with AI clients (Claude, Cursor, GitHub Copilot) for interactive, conversational exploration of your environments.
CLI writes results to a file system cache instead of returning them inline. MCP tool responses are bound by the AI client's context window, which can truncate or degrade results when querying environments with hundreds of entities, flows, or plugin steps. The CLI avoids this limitation by persisting full results to disk, making them available for follow-up analysis without context pressure. Both interfaces share the same tools and capabilities.
Installation
Requires Node.js 22+ (< 25).
MCP Server
npm install -g powerplatform-mcp
# or
npx powerplatform-mcpCLI
npm install -g powerplatform-cli
# or
npx powerplatform-cliDocker
# MCP Server
docker pull ghcr.io/michsob/powerplatform-mcp
docker run --env-file .env ghcr.io/michsob/powerplatform-mcp
# CLI
docker pull ghcr.io/michsob/powerplatform-cli
docker run --env-file .env ghcr.io/michsob/powerplatform-cli entity-attributes accountConfiguration
The tool supports multiple environments. Define them via environment variables:
POWERPLATFORM_ENVIRONMENTS=DEV,UAT,PROD
# For each environment, set:
POWERPLATFORM_DEV_URL=https://dev-org.crm.dynamics.com
POWERPLATFORM_DEV_CLIENT_ID=your-client-id
POWERPLATFORM_DEV_CLIENT_SECRET=your-client-secret
POWERPLATFORM_DEV_TENANT_ID=your-tenant-id
POWERPLATFORM_UAT_URL=https://uat-org.crm.dynamics.com
POWERPLATFORM_UAT_CLIENT_ID=...
POWERPLATFORM_UAT_CLIENT_SECRET=...
POWERPLATFORM_UAT_TENANT_ID=...For local development, copy .env.example to .env and fill in your credentials.
MCP Server
The MCP server is designed for AI-powered clients (Claude, Cursor, GitHub Copilot).
Available MCP Tools (38)
All tools accept an optional environment parameter to target a specific environment (defaults to the first configured).
Entity
Tool | Description | Required Params |
| Get entity metadata |
|
| List all attributes/fields |
|
| Get a specific attribute |
|
| Get 1:N and N:N relationships |
|
Records
Tool | Description | Required Params | Optional |
| Get a record by ID |
| |
| OData query |
|
|
Plugins
Tool | Description | Required Params | Optional |
| List plugin assemblies |
| |
| Assembly with types, steps, images |
|
|
| Plugins executing on an entity |
|
|
| Plugin trace logs |
| |
| All SDK message processing steps |
|
Flows (Power Automate)
Tool | Description | Required Params | Optional |
| List cloud flows (smart filtering) |
| |
| Search workflows and flows |
| |
| Full definition or parsed summary |
|
|
| Flow run history |
|
|
| Run details with action-level errors |
| |
| Cancel a running/waiting run |
| |
| Retry a failed run |
| |
| Batch health scan (success rates) |
| |
| Lightweight flow inventory |
|
Solutions
Tool | Description | Required Params | Optional |
| List non-readonly publishers | ||
| List visible solutions | ||
| Get solution by unique name |
| |
| List components in a solution |
| |
| Export solution (base64) |
|
|
Workflows (Classic)
Tool | Description | Required Params | Optional |
| List classic workflows |
| |
| XAML definition or summary |
|
|
| Background, BPFs, actions, on-demand |
|
Business Rules
Tool | Description | Required Params | Optional |
| List business rules |
| |
| Business rule with XAML |
|
Option Sets
Tool | Description | Required Params |
| Get a global option set definition |
|
Configuration
Tool | Description | Optional |
| Connection references |
|
| Environment variable definitions + values |
|
Security Roles
Tool | Description | Required Params | Optional |
| List customizable security roles |
| |
| Privileges for a role |
|
|
Dependencies
Tool | Description | Required Params |
| Dependencies blocking deletion |
|
| Check if a component can be deleted |
|
Service Endpoints
Tool | Description | Optional |
| Service Bus, webhooks, Event Hub, Event Grid |
|
MCP Prompts
Prompt | Description | Required Args |
| Entity overview with key attributes and relationships |
|
| Detailed attribute info (type, format, requirements) |
|
| OData query template with example filters |
|
| Complete 1:N and N:N relationship map |
|
CLI
Same tools as the MCP server, but results are cached to the file system for full-fidelity output on large data sets.
Global Option
--env <name> — target environment (defaults to first configured).
Commands
Entity
entity-metadata <entityName>
entity-attributes <entityName>
entity-attribute <entityName> <attributeName>
entity-relationships <entityName>Records
record <entityNamePlural> <recordId>
query-records <entityNamePlural> <filter> [--max <n>]Plugins
plugin-assemblies [--include-managed] [--max <n>]
plugin-assembly <assemblyName>
entity-pipeline <entityName> [--message <msg>] [--include-disabled]Flows
flows [--active] [--name <contains>] [--max <n>]
flow-definition <flowId> [--summary]
search-workflows (interactive filters)Solutions
solutions
solution <uniqueName>
solution-components <uniqueName>Workflows
workflows [--active] [--max <n>]
workflow-definition <workflowId> [--summary]
ootb-workflows [--categories <0,1,2,3,4>]Business Rules
business-rules [--active] [--max <n>]
business-rule <workflowId>Option Sets
optionset <optionSetName>Dependencies
check-dependencies <componentId> <componentType>Configuration
connection-references [--managed-only] [--has-connection] [--no-connection] [--inactive] [--max-records <n>]
environment-variables [--managed-only] [--max-records <n>]Security Roles
security-roles [--solution <name>] [--include-system] [--include-privileges] [--max-records <n>]
security-role-privileges <roleId> [--entity <name>] [--access-right <type>]Service Endpoints
service-endpoints [--max <n>]Development
git clone https://github.com/michsob/powerplatform-mcp.git
cd powerplatform-mcp
npm install
cp .env.example .env # fill in credentials
npm run build
npm run inspector # test with MCP InspectorReleasing
To publish a new version:
Update
versioninpackage.jsonCommit the change to
mainCreate and push a version tag:
git tag v1.0.2 git push origin v1.0.2
GitHub Actions will automatically publish:
Package | npm | GitHub Packages | Docker (GHCR) |
MCP Server |
|
|
|
CLI |
|
|
|
npm publishing uses Trusted Publishing (OIDC) — no tokens or secrets needed. GitHub Packages and GHCR use the built-in GITHUB_TOKEN automatically.
License
MIT
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/michsob/powerplatform-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server