# Optics (mcpb · optics-framework-1.11.0.mcpb)

Drive Android, iOS, smart TV and web apps from an agent; save the steps as CSV/YAML test suites.

- Trust score: 39/100 (low)
- Change this week: 0
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- mcpb · `optics-framework-1.11.0.mcpb`: 39/100 (this document), [markdown](https://verifymcp.io/servers/org-optics-framework-optics/optics-framework.md), [page](https://verifymcp.io/servers/org-optics-framework-optics/optics-framework)

## Channel facts

- Registry: `mcpb`
- Package: `https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb`
- Version: `1.11.0`
- Transport: `stdio`
- SHA-256: `9db4696f332c20627ac9e90415e3b17657be114a5f1ea3f366e788cb38a03ba3`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 12/100
  - No malware scan is available for this kind of package: the supply-chain vendors we use do not cover it. This is a permanent gap in our coverage, not a finding about the package.
  - Known CVEs were checked across the 57 of 57 dependencies we could resolve, so this covers what we could see, not the whole tree.
  - Install-script risk not yet assessed.
  - 3 of 57 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (Apache-2.0).
  - Actively maintained (last published 16 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 69/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (fair).
  - Context-footprint check failed: tool/resource definitions use about 6416 tokens (~149/item across 43 items; 41 tools + 2 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 71/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
  - Structured output schemas are declared (5% of tools); any adoption earns full credit.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 4 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "terminate_session" implies "terminate" and declares no destructiveHint at all, which the MCP spec reads as destructive by default.
  - An AI judge read all 43 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the Optics MCP server?

Optics ships as an MCPB bundle, a single file you download and open in an MCP host that supports MCPB bundles, such as Claude Desktop. The host reads the launch command from the bundle's own manifest, so there is no command to copy. Before opening it, check the file's SHA-256 matches the one the MCP registry declares for it, 9db4696f332c20627ac9e90415e3b17657be114a5f1ea3f366e788cb38a03ba3; the commands to do that are on this page. If it does not match, do not open it.

- Download bundle: `https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb`
- SHA-256: `9db4696f332c20627ac9e90415e3b17657be114a5f1ea3f366e788cb38a03ba3`

### Verify on macOS / Linux

```bash
echo "9db4696f332c20627ac9e90415e3b17657be114a5f1ea3f366e788cb38a03ba3  optics-framework-1.11.0.mcpb" | shasum -a 256 -c
```

### Verify on Windows (PowerShell)

```powershell
(Get-FileHash -Algorithm SHA256 .\optics-framework-1.11.0.mcpb).Hash -eq "9db4696f332c20627ac9e90415e3b17657be114a5f1ea3f366e788cb38a03ba3"
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-21 (score 39, +3)

- [security improvement] Known CVEs: unverified → partial
- [functional improvement] Dependency health: unverified → 0.97

### 2026-10-20 (score 36)

First indexed and scored.

## MCP tools (41)

### `start_session` (~362 tokens)

Start Session

Start a new optics session and launch the target app.

Returns {"session_id", "driver_id"}. Pass the session_id to every
keyword tool and state resource. The app is auto-launched on start.
Sessions are NOT shared with `optics serve`/`optics live` (separate
process); start one here before using any keyword tool.

ai_self_heal / llm_provider / llm_model: per-session overrides for AI self-heal.
Each falls back to the matching service-level env var the operator set at
start-up (OPTICS_AI_SELF_HEAL / OPTICS_LLM_PROVIDER / OPTICS_LLM_MODEL) when left
unset, so an already-configured server needs none of them. Because the process
is multi-tenant, pass them to opt in/out or pick your own model for just this
session instead of being locked to the operator's choice. Note that
ai_self_heal=True with no provider configured anywhere still degrades to inert
(no LLM to drive it); LLM credentials always come from the provider's own env
vars (e.g. GOOGLE_API_KEY), never this tool.

strict_element_match: reject fuzzy/partial text and xpath matches on locate
(default False, i.e. fuzzy-tolerant). Set True when a near-miss locator string
pressing the wrong element is worse than the keyword failing outright.

Input parameters:

- `ai_self_heal`
- `capabilities`
- `driver` (string)
- `elements_sources`
- `image_detection`
- `llm_model`
- `llm_provider`
- `project_path`
- `strict_element_match`
- `text_detection`
- `url`

### `terminate_session` (~26 tokens)

Terminate Session

Terminate a session and release its driver/resources.

Input parameters:

- `session_id` (string, required)

### `screenshot` (~60 tokens)

Screenshot

Capture the current screen and return it as a rendered PNG image.

Prefer this over the `optics://session/{session_id}/screenshot` resource
when you want the screen rendered inline (the resource returns raw bytes).

Input parameters:

- `session_id` (string, required)

### `clear_element_text` (~209 tokens)

Clear Element Text

Clear text from a specified element.

:param element: The target element (Image template, OCR template, or XPath).
:param aoi_x: X percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_y: Y percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_width: Width percentage of Area of Interest (0-100). Default: 100.
:param aoi_height: Height percentage of Area of Interest (0-100). Default: 100.
:param event_name: The event triggering the action.
:param index: Index of the element if multiple matches are found.

Input parameters:

- `aoi_height` (string)
- `aoi_width` (string)
- `aoi_x` (string)
- `aoi_y` (string)
- `element` (string, required)
- `event_name`
- `index` (string)
- `session_id` (string, required)

### `detect_and_press` (~144 tokens)

Detect And Press

Press an element if it appears within ``timeout``; otherwise do nothing.

When the element never appears the press is skipped and the keyword still succeeds
(it does not raise), so use it for optional taps such as dismissing a popup that may
not show. Use ``press_element`` when the target must be present.

:param element: The element to be detected and pressed (Image template, OCR template, or XPath).
:param timeout: Seconds to wait for the element to appear.
:param event_name: The event triggering the press.

Input parameters:

- `element` (string, required)
- `event_name`
- `session_id` (string, required)
- `timeout` (string)

### `enter_number` (~225 tokens)

Enter Number

Enter a specified number into an element.

:param element: The target element (Image template, OCR template, or XPath).
:param number: The number to be entered.
:param aoi_x: X percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_y: Y percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_width: Width percentage of Area of Interest (0-100). Default: 100.
:param aoi_height: Height percentage of Area of Interest (0-100). Default: 100.
:param event_name: The event triggering the input.
:param index: Index of the element if multiple matches are found.

Input parameters:

- `aoi_height` (string)
- `aoi_width` (string)
- `aoi_x` (string)
- `aoi_y` (string)
- `element` (string, required)
- `event_name`
- `index` (string)
- `number` (string, required)
- `session_id` (string, required)

### `enter_text` (~224 tokens)

Enter Text

Enter text into a specified element.

:param element: The target element (Image template, OCR template, or XPath).
:param text: The text to be entered.
:param aoi_x: X percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_y: Y percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_width: Width percentage of Area of Interest (0-100). Default: 100.
:param aoi_height: Height percentage of Area of Interest (0-100). Default: 100.
:param event_name: The event triggering the input.
:param index: Index of the element if multiple matches are found.

Input parameters:

- `aoi_height` (string)
- `aoi_width` (string)
- `aoi_x` (string)
- `aoi_y` (string)
- `element` (string, required)
- `event_name`
- `index` (string)
- `session_id` (string, required)
- `text` (string, required)

### `enter_text_direct` (~55 tokens)

Enter Text Direct

Enter text using the keyboard.

:param text: The text to be entered.
:param event_name: The event triggering the input.

Input parameters:

- `event_name`
- `session_id` (string, required)
- `text` (string, required)

### `enter_text_using_keyboard` (~101 tokens)

Enter Text Using Keyboard

Enter text or press a special key using the keyboard.

If the input is a string that includes angle brackets (e.g., '<enter>'),
the text between the brackets will be interpreted as a special key name and mapped accordingly.

:param text_input: The text or special key identifier to send.
:param event_name: Optional event label for logging.

Input parameters:

- `event_name`
- `session_id` (string, required)
- `text_input` (string, required)

### `execute_script` (~162 tokens)

Execute Script

Execute JavaScript/script in the current context.

:param script_or_json: The JavaScript code/script command, or a JSON string containing
                       {"script": "...", "args": {...}} or {"script": "..."}.
                       Examples:
                       - "mobile:pressKey" (plain script)
                       - '{"script": "mobile:pressKey", "args": {"keycode": 3}}' (JSON with args)
                       - '{"script": "mobile:clear"}' (JSON without args)
:param event_name: The event triggering the script execution, if any.
:return: The result of the script execution.
:rtype: Any

Input parameters:

- `event_name`
- `script_or_json` (string, required)
- `session_id` (string, required)

### `get_text` (~206 tokens)

Get Text

Get the text from a specified element.

:param element: The target element (Image template, OCR template, or XPath).
:param index: Index of the element if multiple matches are found.
:param aoi_x: X percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_y: Y percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_width: Width percentage of Area of Interest (0-100). Default: 100.
:param aoi_height: Height percentage of Area of Interest (0-100). Default: 100.
:return: The text from the element or None if not supported.

Input parameters:

- `aoi_height` (string)
- `aoi_width` (string)
- `aoi_x` (string)
- `aoi_y` (string)
- `element` (string, required)
- `index` (string)
- `session_id` (string, required)

### `go_back` (~40 tokens)

Go Back

Go back one screen: browser history on the web, the back button on a phone.

Input parameters:

- `event_name`
- `session_id` (string, required)

### `press_checkbox` (~227 tokens)

Press Checkbox

Press a specified checkbox element.

.. deprecated:: Deprecated alias of :meth:`press_element` — use ``Press Element`` directly.

:param element: The checkbox element (Image template, OCR template, or XPath).
:param aoi_x: X percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_y: Y percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_width: Width percentage of Area of Interest (0-100). Default: 100.
:param aoi_height: Height percentage of Area of Interest (0-100). Default: 100.
:param event_name: The event triggering the press.
:param index: Index of the element if multiple matches are found.

Input parameters:

- `aoi_height` (string)
- `aoi_width` (string)
- `aoi_x` (string)
- `aoi_y` (string)
- `element` (string, required)
- `event_name`
- `index` (string)
- `session_id` (string, required)

### `press_element` (~259 tokens)

Press Element

Press a specified element.

:param element: The element to be pressed (text, xpath or image).
:param repeat: Number of times to repeat the press.
:param offset_x: X offset of the press.
:param offset_y: Y offset of the press.
:param index: Index of the element if multiple matches are found.
:param event_name: The event triggering the press.
:param aoi_x: X percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_y: Y percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_width: Width percentage of Area of Interest (0-100). Default: 100.
:param aoi_height: Height percentage of Area of Interest (0-100). Default: 100.

Input parameters:

- `aoi_height` (string)
- `aoi_width` (string)
- `aoi_x` (string)
- `aoi_y` (string)
- `element` (string, required)
- `event_name`
- `index` (string)
- `offset_x` (string)
- `offset_y` (string)
- `repeat` (string)
- `session_id` (string, required)

### `press_keycode` (~114 tokens)

Press Keycode

Press a device key by keycode, for system/hardware keys with no on-screen element.

On Android the keycode is the numeric KeyEvent code (3 = HOME, 4 = BACK, 66 = ENTER,
187 = RECENTS); TV platform profiles map it to their remote-control key instead.

:param keycode: The keycode to be pressed.
:param event_name: The event triggering the press.

Input parameters:

- `event_name`
- `keycode` (string, required)
- `session_id` (string, required)

### `press_radio_button` (~229 tokens)

Press Radio Button

Press a specified radio button.

.. deprecated:: Deprecated alias of :meth:`press_element` — use ``Press Element`` directly.

:param element: The radio button element (Image template, OCR template, or XPath).
:param aoi_x: X percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_y: Y percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_width: Width percentage of Area of Interest (0-100). Default: 100.
:param aoi_height: Height percentage of Area of Interest (0-100). Default: 100.
:param event_name: The event triggering the press.
:param index: Index of the element if multiple matches are found.

Input parameters:

- `aoi_height` (string)
- `aoi_width` (string)
- `aoi_x` (string)
- `aoi_y` (string)
- `element` (string, required)
- `event_name`
- `index` (string)
- `session_id` (string, required)

### `scroll` (~126 tokens)

Scroll

Scroll the current view one step in a direction.

\``direction`` names the way you move through the content: "down" reveals content
further down. Every driver supports up/down; left/right work only on Selenium
(Appium logs and ignores them, Playwright treats anything but "down" as up). The
keyword succeeds whether or not the view actually moved.

:param direction: up or down (left/right on Selenium only).
:param event_name: The event triggering the scroll.

Input parameters:

- `direction` (string, required)
- `event_name`
- `session_id` (string, required)

### `scroll_from_element` (~254 tokens)

Scroll From Element

Perform a scroll action starting from a specified element.

:param element: The element to scroll from (Image template, OCR template, or XPath).
:param direction: The scroll direction (up, down, left, right).
:param scroll_length: The length of the scroll.
:param aoi_x: X percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_y: Y percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_width: Width percentage of Area of Interest (0-100). Default: 100.
:param aoi_height: Height percentage of Area of Interest (0-100). Default: 100.
:param event_name: The event triggering the scroll.
:param index: Index of the element if multiple matches are found.

Input parameters:

- `aoi_height` (string)
- `aoi_width` (string)
- `aoi_x` (string)
- `aoi_y` (string)
- `direction` (string, required)
- `element` (string, required)
- `event_name`
- `index` (string)
- `scroll_length` (string, required)
- `session_id` (string, required)

### `scroll_until_element_appears` (~107 tokens)

Scroll Until Element Appears

Scroll in a specified direction until an element appears.

:param element: The target element (Image template, OCR template, or XPath).
:param direction: The scroll direction (up, down, left, right).
:param timeout: Timeout for the scroll operation.
:param event_name: The event triggering the scroll.

Input parameters:

- `direction` (string, required)
- `element` (string, required)
- `event_name`
- `session_id` (string, required)
- `timeout` (string, required)

### `select_dropdown_option` (~256 tokens)

Select Dropdown Option

Open a dropdown and select one of its options, scrolling through the list if needed.

Opens the dropdown by pressing `element`. If `option` isn't visible right away,
diffs the interactive elements captured before and after opening to find the
dropdown's list container, then scrolls within that container (never past the page
behind it) until `option` appears or the list stops changing. Raises `OpticsError`
(`E0201``) if `option` is never found within `timeout` seconds.

Falls back to a single-screen check (no scrolling) when page source, or a list-like
container, isn't available.

Assumption: opened dropdown list is opened in such a way that the topmost option is
visible on the screen

:param element: The dropdown element (Image template, OCR template, or XPath).
:param option: The option to select (visible label, OCR/Image template, or XPath).
:param timeout: Seconds to keep scrolling through the dropdown list before failing.
:param event_name: The event triggering the selection.

Input parameters:

- `element` (string, required)
- `event_name`
- `option` (string, required)
- `session_id` (string, required)
- `timeout` (string)

### `sleep` (~39 tokens)

Sleep

Sleep for a specified duration.

:param duration: The duration of the sleep in seconds.

Input parameters:

- `duration` (string, required)
- `session_id` (string, required)

### `swipe` (~158 tokens)

Swipe

Swipe from a point in a specified direction.

\``direction`` is the way the finger moves: "up" drags bottom to top, which reveals
content further down. The keyword succeeds whether or not anything moved.

:param coor_x: X pixel coordinate where the swipe starts.
:param coor_y: Y pixel coordinate where the swipe starts.
:param direction: The finger direction (up, down, left, right).
:param swipe_length: Swipe distance in pixels.
:param event_name: The event triggering the swipe.

Input parameters:

- `coor_x` (string, required)
- `coor_y` (string, required)
- `direction` (string)
- `event_name`
- `session_id` (string, required)
- `swipe_length` (string)

### `swipe_by_percentage` (~185 tokens)

Swipe By Percentage

Swipe from a screen position, given in percentages, in a specified direction.

\``direction`` is the way the finger moves: "up" drags bottom to top, which reveals
content further down. The keyword succeeds whether or not anything moved.

:param percent_x: Start X as a percentage of screen width (0-100).
:param percent_y: Start Y as a percentage of screen height (0-100).
:param direction: The finger direction (up, down, left, right).
:param swipe_length: Swipe distance as a percentage of screen height (up/down) or width (left/right).
:param event_name: The event triggering the swipe.

Input parameters:

- `direction` (string)
- `event_name`
- `percent_x` (string, required)
- `percent_y` (string, required)
- `session_id` (string, required)
- `swipe_length` (string)

### `swipe_from_element` (~254 tokens)

Swipe From Element

Perform a swipe action starting from a specified element.

:param element: The element to swipe from (Image template, OCR template, or XPath).
:param direction: The swipe direction (up, down, left, right).
:param swipe_length: The length of the swipe.
:param aoi_x: X percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_y: Y percentage of Area of Interest top-left corner (0-100). Default: 0.
:param aoi_width: Width percentage of Area of Interest (0-100). Default: 100.
:param aoi_height: Height percentage of Area of Interest (0-100). Default: 100.
:param event_name: The event triggering the swipe.
:param index: Index of the element if multiple matches are found.

Input parameters:

- `aoi_height` (string)
- `aoi_width` (string)
- `aoi_x` (string)
- `aoi_y` (string)
- `direction` (string, required)
- `element` (string, required)
- `event_name`
- `index` (string)
- `session_id` (string, required)
- `swipe_length` (string, required)

### `swipe_seekbar_to_right_android` (~89 tokens)

Swipe Seekbar To Right Android

Swipe a seekbar to the right.

.. deprecated:: Deprecated; prefer :meth:`swipe_from_element` / :meth:`swipe`.

:param element: The seekbar element (Image template, OCR template, or XPath).
:param event_name: The event triggering the swipe.

Input parameters:

- `element` (string, required)
- `event_name`
- `session_id` (string, required)

### `swipe_until_element_appears` (~108 tokens)

Swipe Until Element Appears

Swipe in a specified direction until an element appears.

:param element: The target element (Image template, OCR template, or XPath).
:param direction: The swipe direction (up, down, left, right).
:param timeout: Timeout until element search is performed.
:param event_name: The event triggering the swipe.

Input parameters:

- `direction` (string, required)
- `element` (string, required)
- `event_name`
- `session_id` (string, required)
- `timeout` (string, required)

### `close_and_terminate_app` (~83 tokens)

Close And Terminate App

Tears down the active driver session and flushes all pending events.

Behaviour depends on the configured driver: WebDriver-based drivers
(Appium, Selenium) call quit(); Playwright closes the page, context,
and browser; BLE closes the serial port. All variants flush pending
EventSDK events and release the driver reference.

Input parameters:

- `session_id` (string, required)

### `force_terminate_app` (~66 tokens)

Force Terminate App

Forcefully terminates the specified application.

:param app_name: The name of the application to terminate.
:param event_name: The event triggering the forced termination, if any.

Input parameters:

- `app_name` (string, required)
- `event_name`
- `session_id` (string, required)

### `get_app_version` (~64 tokens)

Get App Version

Gets the version of the application.

:param app_package: The app package/bundle ID to check, or the current app if None.
:return: The version of the application, or None if not available.

Input parameters:

- `app_package`
- `session_id` (string, required)

### `get_driver_session_id` (~28 tokens)

Get Driver Session Id

Return the current driver session id, if available.

Input parameters:

- `session_id` (string, required)

### `initialise_setup` (~72 tokens)

Initialise Setup

Sets up the environment for the driver module.

This method should be called before performing any application
management operations.

Not exposed on the Optics SDK because it currently performs no operation and doesn't
delegate to the driver's own initialise_setup (e.g. AppiumDriver.initialise_setup).

Input parameters:

- `session_id` (string, required)

### `launch_app` (~86 tokens)

Launch App

Launches the specified application.

:param app_identifier: The app identifier (package name for Android, bundle ID for iOS).
:param app_activity: The app activity to launch (Android only).
:param event_name: The event triggering the app launch, if any.

Input parameters:

- `app_activity`
- `app_identifier`
- `event_name`
- `session_id` (string, required)

### `launch_other_app` (~60 tokens)

Launch Other App

Starts another application.

:param app_name: The package name of the application.
:param event_name: The event triggering the app start, if any.

Input parameters:

- `app_name` (string, required)
- `event_name`
- `session_id` (string, required)

### `start_appium_session` (~44 tokens)

Start Appium Session

Starts an Appium session.

:param event_name: The event triggering the session start, if any.

Input parameters:

- `event_name`
- `session_id` (string, required)

### `assert_equality` (~118 tokens)

Assert Equality

Compares two values for equality. Both values are resolved from session
elements if they are ``${variable}`` references before comparison.

:param output: The actual value or ``${variable}`` reference.
:param expression: The expected value or ``${variable}`` reference.
:param event_name: The name of the event associated with the comparison, if any.
:return: True if equal, False otherwise.

Input parameters:

- `event_name`
- `expression` (string, required)
- `output` (string, required)
- `session_id` (string, required)

### `assert_presence` (~186 tokens)

Assert Presence

Asserts the presence of elements -- anywhere in the page/DOM, visible or not.

:param elements: Comma-separated string of elements to check (Image templates, OCR templates, or XPaths).
:param timeout_str: The time to wait for the elements in seconds.
:param rule: The rule for verification ("any" or "all").
:param event_name: The name of the event associated with the assertion, if any.
:param fail: If True, raise on failure; if False, return False instead. A suite writes
    this as text, and ``False`` is read case-insensitively.
:return: True if the rule is satisfied, False otherwise.

Input parameters:

- `elements` (string, required)
- `event_name`
- `fail` (string)
- `rule` (string)
- `session_id` (string, required)
- `timeout_str` (string)

### `assert_visibility` (~224 tokens)

Assert Visibility

Asserts that elements are actually rendered/visible on screen right now -- distinct
from :meth:`assert_presence`, which reports found even for elements that exist in
the page/DOM but are off-screen (e.g. not yet scrolled into view).

:param elements: Comma-separated string of elements to check (Image templates, OCR templates, or XPaths).
:param timeout_str: The time to wait for the elements to become visible, in seconds.
:param rule: The rule for verification ("any" or "all").
:param event_name: The name of the event associated with the assertion, if any.
:param fail: If True, raise on failure; if False, return False instead. A suite writes
    this as text, and ``False`` is read case-insensitively.
:return: True if the rule is satisfied, False otherwise.

Input parameters:

- `elements` (string, required)
- `event_name`
- `fail` (string)
- `rule` (string)
- `session_id` (string, required)
- `timeout_str` (string)

### `get_interactive_elements` (~221 tokens)

Get Interactive Elements

Retrieves a list of interactive elements on the current screen.

XPath and text fields are converted to one-line, CSV-friendly form (newlines
as \n, tabs as \t, etc.) so output can be pasted into elements.csv or similar.
On Appium sources, element bounds are returned in the screenshot's pixel space.

:param filter_config: Optional list of filter types (e.g., ["buttons", "inputs"]).
:param compact: When True, return only actionable elements (labels folded in,
    with an ``act`` list) plus standalone visible text (``act: []``), as
    ``{i, label, cls, bounds:[x1,y1,x2,y2], act, rid?, loc?}`` (``loc``: a unique web
    locator). Implemented by the Appium and Playwright page sources; sources without it return their full list.
:return: A list of interactive elements.

Input parameters:

- `compact` (string)
- `filter_config`
- `session_id` (string, required)

### `is_element` (~131 tokens)

Is Element

Checks if the specified element is in a given state (e.g., Enabled/Disabled/Visible/Invisible).

:param element: The element to be checked (Image template, OCR template, or XPath).
:param element_state: The state to verify (visible, invisible, enabled, disabled).
:param timeout: The time to wait for the element in seconds.
:param event_name: The name of the event associated with the check, if any.

Input parameters:

- `element` (string, required)
- `element_state` (string, required)
- `event_name`
- `session_id` (string, required)
- `timeout` (string, required)

### `validate_element` (~111 tokens)

Validate Element

Verifies the specified element.

:param element: The element to be verified (Image template, OCR template, or XPath).
:param timeout: The time to wait for verification in seconds.
:param rule: The rule used for verification ("all" or "any").
:param event_name: The name of the event associated with the verification, if any.

Input parameters:

- `element` (string, required)
- `event_name`
- `rule` (string)
- `session_id` (string, required)
- `timeout` (string)

### `validate_screen` (~118 tokens)

Validate Screen

Verifies the specified screen by checking element presence.

:param elements: Comma-separated string of elements to verify (Image templates, OCR templates, or XPaths).
:param timeout: The time to wait for verification in seconds.
:param rule: The rule for verification ("any" or "all").
:param event_name: The name of the event associated with the verification, if any.

Input parameters:

- `elements` (string, required)
- `event_name`
- `rule` (string)
- `session_id` (string, required)
- `timeout` (string)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/org-optics-framework-optics/optics-framework#diagnostics

## Score history

- 2026-11-05: 39
- 2026-11-04: 39
- 2026-11-03: 39
- 2026-11-02: 39
- 2026-11-01: 39
- 2026-10-31: 39
- 2026-10-30: 39
- 2026-10-29: 39
- 2026-10-28: 39
- 2026-10-27: 39
- 2026-10-26: 39
- 2026-10-25: 39
- 2026-10-24: 39
- 2026-10-23: 39
- 2026-10-22: 39
- 2026-10-21: 39
- 2026-10-20: 36

## Common questions

### What is the Optics MCP server?

Optics is an MCP server listed in the public MCP registry as org.optics-framework/optics. Drive Android, iOS, smart TV and web apps from an agent; save the steps as CSV/YAML test suites. This page covers its MCPB bundle (https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb).

### Is the Optics MCP server safe to use?

Optics scores 39 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Optics MCP server expose?

Optics exposes 41 tools: start_session, terminate_session, screenshot, clear_element_text, detect_and_press, and 36 more. Their descriptions and schemas cost roughly 5,831 tokens of context every time the server is loaded.

### What licence is the Optics MCP server under?

Optics declares the Apache-2.0 licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- Repository: https://github.com/mozarkai/optics-agent-plugins
- Website: https://optics-framework.org/
- Changelog RSS feed: https://verifymcp.io/servers/org-optics-framework-optics/optics-framework.xml
- Changelog JSON feed: https://verifymcp.io/servers/org-optics-framework-optics/optics-framework.json
- HTML version of this page: https://verifymcp.io/servers/org-optics-framework-optics/optics-framework