The Secure Agent Management server lets AI agents observe and repair the Secure Agent groups that power IDMC workloads.
This MCP server provides AI agents with operational visibility and control over Secure Agents and the runtime environments that group Secure Agents. Use this MCP server to perform the following actions:
•Inspect agents and runtime environments.
•Read service property configurations.
•Enable or disable services and connectors on a Secure Agent group.
•Start or stop individual Secure Agent services on demand.
Key capabilities
This MCP server offers the following key capabilities:
•Agent inspection. Lists Secure Agents and reports per-agent and organization-wide service status.
•Service operations. Starts or stops Secure Agent services and updates which services and connectors are enabled on a runtime environment.
•Runtime environment inspection. Looks up Secure Agent groups by ID or name, lists groups, and reads their service property configurations and included agents.
Use cases
Use this MCP server to address the following use cases:
•Health inspection. Enumerate Secure Agents, surface unassigned or degraded Secure Agents, and report current service states.
•Configuration drift review. Review Secure Agent service properties for a group against a desired baseline.
•Self-healing services. Detect failed services and issue start or stop commands to restore execution capacity.
•Service and connector enablement. Enable or disable Secure Agent services, and connectors on a Secure Agent group to match the capabilities a workload requires.
Tools
The following table describes the tools available on this MCP server:
Tools
Description
get_agent_by_id
Gets Secure Agent details by ID.
get_agent_by_name
Gets Secure Agent details by name.
get_agent_service_status
Gets service status for a single Secure Agent.
get_all_agents_service_status
Gets service status for all Secure Agents in the organization.
get_runtime_environment_by_id
Gets runtime environment details by ID.
get_runtime_environment_by_name
Gets runtime environment details by name.
get_runtime_environment_configs
Gets overridden service properties for a runtime environment.
get_runtime_environment_configs_details
Gets all editable service properties for a runtime environment.
get_runtime_environment_selections
Gets enabled selections for a Secure Agent group, also known as a runtime environment. Examples of selections are services and connectors.
get_runtime_environment_selections_details
Gets all services, connectors, and additional services available to a Secure Agent group based on your organization's license. A Secure Agent group, also known as a runtime environment. Each item includes its current enabled state.
list_agents
Lists Secure Agents in the organization.
list_runtime_environments
Lists runtime environments in the organization.
start_agent_service
Starts a Secure Agent service.
stop_agent_service
Stops a Secure Agent service.
update_runtime_environment_selections
Enables or disables services, connectors, and additional services for a Secure Agent group, also known as a runtime environment.
Note:
In AI Agent Engineering, the MCP server tools are called "actions."