Skip to main content
Glama
Dynamics 365 MCP Server

Dynamics 365 MCP Server

by Kenny-666

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ORG_URLNoOrganization root URL, such as https://your-org.crm.dynamics.com. Do not include /api/data/v9.2, credentials, a query string, or a fragment.
AD_DOMAINNoOn-premises AD/NTLM authentication: AD domain.
AUTH_TYPENoAuthentication type: 'online' (OAuth 2.0 client credentials, default), 'op_ad' (on-premises AD/NTLM), or 'op_ifd' (on-premises IFD/ADFS).online
CACHE_TTLNoCache lifetime in seconds, a non-negative integer; 0 disables TTL-based expiration.7200
CLIENT_IDNoOnline authentication: application client ID.
TENANT_IDNoOnline authentication: tenant ID, domain, or a supported authority URL.
AD_PASSWORDNoOn-premises AD/NTLM authentication: AD password.
AD_USERNAMENoOn-premises AD/NTLM authentication: AD username.
API_VERSIONNoWeb API version, for example v9.1 or v9.2; no automatic version probing or switching.v9.2
IFD_ADFS_URLNoOn-premises IFD/ADFS authentication: ADFS server URL.
IFD_PASSWORDNoOn-premises IFD/ADFS authentication: password.
IFD_RESOURCENoOn-premises IFD/ADFS authentication: optional resource; defaults to the organization URL.
IFD_USERNAMENoOn-premises IFD/ADFS authentication: username.
CLIENT_SECRETNoOnline authentication: application client secret.
IFD_CLIENT_IDNoOn-premises IFD/ADFS authentication: ADFS client ID.
AD_WORKSTATIONNoOn-premises AD/NTLM authentication: optional AD workstation.
IFD_TOKEN_PATHNoOn-premises IFD/ADFS authentication: optional token path; defaults to /adfs/oauth2/token.
ENVIRONMENT_URLNoAccepted as an alias for ORG_URL. If both are supplied, they must identify the same organization.
D365_DOTNET_PATHNoOptional path to the .NET executable, required for local DLL inspection, assembly updates, and the full test suite.dotnet
MAX_READ_RETRIESNoMaximum retries for transient GET failures, 0-5.2
CACHE_TTL_SECONDSNoCompatibility alias for CACHE_TTL; CACHE_TTL takes precedence when both are set.
IFD_CLIENT_SECRETNoOn-premises IFD/ADFS authentication: optional client secret.
MAX_RETRY_DELAY_MSNoMaximum permitted retry wait, 0-300000 ms.30000
REQUEST_TIMEOUT_MSNoPer-request HTTP timeout, 1-300000 ms.30000

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
stage_isolated_field_settingsC

Preview or apply selected field settings in an isolated organization using three-way review and native metadata validation.

prepare_field_settings_candidateC

Prepare explicitly selected field setting changes using reviewed baseline, source and target definitions. No writes.

stage_isolated_new_fieldB

Preview or create one explicitly specified new field in an isolated organization. Source metadata and solution membership are bound to the preview; no publication.

prepare_composite_form_candidateB

Combine multiple explicitly reviewed form changes into one local candidate. No CRM writes or packaging.

inspect_form_script_entryC

Inspect a unique script library or event handler entry from form XML.

prepare_form_script_entry_candidateC

Add or remove one reviewed script library or handler entry in a local candidate, preserving other entries.

publish_isolated_release_componentC

Preview or publish a reviewed JavaScript web resource or entire shared global choice in an isolated organization. Publication is not atomic.

publish_isolated_release_tableB

Preview or publish an entire table in an isolated organization after checking a reviewed saved form and solution membership. All pending customizations on the table may be published.

inspect_target_dependencyB

Read a table, field, global choice, JavaScript resource or main form from target and isolated organizations and compare bounded evidence. Does not establish full compatibility.

inspect_isolated_dependency_graphB

Read a bounded native required-dependency graph in a named isolated organization. Does not infer target compatibility or authorize release.

capture_model_baselineB

Read a field or global choice definition from a named environment and record its native metadata fingerprint with organization evidence. Publication state is not established.

capture_published_script_baselineB

Read a published UTF-8 JavaScript web resource from a named profile with organization evidence and content hash. No platform signature or lock is provided.

capture_published_form_baselineC

Read the published main form from a named environment and create a portable baseline with organization evidence. No platform signature or lock is provided.

stage_isolated_choice_candidateB

Preview or apply one selected global choice option change in an isolated organization with a reviewed baseline and membership. Native writes are not atomic; does not publish.

prepare_choice_candidateC

Prepare one local global Picklist option insertion or selected localized label changes using reviewed definitions. No writes.

stage_isolated_field_labelsB

Preview or merge selected localized field labels in an isolated organization after live metadata and membership checks. Uses an unprotected native PUT; does not publish.

prepare_field_label_candidateC

Build a local set of explicitly selected localized field label changes using reviewed baseline, source and target definition hashes. No writes.

add_isolated_release_choiceC

Preview or add a reviewed isolated component by its exact definition hash; source differences and dependencies require review.

add_isolated_release_fieldC

Preview or add a reviewed isolated component by its exact definition hash; source differences and dependencies require review.

add_isolated_release_webresourceB

Preview or add one reviewed JavaScript resource to a dedicated isolated solution after content and membership checks; native dependencies are not automatically added.

stage_isolated_webresource_candidateB

Preview or save a selected text candidate to an isolated organization using three live resource versions and optimistic concurrency; never publishes or adds solution members.

export_isolated_form_releaseC

Preview or export an isolated solution after checking organization identities, published content, dependency review and approved visible membership. Audit the saved package.

audit_form_release_packageA

Inspect an exported solution ZIP against an explicit component and content-hash manifest. Reports unexpected roots and unresolved evidence; does not establish release readiness.

review_release_dependenciesB

Classify caller-supplied direct dependency reports against selected components and claimed target evidence; does not establish compatibility or transitive closure.

apply_isolated_form_releaseB

Recompute the isolated form release preview and save only to the isolated organization with ETag protection. Requires preview hash and explicit isolation acknowledgment; no export or publication.

preview_isolated_form_releaseB

Read three distinct organizations, require an empty isolated solution and matching target form, review candidate scope and preview a concurrency-protected save. No writes, export, or publication.

inspect_form_candidate_scopeB

Compare complete caller-supplied candidate and target form definitions to explicit reviewed XML paths; flags all unselected observed changes. No write or deployment authorization.

inspect_form_rowC

Inspect an entire form row selected by section and cell IDs.

prepare_form_row_candidateC

Add or remove one reviewed row in a local candidate with baseline and target conflict checks.

inspect_form_nodeC

Read a unique form subtree and its review hash from caller-supplied XML.

prepare_form_node_candidateB

Construct a local candidate by replacing explicitly approved existing form subtrees with conflict checks; no writes or packaging.

prepare_component_candidateB

Construct a local text candidate from explicitly selected UTF-16 ranges in reviewed baseline and source; target must equal baseline. No write or packaging.

prepare_form_candidateB

Construct a local candidate from target XML using explicitly selected supported attributes and reviewed baseline/source/target hashes. Does not write or package.

capture_form_baselineC

Create a caller-supplied saved form baseline snapshot with an integrity hash. Does not verify provenance or publication.

verify_form_baselineA

Check a baseline snapshot against an independently retained hash. Does not authenticate provenance or publication.

review_component_three_wayA

Compare caller-supplied baseline, source and target text contents using whole-file hashes. Reports concurrent changes; does not merge, package or authorize release.

review_form_three_wayB

Compare caller-supplied baseline, source and target saved main-form definitions. Report positional change overlaps for review; does not merge or authorize release.

review_form_release_scopeA

Review a previously returned form package plan against explicitly selected XML paths and components. Local review only; does not authorize execution or establish a trusted baseline.

update_crm_user_profileA

Preview then update selected CRM user profile fields or enabled status with metadata-confirmed ETag and readback. Changing isdisabled requires explicit acknowledgement; roles, business unit, domain and passwords are excluded.

change_role_privilegeA

Preview then add or remove one native role privilege with an explicitly supported depth. Uses current CSDL, rereads the role privilege, requires both acknowledgements and does not infer effective access. Existing different depths must be removed separately.

manage_security_roleA

Preview then create, rename/update, or delete a customizable unmanaged security role in an explicit unmanaged solution. Update/delete require native optimistic concurrency and specific ETag; no privilege changes are performed.

list_role_privilegesA

Read bounded direct native privilege IDs and depth masks for a security role. Does not infer effective user or record access.

create_onprem_domain_userA

Preview then create a CRM on-premises AD/IFD domain user in a verified active business unit. No passwords or roles are set. Requires preview hash and explicit creation acknowledgement; unknown writes are never retried.

manage_user_rolesA

Preview then assign or remove up to 20 direct user security roles. Resolves native relationship and business units, requires unprotected-write acknowledgement, and verifies each membership after dispatch. No automatic retries; effective privileges are not inferred.

list_crm_chartsC

List bounded system saved/unpublished or personal charts for an entity.

get_crm_chartA

Read a system saved/unpublished or personal chart definition; does not establish runtime publication.

change_crm_chartA

Preview then create, update or delete system or personal charts. System charts require an unmanaged solution and separate table publication. Update/delete require native optimistic concurrency and a specific ETag. Execution requires expected_hash.

list_word_templatesA

List bounded CRM organization or personal Word templates without reading document content.

download_word_templateB

Download a CRM Word template after bounded DOCX ZIP checks; output_path is created exclusively, or Base64 is returned.

change_word_templateA

Preview then create, update or delete a CRM Word template. Create and update require a validated non-macro DOCX. Update/delete require native optimistic concurrency and ETag; execution requires expected_hash. No retry after unknown outcome.

list_note_attachmentsA

List visible CRM note attachments for a parent record without reading attachment content. A limited result is explicitly marked.

download_note_attachmentA

Read a CRM note attachment up to 5 MiB. Returns Base64 unless output_path is supplied; local files are created exclusively and never overwritten.

download_note_attachmentsA

Download 1–10 note attachments to distinct absolute local paths without overwriting existing files; reports completed items if the batch stops.

delete_note_attachmentsA

Preview then delete 1–10 attachments with native optimistic concurrency and individual ETags. Sequential non-atomic operation stops on failure; no automatic retry.

upload_note_attachmentsA

Preview then upload 1–10 CRM note attachments (5 MiB each, 20 MiB total). Uses validated relationship metadata and a current plan hash. Sequential non-atomic writes stop on failure or unknown outcome; no automatic retries.

backup_customizationA

Preview and persist a saved/unpublished Web Resource, main form or public view backup. Requires D365_JOURNAL_DIR. Does not publish.

restore_customization_backupC

Preview and restore an eligible saved customization backup with native ETag checks and readback; never publishes.

list_change_journalB

List recognized persistent journal entries for the active CRM identity and environment without returning original values.

get_change_journalB

Get a safe summary of one journal entry for the active identity and environment; does not return original values.

update_record_with_journalA

Preview and conditionally update simple record fields with a persistent before-image. Requires D365_JOURNAL_DIR and native optimistic concurrency.

rollback_record_journalA

Preview or conditionally restore a verified record-update journal entry; rejects changed records.

resolve_model_nameB

Resolve an exact logical, schema, collection or localized display name. Ambiguous names return candidates.

check_model_configurationB

Read-only checks for main forms, required fields and public view XML. Results depend on CRM permissions and cannot evaluate all runtime rules.

plan_sitemap_publicationC

Read-only combined SiteMap, direct AppModule associations, bounded required dependencies and individual publication previews. Partial reads are explicitly reported.

save_sitemap_with_journalA

Preview and conditionally save a SiteMap with a persistent before-image. Requires absolute D365_JOURNAL_DIR and specific CRM ETags. No publication.

rollback_sitemap_journalB

Preview or restore a verified SiteMap journal entry using its saved ETag. Does not publish.

publish_appmoduleA

Preview then submit native AppModule PublishXml. Requires expected_hash and allow_app_publish for execution. Acceptance does not verify runtime or dependent components.

inspect_sitemap_applicationsA

Read-only inspection of direct AppModule associations for a SiteMap. Does not establish full dependencies, publication or runtime state.

edit_sitemap_xmlA

Construct a candidate SiteMap XML locally with add_group, add_subarea, rename, set_localized_title and remove_subarea operations. Does not save or publish; use conditional record update and publish_sitemap separately.

publish_sitemapA

Publish previously saved SiteMap navigation XML separately from record editing. Default preview reads native RetrieveUnpublishedMultiple and the published record, returning a planHash. Execute with dry_run=false, expected_hash and allow_sitemap_scope_publish=true. Calls native PublishXml directly without CSDL, does not PATCH/save, verifies published XML after acceptance and preserves accepted/unknown evidence on failure. Legacy servers may ignore the ID and publish wider SiteMap scope. No PublishAllXml fallback; browser/app UI and app-module publication remain separate.

list_solutionsB

List native solution identity/state with optional exact unique-name/ID/managed filters. Bounded paging stays in the current query scope. Visible rows are not deployment validation.

list_solution_componentsA

List visible solutioncomponent membership rows for an exact solution; objectid/type, membership row ID and root inclusion behavior are separate. Optional filters combine with the solution. No code/XML/configuration is read; completeness does not prove export payload contents.

get_solution_component_dependenciesA

Invoke native RetrieveRequiredComponents, RetrieveDependentComponents or RetrieveDependenciesForDelete after current CSDL validation. Default direction required. Returns projected dependency edges and explicit bounded completeness. Does not compute transitive closure, authorize deletion or prove deployment readiness.

add_solution_componentA

Default preview of adding one existing component to a visible ordinary unmanaged solution. Validates the actual object/type, current CSDL and complete visible membership/required-dependency baseline. Types: 1 Entity, 2 Attribute, 9 global Option Set, 10 Entity Relationship, 14 Entity Key, 26 Saved Query, 60 System Form, 61 Web Resource, 90–93 plugin types/assemblies/steps/images. Attribute/Key requires logical_name. Fixed AddRequiredComponents=false/DoNotIncludeSubcomponents=true; implicit parent shells may still be added. Execute with planHash plus explicit unprotected Action; reread membership and report observed deltas without claiming export completeness.

inspect_solution_packageA

Inspect a local solution ZIP or base64 without CRM configuration. Bounds ZIP headers, paths, inflated sizes and every payload CRC; reads only solution.xml identity, publisher and declaration counts. No extraction/execution. Does not prove authenticity, safe code, dependencies, contents or deployability.

export_solutionA

Preview by default. Native ExportSolution from a visible ordinary unmanaged source; choose managed output explicitly. Current CSDL and caller/environment identity are validated. Execute with planHash; writes an exclusive new local .zip, verifies identity/hash, never returns base64 or overwrites files. No publish. On failure the reserved path can be empty/partial; no automatic replay.

import_solution_asyncA

Preview first import of an ordinary unmanaged ZIP into the configured environment. Execute with planHash and allow_unprotected_write=true. Same solution-name updates, managed/patch/upgrade imports are blocked. First import can change shared unmanaged components. Fixed overwrite overlay/workflow activation/dependency skip/holding/upgrade flags false; no environment overrides or separate publish. Submits once using ImportSolutionAsync; accepted is not completed. Unknown outcomes retain a client-assigned importJobId for manual status checks.

get_solution_import_statusA

Read native asyncoperation and/or importjob by explicit receipt IDs once, without polling or resubmission. Separates terminal async state, progress, unavailable/hidden/forbidden evidence and solution identity readback. Caller-supplied IDs are independent observations, not an independently verified relation. Progress=100/identity match is not deployment/runtime proof. No raw job/log/configuration text returned.

get_solution_snapshotB

Capture the configured environment and current-caller explicit visible membership with selected properties. Profiles: 1 table, 9 global Picklist, 10 relationship, 61 Web Resource, 91 non-package database assembly. Binary content is hashed, never returned/executed. Normalize labels/option values and retain IDs only as evidence. Unsupported/forbidden/partial/unstable inventory is explicit. No nested expansion, atomic snapshot, publication, full schema/dependency/runtime proof. Pass or save the returned snapshot JSON to compare separately configured environments.

compare_solution_snapshotsA

Compare two versioned snapshot objects locally without CRM settings. Verify canonical shape and integrity hashes; match portable names and selected properties/root scope, ignoring environment GUIDs and label transport fields. Report missing/extra/changed component references and property paths. Gaps/ambiguous keys/unknown scope make the comparison inconclusive, never a false pass. Option display order, unselected settings, full payload, managed layers, publication and runtime are outside this profile. Read-only; no authentication or environment switching.

verify_solution_deploymentA

Read-only selected-scope verification of the configured target against an expected snapshot. Returns a live snapshot comparison and, for explicit receipt IDs, independent native job/import-log evidence with text withheld. No full deployment/publication/runtime/causal package-job linkage is asserted, and job success never overwrites known component differences. Does not import, publish, repair, poll or replay.

get_solution_import_logA

Explicitly read a native solution importjob data XML by GUID and return bounded result summaries. <=2 MiB XML; no DTD/entities/namespaces or execution. Counts include manifest/section results, not unique components; failures/warnings prioritized. Raw XML is never returned. Error text is opt-in and bounded with best-effort credential redaction. Logs do not prove async completion or deployment; missing/forbidden/unsupported data is distinct from success. Uses importjobs, not record-data importlogs.

get_ribbon_definitionA

Read native effective classic entity Ribbon through current CSDL-validated RetrieveEntityRibbon, with typed enum/alias encoding. Validate/decompress the bounded ZIP RibbonXml.xml part without extraction/execution. Summarize buttons, commands, rule references and candidate insertion locations; full XML is opt-in. Does not evaluate user visibility/security, execute JavaScript, edit merged definitions or support modern commanding.

inspect_ribbon_solutionA

Inspect one entity classic RibbonDiffXml from a local solution ZIP without CRM configuration. Returns package identity and bounded button/command summaries, optional selected diff XML. Native merged definitions and solution diffs are different representations; a package is not target/runtime evidence.

edit_ribbon_solutionA

Preview by default; edit only one entity classic RibbonDiffXml in an ordinary unmanaged local ZIP. Add standalone custom JS buttons with publisher-scoped IDs, explicit current-table insertion location, ordered parameters, multilingual labels and packaged JS/raster icons; update labels/sequence; hide/unhide via a dedicated contradictory client display rule on an unshared custom command. Preserve other languages/rules/handlers, all other archive payloads and outside-Ribbon XML semantics. Execute with current planHash to write an exclusive NEW ZIP; never overwrite input, import, publish or run code. Built-in replacements, arbitrary rules, handler updates, modern commands and deployment remain separate workflows.

import_ribbon_solutionA

Preview first, then submit one native async import into an EXISTING ordinary unmanaged solution for reviewed classic Ribbon edits. Replay the structured edits and require exact candidate bytes; match organization/caller/table/publisher/version/complete visible membership and a fresh target export payload baseline. This is a WHOLE-SOLUTION import, including other unchanged components. Execute with current planHash, allow_unprotected_write and allow_full_solution_import. No upgrade/managed/override/automatic publish. Unknown acceptance retains client importJobId and is never replayed. Accepted responses yield a same-server-process provenance receipt for separate publication; receipt loss/restart is not permission to reimport.

publish_ribbon_solutionB

Separate preview/publish after a same-process authenticated import receipt, matching native succeeded import job and successful bounded manifest log. Check current target/exportable non-Ribbon baseline, CSDL and effective Ribbon before native PublishXml. Execute with planHash, allow_unprotected_write and allow_full_table_publish. Publishes the ENTIRE table, including unrelated pending fields/forms/views; pending contents are not locked/read completely. Referenced JS/images are NOT published by this request; use separate Web Resource publication. Compare changed button definitions after acceptance without running code or claiming UI/security/runtime success. Preserve published=true on readback failure; no reimport or automatic republish.

verify_ribbon_deploymentA

Read-only recovery/inspection: replay local source/changes, validate the candidate, resolve the current configured target and compare changed button attributes, command/action/parameter structure, labels and local display rules against native effective classic Ribbon. Missing/ambiguous/expanded evidence remains inconclusive or different. No receipt or reimport required; no publish/retry/repair, code execution or claim that the package was imported/published or the button works for a user.

get_api_operationA

Read current service CSDL to inspect Action/Function overloads, exact parameter types/facets, binding and import names. Optional entity-set binding narrows signatures. Returns direct input type definitions; nested types are not expanded. Read-only metadata does not prove permissions/runtime support.

call_d365_api_actionA

Invoke a current CSDL-defined Action/Function after typed validation. Preserves legacy defaults: Action POST and immediate execution, returning native data directly. Supports single-entity or collection binding, explicit overload IDs, primitive/enum/structural collections and safe Function parameter aliases. Optional dry_run previews without invocation and withholds parameter values by default. Optional expected_hash checks preview planHash; return_details=true returns receipt/data. No Action replay or generic business readback.

update_model_column_settingsA

Default preview of existing ordinary unmanaged custom column settings; nine supported base types. Allows length/range/precision expansion, requirement level, auditing/search managed values, Boolean/existing Picklist defaults and DateTime display format. Preserves full definition, labels, choices and date behavior. Rejects narrowing, primary/derived/calculated/rollup/autonumber columns and type/schema changes. Execute with preview planHash as expected_hash plus allow_unprotected_write=true; full native PUT then readback, no automatic publication.

update_model_relationshipA

Preview/update an existing unmanaged custom 1:N menu/cascade or N:N per-side menus by full native PUT with language merging. Preserves table/column/intersect identity and omitted settings. Menu must be confirmed customizable. Cascade changes can affect future related-record deletion, ownership and access; native cross-relationship rules remain platform-validated. Requires planHash and explicit unprotected write; saves and reads back separately from publication.

reactivate_model_keyA

Preview/submit the native ReactivateEntityKey Action only for an existing unmanaged Failed key index after its cause has been corrected. Uses actual key LogicalName, preserves key columns and never recreates/deletes the key. Requires planHash and explicit unprotected Action. Acceptance is separate from a new job link and Active state; performs one metadata readback, never polls/replays the submission. Inspect later with get_model_key.

d365_plugin_assembly_inspectA

Read actual DLL identity, target framework, public plugin contract types and reference metadata locally using a fixed .NET 10 metadata-reader process. No CRM settings required. Does not load/execute inspected code, verify its signature or resolve dependencies.

d365_plugin_assemblies_queryA

List native plugin assembly metadata with optional exact ID/name filters. Excludes content, credentials and configuration; bounded completeness is explicit. Does not invoke the .NET reader.

d365_plugin_assembly_updateA

Default preview only. Compare actual DLL against a stored unmanaged database assembly and preserve all existing plugin type IDs/names. Permit same major/minor non-decreasing build/revision, same identity/framework/references and AnyCPU signed managed DLL only. Managed, packaged, workflow, added/removed/unresolved types and dependency changes are blocked. Execute with preview fingerprint and metadata-gated concurrency; verify stored bytes, identity and type IDs after saving. .NET 10 Runtime required. Never creates assemblies or retargets steps.

d365_plugin_images_queryB

List native images for an exact step without reading plugin configuration. Bounded results report completeness; does not follow continuation links.

d365_plugin_image_registerA

Preview/register a native Pre/Post/Both image with explicit readable fields. Supports entity-specific Create, Update, Delete, Assign and SetState steps. Validates stage/message and overlapping aliases. Preview fingerprint required to write. No assembly upload or automatic publication.

d365_plugin_image_updateA

Preview/update an unmanaged customizable image. Omitted patch values are preserved. Checks fields, parent step and duplicate aliases, requires preview fingerprint and metadata-gated concurrency, then reads back saved fields.

d365_plugin_image_deleteA

Preview/delete an unmanaged customizable image by exact ID. Requires preview fingerprint, metadata-gated concurrency and a subsequent 404 to confirm deletion. Does not delete its parent step or retry a write.

list_model_ui_componentsA

List bounded native saved/unpublished system forms or views for one table. Returns IDs and types, with explicit list limits; no XML or automatic published-version fallback.

get_model_ui_componentB

Read a native unpublished system form/view definition, structural inventory, SHA-256 preview fingerprint and native ETag when available. Publication state is not inferred.

edit_model_formA

Structurally edit a Main form: append a scalar field using an explicit compatible existing control template, add a verified JavaScript library, or bind onload/onsave/onchange. No arbitrary XML, PCF/Lookup template copying or code execution. Default preview. Execute with current expected_hash; native ETag support is checked, otherwise explicit allow_unprotected_write is required. No automatic publication.

edit_model_viewA

Structurally edit a public system view: add/remove root display columns, set widths or replace simple root-field ordering. Preserves filters, joins and FetchXML attributes needed by other dependencies. Rejects aggregate/distinct query rewrites. Default preview, fingerprint and metadata-gated ETag/fallback checks, saved readback, no automatic publish.

apply_form_solution_packageC

Preview selected form and candidate components. Execution is disabled until unrelated changes can be isolated and release scope verified.

create_unmanaged_solutionB

Preview and create a dedicated unmanaged solution using an existing publisher, then read back its identity. Unknown outcomes are never retried.

inspect_form_solution_packageC

Inspect bounded local ZIP root declarations, selected form XML and Web resource payload hashes. Undeclared items may be nested; dependency completeness is not verified.

set_cloud_flow_stateA

Preview then enable or disable an Online cloud flow using specific native ETag and independent state readback. Does not establish connection, license or runtime readiness.

list_cloud_flow_connectionsB

List visible connection reference metadata without exposing connection IDs. Connection validity, permissions and licensing are not established.

update_cloud_flowA

Preview and replace a stopped Online cloud flow with a supported spec using a specific ETag, then verify its saved definition. Does not enable the flow.

create_cloud_flowA

Preview and create a stopped cloud flow in an existing unmanaged solution using a validated local flow spec. Requires preview hash; readback and solution membership are reported separately.

prepare_cloud_flowA

Construct a local manual, scheduled or Dataverse event cloud-flow draft with bounded literals, variables, condition and foreach. Does not contact Power Platform or validate deployment.

list_cloud_flow_runsB

Read bounded Dataverse run metadata for a cloud flow. Results may be delayed, unavailable or incomplete and do not establish full runtime history.

list_cloud_flowsB

Read a bounded list of visible cloud flow records in an Online Dataverse environment; no runtime or connection status asserted.

get_cloud_flowB

Read a cloud flow summary including trigger, action and connection-reference names and a definition hash; no secrets or full definition returned.

plan_form_solution_packageB

Read source and target main forms and preview adding the entire source form to an existing unmanaged solution. References are not automatically added or fully analyzed.

compare_environment_formsA

Read saved main forms from two explicitly named environment profiles and compare positional XML. No writes or publication verification.

get_model_choicesA

Read bounded native global or local Boolean/Picklist/MultiSelectPicklist options with multilingual labels and a fingerprint. Explicit global_choice_name OR a table/column pair. Reports shared global references without silently retargeting a later write.

create_model_choicesA

Create a global Picklist choice with an existing unmanaged solution and publisher prefix. Default preview. Omit option value to request native publisher-based allocation; supplied numeric values and label sets must be unique. Verifies saved labels and allocated values; no automatic publication.

change_model_choice_valueA

Insert a numeric choice option or update existing option labels/description through native InsertOptionValue/UpdateOptionValue (MergeLabels=true). Unmanaged choices only. Explicitly address a global choice to change shared values. Default preview; execution needs current expected_hash and allow_unprotected_write=true. No delete, renumber, state/status mutation or automatic publish.

publish_model_choicesA

Publish one entire shared global choice by native PublishXml; includes other pending changes to this global choice. Default preview. Local choices use the separate whole-table publish_model_table tool. Publication never replays a save and does not verify UI behavior.

get_model_relationshipB

Read a native relationship definition by schema name, cast to 1:N or N:N metadata. Does not infer publication or UI placement.

create_model_relationshipA

Create native 1:N (with a new Lookup) or N:N relationship. Default preview runs metadata reads and read-only POST eligibility checks, then exposes cascade rules and native create body. Checks publisher, managed properties and duplicate names. No implicit publish, form editing or update of existing relationships.

get_model_keyB

Read one native alternate-key definition and Pending/InProgress/Active/Failed index state. Optional linked job projection excludes free-text messages/data. A saved key is usable for alternate-key operations only after its native index is Active; no automatic reactivation.

create_model_keyA

Create a native alternate-key definition on 1–16 columns with solution/publisher, type, field-security and duplicate checks. Default preview; server validates index size and existing uniqueness asynchronously. Pending/unknown is not Active. No record scan, index reactivation, save replay or implicit publication.

get_model_definitionA

Retrieve a complete table or supported column definition and SHA-256 fingerprint using strong consistency. Supports nine basic/choice column types, including expanded choices. Publication state remains unknown; fingerprint is not a platform lock.

create_model_tableA

Create an ordinary custom table with a primary text name column using native EntityDefinitions. Requires an existing unmanaged solution and matching publisher prefixes. Default preview; does not place fields on forms or request publication.

create_model_columnA

Create native String, Memo, Integer, Decimal, Money, DateTime, Boolean, Picklist or MultiSelectPicklist column. Choice columns use local options or a validated global choice binding. Checks parent managed properties, publisher prefix and duplicate logical name. Default preview; save and publication remain separate.

update_model_labelsA

Update table/column labels by native full-definition PUT with MSCRM.MergeLabels=true. Preserves other retrieved properties, including choice definitions. Does not update option values: use change_model_choice_value. Execution requires current expected_hash and allow_unprotected_write=true; a concurrency race remains. Default preview.

publish_model_tableA

PublishXml for one entire table, including OTHER pending fields, forms, views and ribbon customizations. Default preview exposes scope; publication is separate from save. No automatic save replay on publication failure.

get_diagnostic_settingsA

Read current organization trace/audit switches and optional table audit metadata. Reports forbidden/unavailable/unknown evidence separately; current switches do not prove historical settings or deleted logs. Does not enable logging or auditing.

query_plugin_trace_logsA

Read bounded native plugin trace rows by time, correlation ID, step and exact plugin type. Default excludes message/exception text; configuration and secureconfiguration are always excluded. Empty results do not prove no execution, disabled logging or log deletion.

query_failed_system_jobsA

Read native failed system jobs (statuscode 31) using completion-time bounds and optional correlation/owning step IDs. Excludes job data/configuration and message text by default. Does not retry, cancel or change jobs.

diagnose_plugin_failureA

Build a read-only evidence report from exception-filtered traces, failed jobs and current plugin steps, anchored by correlation, step or plugin type. Uses native IDs for links, reports missing/forbidden/limited sources and keeps root cause undetermined. Current step state is not historical configuration.

query_security_principalsA

Read bounded visible users, teams or roles with optional ID/name/business-unit filters. Disabled users are included unless enabled is explicit. Catalog entries do not imply effective record permissions.

get_principal_security_contextA

Read a user/team profile, direct roles and bounded visible team memberships/roles. Preserves partial/forbidden sources and business-unit role identities. Does not reconstruct all inherited/group/shared/field privileges; use get_record_access for native record rights.

get_record_accessA

Use native bound RetrievePrincipalAccess for the specified principal and record. Returns effective record rights without inventing why they were granted or claiming field/business-rule access. Does not change permissions.

get_record_audit_historyA

Read one native RetrieveRecordChangeHistory page. Default withholds attribute values. Preserves MoreRecords/cookie and current audit-setting evidence; no actor/time/ID is invented if native AuditRecord is absent. Empty history does not prove logs were deleted or auditing was disabled.

get_audit_detailsB

Read native bound RetrieveAuditDetails and independent audit summary metadata. Attribute audit old/new values are opt-in and bounded; other detail types are named without fabricating unsupported fields. Detail and summary permissions are reported separately.

create_new_recordB

Create a native record. Accepts returned entity/ID headers or a supplied primary key, reports confirmed save separately from ID availability. dry_run previews without writing.

update_existing_recordA

Update a native record with row-version protection where supported. Defaults to a fresh ETag; unsupported concurrency stops writes unless unprotected operation is explicit. Does not upsert a missing GUID.

delete_record_by_idA

Delete a native record with validated GUID and concurrency conditions. dry_run identifies the target without deleting. A specific supplied ETag is never downgraded.

upsert_record_by_keyC

Use one active native alternate key with conditional PATCH. Validates key metadata/types and never silently changes key values. Races return errors; writes are never automatically repeated.

associate_recordsA

Associate records using a validated native navigation property. Single-valued lookup uses conditional PATCH; collection membership uses $ref and requires explicit allow_unprotected_write because parent ETags do not guarantee membership concurrency.

disassociate_recordsA

Remove a native association. A single lookup is cleared only if it currently points to the supplied target; collection membership uses DELETE on the specific $ref. No related record is deleted.

execute_record_batchA

Execute up to 100 validated record mutations in native $batch chunks. Each operation has its own change set, so a later failure does not roll back earlier operations. Preflights all operations before dispatch, reports per-item outcomes, stops after unknown results and respects request cancellation.

execute_record_transactionA

Execute up to 100 validated mutations in ONE native $batch change set, without chunking or fallback to individual writes. Reports committed false for confirmed rejection and unknown for transport/server ambiguity. Preflight reads are outside the transaction; arbitrary HTTP and Content-ID dependencies are not accepted.

search_web_resources_by_nameA

Find Web Resources by a substring of name, with bounded OData results. Defaults to published definitions; include_unpublished=true reads the latest saved definitions. Content is excluded by default. Supports the legacy camelCase parameters.

create_web_resource_and_publishA

Create a Web Resource without overwriting an existing saved name. Defaults to scoped PublishXml after saving. publish=false saves only; dry_run=true previews without writing. A publication error preserves saved=true and the created ID; recover with publish_web_resource.

update_web_resource_and_publishA

Update an existing Web Resource by GUID and optionally publish it. Uses If-Match:* to prevent accidental upsert; pass if_match for optimistic concurrency. dry_run reads the latest saved/unpublished definition and returns hashes and ETag. Does not rename or change the resource type.

publish_web_resourceA

Publish a single saved Web Resource with native PublishXml, without saving/re-uploading content. Use for save-only workflows or recovery after a publish failure. Publishes the latest saved version at execution time.

d365_plugin_registration_metadataA

Discover native plugin types, assemblies, SDK messages and message filters. Bounded read-only listings report limits; metadata does not prove write permission. Does not upload assemblies.

d365_plugin_steps_queryA

Query native plugin steps with exact filters. Secure Configuration is excluded by default; explicit include_secure_configuration=true is required to read plaintext. All supplied filters, including step_id, are combined. Results are bounded by top.

d365_plugin_step_registerA

Register a step for an existing native plugin type. Resolves message/entity filters, validates filtering fields and detects duplicate signatures. No write is automatically replayed. Optional secure configuration is allocated separately and bound in the step create; all phases report their IDs on failure. dry_run previews without writing.

d365_plugin_step_updateA

Update one plugin step. Omitted fields/configuration are kept; configuration supports keep/set/clear. Uses table concurrency metadata and a specific ETag by default. Secure set creates a replacement row and binds it in the same PATCH as step changes; clear unbinds. Existing configuration rows are retained, never blindly deleted. Write/readback failures preserve phase evidence.

get_environment_capabilitiesA

Read WhoAmI, RetrieveVersion and table definitions to inspect the configured CRM environment. Reports metadata evidence separately from untested permissions and SDK support; does not change the connection or select another API version.

get_entity_metadata_summaryA

Get a summary of entity metadata including primary key, name field, and business-relevant attributes. System-redundant fields are excluded.

get_field_picklist_optionsB

Get OptionSet (enum) definitions for a specific field within an entity. Supports both local and global OptionSets.

get_entity_navigation_linksB

Get navigation properties (relationships) for an entity, including 1:N, N:1, and N:N relationships.

preview_fetchxml_queryA

Preview the first result using the same FetchXML state/filter logic as query_by_fetchxml. Returns effective query and paging information without claiming the sample is a full result set.

query_by_fetchxmlB

Execute FetchXML with explicit state policy and bounded native cookie/simple paging. Defaults to one page. Returns value, effective query, completeness and continuation; use fetch_all for multiple pages.

clear_server_cacheA

Clear local cached metadata and authentication tokens and invalidate query continuations. Does not change CRM data.

get_current_user_contextC

Get information about the currently connected user and organization context.

list_all_entity_definitionsB

List basic definitions (logical name, display name, etc.) for all entities in the system.

search_records_by_odataB

Query records using OData with explicit state policy, stable ordering and bounded server-driven paging. Defaults to one page and legacy statecode=0 where valid; all adds no implicit state filter. Returns completeness and continuation.

get_record_by_idC

Retrieve detailed information for a single record by its GUID.

get_detailed_field_metadataB

Get full metadata details for a specific attribute (field) for deep analysis.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

C2.8/5.0

Scored across 167 tools

Disambiguation2/5

Large overlapping families make selection hard: prepare_form_candidate vs prepare_component_candidate vs prepare_form_node_candidate vs prepare_form_row_candidate vs prepare_composite_form_candidate, and capture_form_baseline vs capture_model_baseline vs capture_published_form_baseline vs capture_published_script_baseline all sound interchangeable without deep reading. Multiple publish paths (publish_sitemap, publish_appmodule, publish_model_table, publish_model_choices, publish_web_resource, publish_ribbon_solution, publish_isolated_release_component/table) and three record-write paths (update_existing_record, update_record_with_journal, upsert_record_by_key) require careful discrimination that descriptions only partly resolve.

Naming Consistency3/5

Casing is uniformly snake_case, which helps, but verb placement is mixed: most tools are verb_noun (create_model_column, get_model_key), while the plugin family inverts to noun_verb with a prefix (d365_plugin_assembly_inspect, d365_plugin_steps_query, d365_plugin_image_register, d365_plugin_step_update). A few tools also bundle a second action into the name (create_web_resource_and_publish, update_web_resource_and_publish), breaking the single-verb pattern.

Tool Count1/5

167 tools is an extreme mismatch for practical agent selection, spanning records, metadata, forms, solutions, ribbon, plugins, security, flows, audit, charts and templates. Even if the domain is genuinely broad, this volume guarantees tool-selection errors and makes the surface unmanageable without heavy external guidance.

Completeness4/5

Coverage of the Dynamics customization lifecycle is unusually thorough: metadata, forms/views, sitemap, solutions (export/import/verify), ribbon, plugin assemblies/steps/images, security, web resources, flows, notes, templates, records and audit/diagnostics all have supporting operations. Gaps exist on the destructive side of metadata (no delete_model_column, delete_model_table, or delete_model_relationship, and no web-resource delete), which agents would have to work around.

Maintenance

ActivityNo data
ResponsivenessOutdated data