Skip to content
docs
GitHub

MCP tool reference

All 74 Lomi MCP tools, their arguments and complete input/output schemas.

The catalog contains 74 tools. These tables describe their purpose and top-level fields. Bold fields are required by the schema; other fields are structurally optional but can be required for a particular variant or state. or separates alternative complete inputs.

Download the complete JSON catalog: original server descriptions, inputSchema, outputSchema, nested variants, defaults and annotations for every tool. It was obtained from the built server’s actual tools/list, not hand-reconstructed schemas.

Schemas define shape; native validation adds ranges, permissions and target state. Do not copy illustrative IDs or add common fields to tools that do not accept them. Read operations and revisions, permissions and workflows before modifying resources.

Tool Action Arguments
lomi_status Connection, UI readiness and capabilities; available without pairing. {}
lomi_diagnostics Connection diagnosis and the next Settings step; no unapproved workspace data. {}
lomi_connect Select an already approved workspace and obtain the session retry epoch. workspaceId
lomi_events_read Bounded operation-state metadata; continue with the returned cursor. cursor, limit, workspaceId
lomi_operation_get Read this connection’s durable receipt by ID or exact retry identity. operationId
or
projectId, requestKey, retryEpoch, tool
lomi_operation_cancel Cancel queued work or request cancellation; completed effects remain. operationId
Tool Action Arguments
lomi_workspace_list List only approved workspaces and the observed domain revision. cursor, limit
lomi_workspace_create Create a same-project workspace with a scratch file; no shell starts. expectedRevision, name, requestKey, retryEpoch, workspaceId
lomi_workspace_update Rename, select the saved active panel, or request guarded closure. expectedRevision, name, requestKey, retryEpoch, workspaceId
or
action (select), expectedRevision, requestKey, retryEpoch, workspaceId
or
action (close), expectedRevision, requestKey, retryEpoch, workspaceId
lomi_project_open Request a canonical folder with one workspace; exact-folder approval. expectedRevision, name, projectPath, requestKey, retryEpoch, workspaceId
lomi_project_close Close an exact project with grants for every workspace; folder retained. expectedRevision, projectId, requestKey, retryEpoch, workspaceId
lomi_panel_list List stable panel IDs and runtime identity/ownership in an approved workspace. cursor, limit, workspaceId
lomi_panel_focus Select a qualified current view without implicitly starting lazy resources. browserGeneration, expectedRevision, panelId, requestKey, retryEpoch, terminalSessionId, workspaceId
lomi_panel_control Claim/release terminal or Android input; returns a temporary lease. action (claim / release), panelId, requestKey, retryEpoch, terminalSessionId, workspaceId
or
action (claim / release), deviceId, expectedRevision, generation, panelId, requestKey, retryEpoch, workspaceId
lomi_panel_close Close an authorized clean/idle view with target-specific close guards. browserGeneration, expectedRevision, panelId, requestKey, retryEpoch, terminalSessionId, workspaceId
lomi_panel_move Reorder/dock/move or transfer within the same project; retain live resources. expectedRevision, movement, requestKey, retryEpoch, workspaceId
Tool Action Arguments
lomi_terminal_create Create an approved Bash/Zsh shell and poll for its session and lease. cwdRelative, expectedRevision, profileId, requestKey, retryEpoch, title, workspaceId
lomi_terminal_run Run one single-line command at an observed idle prompt; durable receipt. command, leaseId, panelId, requestKey, retryEpoch, terminalSessionId, workspaceId
lomi_terminal_input Send exact text or a supported key; ordered sequence, no implicit Enter. input, inputSequence, leaseId, panelId, terminalSessionId, workspaceId
lomi_terminal_read Read bounded output, command output, xterm screen or opt-in raw bytes. cursor, maxBytes, minimumParsedSequence, mode (output / command / screen / raw), operationId, panelId, terminalSessionId, workspaceId
lomi_terminal_interrupt Send Ctrl+C once to an observed running command; verify exit separately. leaseId, operationId, panelId, requestKey, retryEpoch, terminalSessionId, workspaceId
Tool Action Arguments
lomi_files_list List one directory; no recursion/content reads, scoped revision-bound cursor. cursor, limit, relativeDirectory, workspaceId
lomi_files_read Read disk text with original line endings and exact disk SHA-256 pagination. expectedDiskRevision, maxChars, relativePath, startUtf16, workspaceId
lomi_files_search Search disk text; literal/regex and globs, explicit limits and omissions. cursor, limit, query, relativeDirectory, workspaceId
lomi_files_mutate Create, rename, move or Trash entries with parent/source revisions. expectedRevision, operation, requestKey, retryEpoch, workspaceId
lomi_editor_open Open/reuse an editor or supported preview without saving or executing. expectedRevision, presentation (editor / preview / split), relativePath, requestKey, retryEpoch, workspaceId
lomi_editor_read Read a loaded shared buffer, including dirty text; never falls back to disk. documentId, expectedBufferRevision, maxChars, panelId, relativePath, startUtf16, workspaceId
lomi_editor_apply_edits Apply 1-64 nonoverlapping UTF-16 edits as one undo transaction; no save. documentId, edits, expectedBufferRevision, expectedDiskRevision, expectedRevision, panelId, relativePath, requestKey, retryEpoch, workspaceId
lomi_editor_save Atomically save the exact buffer revision while rechecking disk bytes. documentId, expectedBufferRevision, expectedDiskRevision, expectedRevision, panelId, relativePath, requestKey, retryEpoch, workspaceId
Tool Action Arguments
lomi_browser_open Create an origin-approved isolated profile; optionally keep the page hidden. expectedRevision, requestKey, retryEpoch, url, visible, workspaceId
lomi_browser_navigate Navigate an owned generation; wait for document commit/load, not network idle. browserGeneration, leaseId, panelId, requestKey, retryEpoch, url, waitUntil (commit / load), workspaceId
lomi_browser_snapshot Bounded semantic DOM and same-origin frames; form values are omitted. browserGeneration, maxBytes, maxNodes, panelId, workspaceId
lomi_browser_wait Wait up to ten seconds for load/URL/text/role-name; replaces snapshot refs. browserGeneration, condition, panelId, timeoutMs, workspaceId
lomi_browser_click Synthetic click of a visible current element; no file-input/download activation. browserGeneration, elementRef, leaseId, navigationId, panelId, requestKey, retryEpoch, snapshotId, workspaceId
lomi_browser_fill Fill a supported control with up to 16 KiB text; return length, not value. browserGeneration, elementRef, leaseId, navigationId, panelId, requestKey, retryEpoch, snapshotId, text, workspaceId
lomi_browser_scroll Scroll the current frame viewport by CSS pixel deltas; observed position. browserGeneration, deltaX, deltaY, leaseId, navigationId, panelId, requestKey, retryEpoch, snapshotId, viewportRef, workspaceId
lomi_browser_key Synthetic key events to a focused top-level element; no native default action. browserGeneration, elementRef, key (Enter / Tab / Escape / Backspace / ArrowUp / ArrowDown / ArrowLeft / ArrowRight / Home / End), leaseId, navigationId, panelId, requestKey, retryEpoch, snapshotId, workspaceId
lomi_browser_logs Read JavaScript errors, console or promise rejections with separate cursors. browserGeneration, cursor, limit, logKind (javascript_error / console / promise_rejection), panelId, workspaceId
lomi_browser_screenshot Viewport PNG including embedded frames; separate composite capture scope. browserGeneration, maxBytes, maxWidth, navigationId, panelId, workspaceId
lomi_browser_download Bounded same-origin GET to an immutable artifact; no redirects. browserGeneration, expectedRevision, maxBytes, navigationId, panelId, requestKey, retryEpoch, url, workspaceId
lomi_browser_upload Attach an approved immutable artifact to an exact visible file input. artifactId, browserGeneration, elementRef, expectedRevision, expectedSha256, fileName, frameId, leaseId, navigationId, panelId, requestKey, retryEpoch, snapshotId, workspaceId
Tool Action Arguments
lomi_artifact_import Copy an exact project file as opaque bytes or a validated APK; poll completion. expectedByteLength, expectedRevision, expectedSha256, kind (android_apk / file), relativePath, requestKey, retryEpoch, workspaceId
lomi_artifact_read Read metadata or captured PNG; recheck original source access and expiry. artifactId, workspaceId
lomi_artifact_export Write up to 4 MiB of owned artifact bytes to a new project file. artifactId, expectedParentRevision, expectedRevision, expectedSha256, relativePath, requestKey, retryEpoch, workspaceId
Tool Action Arguments
lomi_android_list List explicitly shared devices and runtime status without starting anything. workspaceId
lomi_android_open Create/select a retained device panel; does not boot the emulator. deviceId, expectedRevision, requestKey, retryEpoch, workspaceId
lomi_android_start Start the approved stopped device; poll full readiness and keep generation. deviceId, expectedRevision, panelId, requestKey, retryEpoch, workspaceId
lomi_android_stop Confirmed stop of the owned generation, preserving installed apps/data. deviceId, expectedRevision, generation, panelId, requestKey, retryEpoch, workspaceId
lomi_android_snapshot UI Automator projection; observation-local nodes, editable/password text omitted. deviceId, generation, maxBytes, maxNodes, panelId, workspaceId
lomi_android_screenshot Single bounded PNG with rotation and image-to-hardware coordinate metadata. deviceId, generation, maxBytes, maxEdge, panelId, workspaceId
lomi_android_input Ordered leased touch/key/navigation/rotation/text in a focused visible panel. deviceId, event, generation, inputSequence, leaseId, panelId, retryEpoch, workspaceId
lomi_android_launch Deliver an intent to an approved package; inspect actual UI separately. activity, deviceId, expectedRevision, generation, packageName, panelId, requestKey, retryEpoch, workspaceId
lomi_android_logcat Recent main-process/main-buffer logs for an approved package; explicit gaps. cursor, deviceId, generation, limit, minPriority (V / D / I / W / E / F), packageName, panelId, workspaceId
lomi_android_install_apk Request installation of exact imported bytes on the controlled device. artifactId, deviceId, generation, panelId, requestKey, retryEpoch, sha256, workspaceId
lomi_android_setup_plan Inventory/catalog or prepare exact SDK/Java versions and license digests. action, workspaceId
lomi_android_setup_apply Apply the prepared plan through native approval/installer; no blind replay. planId, planRevision, requestKey, retryEpoch, workspaceId
lomi_android_device_manage Create/modify/wipe/delete, recover/clean up, restore metadata or maintain tools. action, requestKey, retryEpoch, workspaceId
Tool Action Arguments
lomi_git_status Guarded read-only status snapshot for an exact repository; no helpers/network. cursor, limit, repositoryRelative, workspaceId
lomi_git_diff Bounded literal worktree/staged/commit patch with revision-checked continuation. commit, comparison (worktree / staged / commit), expectedObservationRevision, maxChars, relativePath, repositoryRelative, startUtf16, workspaceId
lomi_git_history Bounded commit history pinned to the starting commit, not a moving HEAD. commit, limit, repositoryRelative, skip, workspaceId
lomi_git_commit Exact full-SHA commit metadata/message and first-parent changed-file pages. commit, filesLimit, filesSkip, repositoryRelative, workspaceId
lomi_git_remotes Redacted remote names/transport/host/port; no credentials or contact. repositoryRelative, workspaceId
lomi_git_open Open a read-only diff or commit view after guarded native preparation. expectedRevision, repositoryRelative, requestKey, retryEpoch, view, workspaceId
lomi_git_mutate Request stage/unstage/commit/fetch/push/discard/pull with an exact native plan. expectedRemoteCommit, expectedRevision, message, operation (stage / unstage / commit / fetch / push / discard / pull), paths, pullMode, reference, remote, repositoryRelative, requestKey, retryEpoch, sourceCommit, workspaceId
Tool Action Arguments
lomi_chat_list Metadata only for individually shared conversations; no implicit project history. expectedRevision, limit, offset, workspaceId
lomi_chat_read Saved draft/message checkpoint text; omitted parts and revision pagination. conversationId, expectedRevision, includeSendTarget, maxChars, part, startUtf16, workspaceId
lomi_chat_open Open/reuse a shared conversation or create one; no provider call. expectedRevision, requestKey, retryEpoch, target, workspaceId
lomi_chat_draft Replace persisted text while preserving attachments/concurrent edits; no send. conversationId, expectedConversationRevision, expectedDraftRevision, expectedRevision, panelId, requestKey, retryEpoch, text, workspaceId
lomi_chat_send Send the exact saved draft to its configured model after context approval. connectionId, conversationId, expectedConversationRevision, expectedDraftRevision, expectedRevision, model, panelId, requestKey, retryEpoch, workspaceId
lomi_chat_stop Stop only an exact native request ID and retain a saved partial checkpoint. conversationId, requestId, requestKey, retryEpoch, workspaceId
lomi_chat_export Paged Markdown/JSON of saved text variants/draft; no file/provider action. conversationId, expectedRevision, format (markdown / json), maxChars, startUtf16, workspaceId
Tool Action Arguments
lomi_settings_open Request a named Settings section; no read/write permission implied. expectedRevision, page (keybinds / themes / plugins / terminal / about / chat-ai / android / agent-control), requestKey, retryEpoch, workspaceId
lomi_settings_read Read retained nonsecret editor/terminal/keybinding/theme preferences. expectedRevision, limit, offset, section (editor / terminal / keybinds / themes), workspaceId
lomi_settings_update Request one supported revision-bound preference patch and review before/after. expectedRevision, expectedSettingsRevision, patch, requestKey, retryEpoch, workspaceId

Nested action, operation, movement, patch, target, input, event, condition, part and view fields use closed variants in that tool’s schema. They are not arbitrary JSON or executable code. For example, lomi_workspace_update accepts a rename with name, selection with action: "select" or closure with action: "close"; do not combine arguments from different variants.

JSON Schema defaults/type ranges do not always express narrower product limits. For example, maxChars is represented as uint16, but native text reads accept 2-8192. The server description and workflows give the effective bounds. Catalog presence does not establish platform qualification or authorization.

Source: catalog and schema mapping, domain contracts, exact source audit.