System logs

System logs are runtime records of activity, events, and errors generated by Neptune DXP - Open Edition. The MCP server provides read-only tools to list and retrieve system log entries. There are no tools to create, modify, or delete log entries through MCP.

Required role: system-logs.

If your user account does not have this role, every tool in this group fails immediately with an access denied error. Contact an administrator to request the role, or see Access control for more information on how roles are enforced.

Available tools

Parameters are shown with their type and a short description. UUIDs are always strings.

Tool Description Parameters

list_system_logs

List all system log entries visible to the user. Neptune DXP - Open Edition writes one file per day per category. Returns files grouped by category, with optional filtering by type and date range.

  • type (string, optional): Log category to filter by; one of server, exceptions, scripts, requests, vault.

  • dateFrom (string, optional): Start of date range filter.

  • dateTo (string, optional) — End of date range filter.

get_system_log

Read entries from a specific system log file (paginated). Use list_system_logs first to find available file names. Supports filtering by level, message substring, script name, and script group.

  • type (string): Log category; one of server, exceptions, scripts, requests, vault.

  • name (string): Log file name to read.

  • start (number, optional): First entry index for pagination; default 0.

  • end (number, optional): Last entry index for pagination; default 100.

  • level (string[], optional): Filter by log level(s).

  • message (string, optional): Filter by message substring.

  • scriptName (string, optional): Filter by script name.

  • scriptGroup (string[], optional): Filter by script group(s).

  • dateFrom (string, optional): Start of date range filter.

  • dateTo (string, optional): End of date range filter.

Related topics