Enables AI agents to promote IDMC assets in the software development lifecycle, from development to production, automating multi-step promotion workflows and failure diagnostics.
This MCP server enables AI agents to promote IDMC assets across environments. Agents can discover catalog assets through FIQL queries, run export and import jobs, track job progress to completion, and inspect job logs for rapid failure triage. During promotion, the di-asset-zip-transfer companion script stages the export package in the target environment and generates a package transfer job ID that's used to start the import. This MCP server doesn't handle assets checked into source control systems, such as Git. The target organization must use the same version or a newer version of IDMC than the source organization. Versions might temporarily differ during an IDMC upgrade if the organizations are on different PODs.
Key capabilities
This MCP server offers the following key capabilities:
•Catalog search. Searches the catalog to locate projects, folders, and assets using FIQL filters.
•Export and import orchestration. Starts export and import jobs, and tracks status until the job completes.
•Job diagnostics. Retrieves plain-text export and import logs to analyze failures.
Use cases
Use this MCP server to address the following use cases:
•Environment promotion. Run export jobs, confirm that they succeed, and then start the corresponding import job on the target environment.
•Package staging and handoff. Download and stage export packages on the target environment before importing them.
•Failure triage. Inspect export and import logs to identify the asset or dependency that caused a failure.
Tools
The following table describes the tools available on this MCP server:
Tool
Description
search_assets
Searches the catalog using a FIQL query to locate projects, folders, or assets. Returns FRS IDs and paths for export or import.
rest_export_start
Starts an export job for one or more projects, folders, or assets by FRS ID optionally including dependencies. Returns an export job ID.
export_status
Retrieves the current status of an export job by job ID. Polls until SUCCESSFUL or FAILED, then stages the package or inspects the export log.
export_log
Retrieves the export job log after a FAILED status. Inspects system output, isolates missing dependencies, and identifies error codes.
rest_import_start
Starts an import job in the target environment, applying conflict resolution policies and optionally reusing target objects as dependencies. Returns an import job ID.
import_status
Retrieves the status of an import job and each asset's import outcome. Polls until SUCCESSFUL or FAILED. On FAILED, inspects the import log.
import_log
Retrieves the import job log after a failure. Analyzes the error stacks, bad dependency reuse, and permission failures in the target environment.
Note:
In AI Agent Engineering, the MCP server tools are called "actions."
Skills
Download the IDMC Asset Promotion skill file to use with this MCP server. The ZIP file includes the skill and the companion script.