mcp_get_plugins

Summary

Field	Value
Tool name	get_plugins
MCP title	List plugin registrations and steps
Category	standard
Implementation	DynamicsCrm.DevKit.Cli/Mcp/Tools/GetPluginsTool.cs
Estimated token count	~391 tokens (tools/list tool JSON, o200k_base, measured 2026-06-18)
Last verified	2026-06-18

MCP Tool Description (Exact)

Plugin assemblies, types, processing steps. Modes: no filters = assembly list with type counts. assembly_name (1 match) = assembly detail (types+steps+images). entity_name = all steps on entity across assemblies. Stages: PreValidation/PreOperation/PostOperation/MainOperation (Custom API/DataProvider). Set include_config=true only for secure config inspection.

WHEN TO USE:
- Audit plugin registrations across assemblies
- Find which plugin handles a message/entity (filter by entity_name + message_name)
- Inspect step images / mode (sync/async) before changes

Fuzzy on assembly_name: 0/multi → tool returns disambiguation list and stops; AI must ask user. 1 → auto-detail.

Parameters

Name	Type	Required	Default	Description
assembly_name	string	No	""	Assembly name contains.
entity_name	string	No	""	Steps for entity Display Name or logical name (e.g. 'Account' or 'account').
message_name	string	No	""	SDK message (Create, Update, Delete, …).
type_name	string	No	""	Plugin type name contains.
include_images	boolean	No	true	Pre/post images.
include_config	boolean	No	false	Config values (security-sensitive).
stage	string	No	""	prevalidation / preoperation / postoperation / mainoperation.
mode	string	No	""	'sync' / 'async'.
active_only	boolean	No	true	Only activated steps.
max_records	integer	No	100	Steps limit, 1–500.

Input Schema

{
  "type": "object",
  "properties": {
    "assembly_name": {
      "type": "string",
      "description": "Assembly name contains.",
      "default": ""
    },
    "entity_name": {
      "type": "string",
      "description": "Steps for entity Display Name or logical name (e.g. 'Account' or 'account').",
      "default": ""
    },
    "message_name": {
      "type": "string",
      "description": "SDK message (Create, Update, Delete, …).",
      "default": ""
    },
    "type_name": {
      "type": "string",
      "description": "Plugin type name contains.",
      "default": ""
    },
    "include_images": {
      "type": "boolean",
      "description": "Pre/post images.",
      "default": true
    },
    "include_config": {
      "type": "boolean",
      "description": "Config values (security-sensitive).",
      "default": false
    },
    "stage": {
      "type": "string",
      "description": "prevalidation / preoperation / postoperation / mainoperation.",
      "default": ""
    },
    "mode": {
      "type": "string",
      "description": "'sync' / 'async'.",
      "default": ""
    },
    "active_only": {
      "type": "boolean",
      "description": "Only activated steps.",
      "default": true
    },
    "max_records": {
      "type": "integer",
      "description": "Steps limit, 1–500.",
      "default": 100
    }
  },
  "required": []
}

Related MCP Resources

Resource	URI / URI template	MIME type	Reason
server_logic_guide	docs://server_logic_guide	text/markdown	Inferred from source: Filtering patterns, list/detail modes, and entity scoping for server-logic tools. Read this when get_plugins, get_workflows, get_flows, etc. returns an error.

When To Use

• Audit plugin registrations across assemblies
• Find which plugin handles a message/entity (filter by entity_name + message_name)
• Inspect step images / mode (sync/async) before changes

Notes

• Use the exact MCP description and parameter schema above as the authoritative contract.

Example

{
  "assembly_name": "string"
}

Output

Returns CallToolResult from the MCP server. The response content and structured fields follow the tool implementation and model returned by GetPluginsTool.get_plugins.

Prompt Examples

• "List active plugin steps registered on Contact update and include images."
• "Inspect this plugin assembly and show its types, steps, and registered images."
• "Find all synchronous pre-operation plugin steps for the Account table."