PowerPlatform MCP / CLI

A Model Context Protocol (MCP) server and standalone CLI for querying and configuring PowerPlatform / Dataverse environments. Supports multiple environments, entity metadata, records, plugins, flows, solutions, workflows, business rules, security roles, custom APIs, web resources, and more — including write operations for automated environment setup.

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-mcp

CLI

npm install -g powerplatform-cli
# or
npx powerplatform-cli

Docker

# 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 account

Configuration

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 (67)

All tools accept an optional environment parameter to target a specific environment (defaults to the first configured).

Entity

Tool	Description	Required Params	Optional
get-entity-metadata	Get entity metadata	entityName
get-entity-attributes	List all attributes/fields	entityName
get-entity-attribute	Get a specific attribute	entityName, attributeName
get-entity-relationships	Get 1:N and N:N relationships	entityName
create-entity-string-attribute	Create a Single Line of Text column	entityName, schemaName, displayName	maxLength, requiredLevel, description, solutionName
get-entity-keys	List alternate keys on an entity	entityName
create-entity-alternate-key	Create an alternate key	entityName, schemaName, displayName, keyAttributes	solutionName

Records

Tool	Description	Required Params	Optional
get-record	Get a record by ID	entityNamePlural, recordId
query-records	OData query	entityNamePlural, filter	maxRecords (default 50)

Plugins

Tool	Description	Required Params	Optional
get-plugin-assemblies	List plugin assemblies		includeManaged, maxRecords
get-plugin-assembly-complete	Assembly with types, steps, images	assemblyName	includeDisabled
get-entity-plugin-pipeline	Plugins executing on an entity	entityName	messageFilter, includeDisabled
get-plugin-trace-logs	Plugin trace logs		entityName, `messageName

... View full README on GitHub