The IDMC Asset Documentation MCP server gives AI agents read-only access to IDMC asset metadata, so that they can generate accurate, up-to-date technical documentation without manual API exploration.
This MCP server enables AI agents to document mappings, mapping tasks, mapplets, taskflows, ingestion tasks, connections, runtime environments, and Secure Agents. AI agents can also trace dependencies between assets, review taskflow run statuses, and compare versions of source-controlled assets to document changes between releases. The idmc-document-project skill allows AI agents to document projects end-to-end.
Key capabilities
This MCP server offers the following key capabilities:
•Asset discovery. Finds projects, folders, mappings, mapping tasks, taskflows, and other assets in your organization by type or project location.
•Asset triage. Traces upstream and downstream dependencies of an asset before you modify or deprecate it.
•Mapping and transformation retrieval. Retrieves mapping and transformation details to generate natural language mapping descriptions.
•Task, taskflow, and mapplet details. Retrieves mapping task, mapplet, and linear taskflow configurations for documentation.
•Environment inventory. Lists connections, runtime environments, and Secure Agents to build an environment inventory.
•Review taskflow run status. Reviews taskflow run statuses for a time window or run status.
•Compare asset versions. Compares two source-controlled versions of an asset to document changes.
Use cases
Use this MCP server to address the following use cases:
•Mapping and taskflow documentation. Document every mapping and taskflow in a specific project.
•Mapping analysis. Document what a specific mapping does in natural language, including its transformations and parameters.
•Mapping and taskflow correlation. Inquire about which taskflows and mappings depend on a specific mapping task.
•Secure Agent and runtime environment review. List all runtime environments, including Secure Agents, in your organization.
•Failed taskflow review. Show failed taskflow runs that occurred within a specific time period.
•Compare mapping versions. Locate changes that occurred in a mapping between its last two commits.
Tools
The following tools are available on this MCP server:
idmc_agent_details_get
Returns the services and components of a Secure Agent by the agent ID.
idmc_agent_details_list
Returns details about every Secure Agent in the organization along with the services and components running on each. Use idmc_agent_details_get for a single agent.
idmc_agent_get_by_name
Returns the configuration details of a Secure Agent, including the agent ID, by name. Use the ID with idmc_agent_details_get.
idmc_agent_list
Returns a list of the names and IDs of every Secure Agent in the organization. Optionally, you can restrict to unassigned agents or include package and configuration details.
idmc_connection_get
Returns one connection's configuration by connection ID. If you only have the connection name, use idmc_connection_get_by_name instead.
idmc_connection_get_by_name
Returns one connection's configuration by connection name. If you already have the connection ID, use idmc_connection_get instead.
idmc_connection_list
Returns every connection defined in the organization. You can use this tool to build a connection inventory. To get the configuration for a single connection, use idmc_connection_get or idmc_connection_get_by_name.
idmc_connection_metadata
Returns the runtime attributes of a connection for its source or target side, including each attribute’s name, data type, default value, label, maximum length, possible values, and whether or not it's required.
idmc_connection_search
Returns the connections associated with a Secure Agent or runtime environment. Optionally filtered by connection UI type, such as Oracle or Salesforce.
idmc_connection_source_objects
Returns the objects reachable through a connection, such as tables, files, or entities, from either the source or target side.
idmc_ingestion_file_activity
Returns File Ingestion and Replication job activity log entries. You can use the entries to document the run history of a file ingestion task. Requires taskId, runId, or both. To get the task ID, use idmc_ingestion_list_file_tasks or idmc_objects_search.
idmc_ingestion_get_file_task
Returns configuration details for one File Ingestion and Replication task by ID, including source and target connections, file transfer parameters, and the assigned runtime environment. To get the task ID, use idmc_objects_search (asset type MI_TASK) or an activity log entry. This tool doesn't resolve mapping tasks.
idmc_ingestion_list_file_tasks
Returns every File Ingestion and Replication task in the organization. Set resolveLocation to true to include each task's project and folder path.
idmc_mapping_get_by_name
Returns one mapping's configuration, including its v2 ID, by name. Use the ID with idmc_mapping_get_details.
idmc_mapping_get_details
Returns a mapping's configuration by v2 mapping ID, including source and target objects and properties, transformations, functions and expressions, parameters and default values, pre/post SQL, run-time conditions, and dependent tasks, the input for a natural language mapping description. Use the v2 ID only. IDs returned by idmc_objects_search are rejected with a 403 error.
idmc_mapping_get_transformation_details
Returns details for each transformation for a mapping by mapping ID, for use in the body of generated documentation. Optionally filter to a single transformation type.
idmc_mapping_get_transformation_details_by_name
Returns additional transformation detail for a mapping identified by name, optionally limited to one transformation type.
idmc_mapplet_get
Returns one PowerCenter mapplet's definition by mapplet ID. If you only have the mapplet name, use idmc_mapplet_get_by_name instead.
idmc_mapplet_get_by_name
Returns one PowerCenter mapplet's definition by mapplet name. If you already have the mapplet ID, use idmc_mapplet_get instead.
idmc_mapplet_list
Returns every PowerCenter mapplet in the organization for building a mapplet inventory.
idmc_mtt_get
Returns a mapping task's configuration snapshot by v2 task ID, including parameters, runtime overrides, and schema mode, for use in generated documentation. The response also carries mappingId (v2 id of the underlying mapping, for idmc_mapping_get_details) and frsGuid (global id, for idmc_objects_dependencies). Get task IDs from idmc_task_list_by_type with type MTT.
idmc_mtt_get_by_name
Returns one mapping task's configuration, including its ID, by name. Use the ID with idmc_mtt_get.
idmc_objects_dependencies
Returns the direct upstream (uses) or downstream (usedBy) references of an asset by global ID. Call repeatedly, using each returned asset's global ID as the next request's ID, to walk multiple layers of a dependency graph, the API itself returns only one hop per call. Takes global IDs only from idmc_objects_search, or frsGuid from idmc_mtt_get. Project IDs aren't accepted.
idmc_objects_lookup
Resolves assets from their project path and type to their global IDs. Use the IDs with tools that take an asset ID.
idmc_objects_search
Searches the IDMC asset catalog for projects, folders, mappings, tasks, connections, and other assets using a FIQL filter. Returns global IDs using 22 characters. These work with idmc_objects_dependencies but not with the v2 tools (idmc_mtt_get, idmc_mapping_get_details, idmc_taskflow_get_linear), which need the v2 ID from idmc_task_list_by_type or from a tool that finds assets by name.
idmc_runtime_get
Returns one runtime environment's configuration and assigned agents by ID. If you only have the environment name, use idmc_runtime_get_by_name instead.
idmc_runtime_get_by_name
Returns one runtime environment's configuration and assigned agents by name. If you already have the environment ID, use idmc_runtime_get instead.
idmc_runtime_list
Returns every runtime environment in the organization for building an environment inventory. To get configuration and assigned agents for a single environment, use idmc_runtime_get.
idmc_source_control_commit_history
Returns the source-control commit history of an asset, newest first, with commit hashes. Use the hashes with idmc_source_control_compare_versions.
idmc_source_control_compare_versions
Compares two versions of a source-controlled asset and returns line-level differences for generating change documentation between releases. Set source and destination to a commit hash, or to CURRENT-VERSION for a version that hasn't been checked in. Set outputFormat to JSON for structured differences or TEXT for Git diff text.
idmc_task_list_by_type
Returns the name and v2 ID of every task of the given type for building a task inventory or resolving a task name to the v2 ID that idmc_mtt_get needs. Dynamic mapping tasks (DTT) and taskflows aren’t supported types. To find them, use idmc_objects_search.
idmc_taskflow_get_linear
Returns one linear taskflow's configuration by v2 taskflow ID. The tool returns workflow assets only. It doesn't return taskflow or process assets. Get IDs from idmc_taskflow_list_linear. If you only have the taskflow name, use idmc_taskflow_get_linear_by_name instead.
idmc_taskflow_get_linear_by_name
Returns one linear taskflow's configuration by taskflow name. The tool returns workflow assets only. It doesn't return taskflow or process assets. The response includes the v2 ID. If you already have the taskflow ID, use idmc_taskflow_get_linear instead.
idmc_taskflow_list_linear
Returns every linear taskflow in the organization. Use the returned IDs with idmc_taskflow_get_linear.
idmc_taskflow_status_list
Returns run statuses of published taskflows for monitoring, optionally filtered by run ID, run status, or a start/end time window. Omit all parameters to list recent taskflow runs. To get a list of taskflows, use idmc_objects_search with type=='TASKFLOW'.
Skills
The following skills are available on this MCP server:
idmc-document-project
Generates a Word, markdown, or HTML format document that describes an IDMC project. The document includes project metadata, an asset summary, mappings and their transformations, mapping tasks, mapplets, taskflows and processes, taskflow run statuses, ingestion tasks, connections, runtime environments, and Secure Agents. The skill uses the read-only tools on this server and doesn't change any assets.
To use the skill, complete the following actions:
1Connect your AI client to the IDMC Asset Documentation MCP server.
2Ask the AI agent to document a project. For example: "Document the Sales project." If you don't specify a project, the AI agent lists the projects in your organization so that you can choose one.
3Optionally, specify where to save the document. The AI agent collects the project details, writes the document, and shows a preview. You can ask the AI agent to summarize specific sections.