mcp_get_system_jobs

Summary

Field	Value
Tool name	get_system_jobs
MCP title	List and inspect system jobs
Category	standard
Implementation	DynamicsCrm.DevKit.Cli/Mcp/Tools/GetSystemJobsTool.cs
Estimated token count	~330 tokens (tools/list tool JSON, o200k_base, measured 2026-06-18)
Last verified	2026-06-18

MCP Tool Description (Exact)

System jobs (asyncoperation) for async failures, workflow errors, bulk ops, imports, solutions. record_id empty = list (default: failed jobs last 24h). Set = detail (error + stack trace).

WHEN TO USE:
- Debug async failures (list failed → detail for stack trace)
- Monitor bulk ops (operation_type='bulk_delete'/'import'/'solution')
- Trace one request (correlation_id across jobs)
- Async plugin failures: combine with get_plugin_trace_logs

Parameters

Name	Type	Required	Default	Description
record_id	string	No	""	GUID → detail. Empty = list.
entity_name	string	No	""	Filter by entity Display Name or logical name (e.g. 'Account' or 'account').
status	string	No	"failed"	failed/succeeded/waiting/in_progress/canceled/all.
operation_type	string	No	""	plugin/workflow/bulk_delete/import/goal_rollup/solution/all.
name_filter	string	No	""	Name contains.
correlation_id	string	No	""	GUID. Trace one request across jobs.
minutes_ago	integer	No	0	0 = 1440 (24h) default. Max 43200.
max_records	integer	No	50	Max 500.

Input Schema

{
  "type": "object",
  "properties": {
    "record_id": {
      "type": "string",
      "description": "GUID → detail. Empty = list.",
      "default": ""
    },
    "entity_name": {
      "type": "string",
      "description": "Filter by entity Display Name or logical name (e.g. 'Account' or 'account').",
      "default": ""
    },
    "status": {
      "type": "string",
      "description": "failed/succeeded/waiting/in_progress/canceled/all.",
      "default": "failed"
    },
    "operation_type": {
      "type": "string",
      "description": "plugin/workflow/bulk_delete/import/goal_rollup/solution/all.",
      "default": ""
    },
    "name_filter": {
      "type": "string",
      "description": "Name contains.",
      "default": ""
    },
    "correlation_id": {
      "type": "string",
      "description": "GUID. Trace one request across jobs.",
      "default": ""
    },
    "minutes_ago": {
      "type": "integer",
      "description": "0 = 1440 (24h) default. Max 43200.",
      "default": 0
    },
    "max_records": {
      "type": "integer",
      "description": "Max 500.",
      "default": 50
    }
  },
  "required": []
}

Related MCP Resources

This tool does not require any MCP resources.

When To Use

• Debug async failures (list failed → detail for stack trace)
• Monitor bulk ops (operation_type='bulk_delete'/'import'/'solution')
• Trace one request (correlation_id across jobs)
• Async plugin failures: combine with get_plugin_trace_logs

Notes

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

Example

{
  "record_id": "string"
}

Output

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

Prompt Examples

• "Show failed async jobs from the last 24 hours and summarize the error messages."
• "Open this system job and include the stack trace details."
• "Find failed solution import jobs and report the correlation IDs."