Log inGet started

mcpLog

Updated 5 September 2026

The mcpLog namespace — 7 functions.

globals/mcpLog/clear

mcpLog.clear() -> boolean

Clear all entries from the engine's MCP log ring buffer.

Returns boolean — True on success.

mcpLog.clear()

globals/mcpLog/query

mcpLog.query(limit: number?) -> { McpLogEntry }

Return the most-recent MCP tool-call entries from the engine's MCP log ring buffer (newest last). Pass limit to cap how many entries are returned — omit for the full ring (up to 500 entries).

Parameters

  • limit number (optional) — Maximum number of entries to return.

Returns { McpLogEntry } — Array of tool-call entry tables.

for _, e in ipairs(mcpLog.query(50)) do print(e.tool_name, e.status) end

modules/mcpLog/README

require("@builtin/modules/api/engine/mcpLog") -- mcpLog (also available as global 'mcpLog')

Read-only MCP tool-call log ring buffer. Public Luau surface over the __mcpLog Internal FFI namespace.

Usage: local mcpLog = require("@builtin/modules/api/engine/mcpLog") Also available as global: mcpLog

modules/mcpLog/clear

clear(): boolean

Clear all entries from the engine's MCP log ring buffer.

mcpLog.clear()

modules/mcpLog/query

query(limit: number?): { McpLogEntry }

Return the most-recent MCP tool-call entries from the engine's MCP log ring buffer (newest last). Pass limit to cap how many entries are returned — omit for the full ring (up to 500 entries).

Parameters

  • limit number? (optional) — Maximum number of entries to return.
for _, e in ipairs(mcpLog.query(50)) do print(e.tool_name, e.status) end

typed/builtin//modules/api/engine/mcpLog/mcpLog/clear

mcpLog.clear() -> boolean

Clear all entries from the engine's MCP log ring buffer.

Returns boolean — True on success.

mcpLog.clear()

typed/builtin//modules/api/engine/mcpLog/mcpLog/query

mcpLog.query(limit: number?) -> { McpLogEntry }

Return the most-recent MCP tool-call entries from the engine's MCP log ring buffer (newest last). Pass limit to cap how many entries are returned — omit for the full ring (up to 500 entries).

Parameters

  • limit number (optional) — Maximum number of entries to return.

Returns { McpLogEntry } — Array of tool-call entry tables.

for _, e in ipairs(mcpLog.query(50)) do print(e.tool_name, e.status) end
  • api
  • reference