Skip to content
MZBase MZBase Docs

Read screen text

  • Type phone.ocr
  • Group MZBase
  • Role action
  • Risk acts outside MZBase
  • Side effect safe to repeat
  • Runs once per item
  • Needs phone, ai

Reads the text on the phone screen with AI vision

Also available to AI agents and over MCP as a tool.

Uses the AI gateway; its cost shows in the run.

Parameters

Section titled “Parameters”

phoneId

Phone · string · optional

The phone to use. Empty = the phone of the run’s target.

route

AI route · string · optional

The AI route that runs it (AI settings). Empty = the default route for this kind of task; the route sets the price.

fields

Fields · array · optional

Fields:

  • name (string) Name
  • description (string) Description
  • type (string) Type

region

Region · json · optional

Only read this part of the screen (x, y, width, height). Empty = the whole screen.

into

Into field · string · optional · default ocr

Outputs

Section titled “Outputs”
  • main

← All nodes