Dynamics 365 MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ORG_URL | No | Organization 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_DOMAIN | No | On-premises AD/NTLM authentication: AD domain. | |
| AUTH_TYPE | No | Authentication type: 'online' (OAuth 2.0 client credentials, default), 'op_ad' (on-premises AD/NTLM), or 'op_ifd' (on-premises IFD/ADFS). | online |
| CACHE_TTL | No | Cache lifetime in seconds, a non-negative integer; 0 disables TTL-based expiration. | 7200 |
| CLIENT_ID | No | Online authentication: application client ID. | |
| TENANT_ID | No | Online authentication: tenant ID, domain, or a supported authority URL. | |
| AD_PASSWORD | No | On-premises AD/NTLM authentication: AD password. | |
| AD_USERNAME | No | On-premises AD/NTLM authentication: AD username. | |
| API_VERSION | No | Web API version, for example v9.1 or v9.2; no automatic version probing or switching. | v9.2 |
| IFD_ADFS_URL | No | On-premises IFD/ADFS authentication: ADFS server URL. | |
| IFD_PASSWORD | No | On-premises IFD/ADFS authentication: password. | |
| IFD_RESOURCE | No | On-premises IFD/ADFS authentication: optional resource; defaults to the organization URL. | |
| IFD_USERNAME | No | On-premises IFD/ADFS authentication: username. | |
| CLIENT_SECRET | No | Online authentication: application client secret. | |
| IFD_CLIENT_ID | No | On-premises IFD/ADFS authentication: ADFS client ID. | |
| AD_WORKSTATION | No | On-premises AD/NTLM authentication: optional AD workstation. | |
| IFD_TOKEN_PATH | No | On-premises IFD/ADFS authentication: optional token path; defaults to /adfs/oauth2/token. | |
| ENVIRONMENT_URL | No | Accepted as an alias for ORG_URL. If both are supplied, they must identify the same organization. | |
| D365_DOTNET_PATH | No | Optional path to the .NET executable, required for local DLL inspection, assembly updates, and the full test suite. | dotnet |
| MAX_READ_RETRIES | No | Maximum retries for transient GET failures, 0-5. | 2 |
| CACHE_TTL_SECONDS | No | Compatibility alias for CACHE_TTL; CACHE_TTL takes precedence when both are set. | |
| IFD_CLIENT_SECRET | No | On-premises IFD/ADFS authentication: optional client secret. | |
| MAX_RETRY_DELAY_MS | No | Maximum permitted retry wait, 0-300000 ms. | 30000 |
| REQUEST_TIMEOUT_MS | No | Per-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
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 167 tools
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.
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.
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.
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.