aiida_mcp.processes module

Process node inspection tools.

aiida_mcp.processes.get_process(pk: int) → dict[str, Any]

Return details, inputs and outputs for one process node.

Parameters:

pk (int) – Primary key of the process node.

Returns:

The process’s details, plus summaries of its incoming and outgoing links.

Return type:

dict[str, Any]

Raises:

ToolError – If no node exists with the given PK, or it is not a process node.

aiida_mcp.processes.get_process_report(pk: int, limit: int = 100) → dict[str, Any]

Return the most recent log messages for one process node, oldest first.

Parameters:
  • pk (int) – Primary key of the process node.

  • limit (int) – Maximum number of log entries to return.

Returns:

The total number of log entries, the number returned, and the log entries themselves.

Return type:

dict[str, Any]

Raises:

ToolError – If no node exists with the given PK, or it is not a process node.

aiida_mcp.processes.list_processes(state: str | None = None, label: str | None = None, created_after: str | None = None, limit: int = 20) → dict[str, Any]

List process nodes, newest first, with optional filters.

Parameters:
  • state (str or None) – Process state to filter by. One of PROCESS_STATES.

  • label (str or None) – Exact process label to match.

  • created_after (str or None) – ISO date or datetime; only include processes created at or after it.

  • limit (int) – Maximum number of processes to return.

Returns:

The number of matching processes, the number returned, and a summary of each one.

Return type:

dict[str, Any]

Raises:

ToolError – If state is not one of PROCESS_STATES.