Skip to content

System Information

Tools for retrieving system, CPU, memory, disk, and hardware information.

Choosing where to run

All tools on this page require a host parameter (string). Pass localhost to run the command on the system the MCP server runs on, or a remote machine to run it there via SSH. See SSH Configuration for details, and Host mode for restricting which of the two a server accepts.

get_cpu_information

Get CPU information.

Returns:

  • model (string)
  • logical_cores (integer)
  • physical_cores (integer)
  • frequency_mhz (number)
  • load_avg_1m (number)
  • load_avg_5m (number)
  • load_avg_15m (number)
  • cpu_line (string)

get_disk_usage

Get detailed disk space information including size, mount points, and utilization.

Returns:

  • filesystems (array of object)
    • source (string or null)
    • fstype (string or null)
    • size (string or null)
    • used (string or null)
    • avail (string or null)
    • use% (string or null)
    • target (string or null)

get_hardware_information

Get hardware information such as CPU details, PCI devices, USB devices, and hardware information from DMI.

get_memory_information

Get detailed memory including physical and swap.

Returns:

  • ram (object): Parsed memory information from free command.
    • total (integer)
    • used (integer)
    • free (integer)
    • shared (integer)
    • buffers (integer)
    • cached (integer)
    • available (integer)
  • swap (object or null)
    • total (integer)
    • used (integer)
    • free (integer)

get_system_information

Get basic system information, including operating system, distribution, kernel version, uptime, last boot time, PCP installation and service status, and historical PCP time ranges.

Returns:

  • hostname (string)
  • os_name (string)
  • os_version (string)
  • kernel (string)
  • arch (string)
  • uptime (string)
  • boot_time (string)
  • pcp (object): PCP availability and service status.
    • installed (boolean)
    • missing_commands (array of string): Required PCP commands that are not installed. On Fedora/RHEL, pmlogger is shipped by the 'pcp' package and pmrep by 'pcp-system-tools'.
    • pmcd_running (boolean)
    • pmlogger_running (boolean)
    • available_time_ranges (array of object or null)
      • start (string)
      • end (string)
    • metrics_guide (string or null)