Display glasses Live

Heads up display glasses: cards, questions and notifications on the lens

Models

Even Realities G2Live

The Dopl plugin in Even Hub, Even's official plugin runtime

MentraPlanned

A Dopl app on MentraOS

Not supported yetRokid · XREAL · Vuzix · Brilliant Labs · INMO

CapabilityEven Realities G2Mentra
ask.choiceLiveComing soon
presence.readLiveComing soon
input.utteranceComing soonComing soon
input.tapComing soonComing soon
present.displayLiveComing soon
present.notifyLiveComing soon

Keys, connecting a user's device, permissions, routing, errors and test mode work the same for every category: see Projects, environments and keys, Connect a device, Permissions and safety, Errors and Test mode. The examples assume a dopl client and a deviceId from the Quickstart.

What your agent receives

Answers to a question

ask.choiceT1

The option the user picked on a question you sent, read from the action. Use it to branch on a decision without parsing free text.

Limits
  • The question stays on the lens for 10 minutes. dopl.ask waits up to 200 seconds, then returns timeout and you can keep reading the action.
  • A dismissed question completes with dismissed: true and no label.
Permission
Scope ask.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.

Call

// action_id from the ask.choice call you sent
const action = await dopl.actions.get(action_id);
if (action.status === "done") console.log(action.result);

Example response

{
  "action_id": "a6d1c0b2-7e45-4f19-8c3a-2b9e5d4f7a11",
  "device_id": "8b0c6f1e-3d2a-4c51-9a7e-2f4d6b1c9e30",
  "capability": "ask.choice",
  "status": "done",
  "result": {
    "lens_message_id": "b3f0c2a8-91de-4c57-a1f6-0e4d8b2c7a93",
    "index": 0,
    "label": "Yes",
    "answered_at": "2026-10-27T17:05:09Z"
  },
  "error": null,
  "created_at": "2026-10-27T17:05:00Z",
  "updated_at": "2026-10-27T17:05:09Z"
}

Supported on

  • Even Realities G2LiveAnswered from the touchpad
  • MentraComing soon

Online status

presence.readT0

Whether the glasses are connected and when they were last seen. Check it before sending something time sensitive.

Limits
  • online uses the same window as the glasses' own device list.
Permission
Scope state.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.

Call

const device = await dopl.devices.get(deviceId);
console.log(device.online, device.last_seen_at);

Example response

{
  "id": "8b0c6f1e-3d2a-4c51-9a7e-2f4d6b1c9e30",
  "kind": "glasses",
  "vendor": "even_realities",
  "model": "even_g2",
  "firmware": null,
  "adapter_id": "even_g2",
  "adapter_version": "0.1.0",
  "capabilities": [
    {
      "capability": "ask.choice",
      "limits": {
        "question_bytes": 120,
        "option_bytes": 40,
        "min_options": 2,
        "max_options": 4,
        "hold_s": 200
      },
      "latency_class": "interactive",
      "risk_tier": "T1",
      "since_adapter": "even_g2@0.1.0"
    }
  ],
  "online": true,
  "last_seen_at": "2026-10-27T17:04:58Z"
}

Supported on

  • Even Realities G2Live
  • MentraComing soon

Voice transcripts

input.utteranceT1

What the user says to the glasses, as text. Use it to let the user start or steer your agent hands free.

Limits
  • Not recorded for API end users yet, so source_of_last_message in Get context stays null.
Permission
Scope input.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.

Call

// No call returns input.utterance yet. It is planned as the `input.utterance` webhook.

Example response

// Not available yet.

Supported on

  • Even Realities G2Coming soonPublished in the G2 descriptor. Agents on the hosted MCP get it today as a message in the glasses' linked channel
  • MentraComing soon

Taps

input.tapT1

Touchpad taps outside a question, such as a tap to open your agent.

Limits
  • A tap that answers a question already arrives as that question's answer, above.
Permission
Scope input.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.

Call

// No call returns input.tap yet. The contract has no event for it yet.

Example response

// Not available yet.

Supported on

  • Even Realities G2Coming soonPublished in the G2 descriptor, not delivered to the API yet
  • MentraComing soon

What your agent can send

Show a card

present.displayT1

A screen built from display blocks: a heading, text, a list, fields. Use it for status the user glances at.

Limits
  • 576 by 248 pixels, monochrome, up to 12 blocks and 960 bytes of text.
  • ASCII and box drawing characters only: curly quotes are straightened and emoji are dropped. Image blocks are refused.
  • Stays on the lens for 10 minutes. Content that does not fit is refused with invalid_request, never shortened.
  • Updating a card in place is not in the API yet: each call shows a new card. On the hosted MCP, glasses_show with the same card_id or glasses_update replaces it live.
Permission
Scope present.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.

Call

const { action_id, status } = await dopl.devices.action(deviceId, "present.display", {
  blocks: [
    {
      id: "title",
      type: "heading",
      text: "Flight UA 212"
    },
    {
      id: "gate",
      type: "text",
      content: "Gate B14. Boards 9:40"
    }
  ]
});

Example response

{
  "action_id": "a6d1c0b2-7e45-4f19-8c3a-2b9e5d4f7a11",
  "status": "queued"
}

Supported on

  • Even Realities G2Live
  • MentraComing soon

Ask a question

ask.choiceT1

A question with options the user picks from the touchpad. Use it when your agent needs a decision before it continues.

Limits
  • Question up to 120 bytes, 2 to 4 options of up to 40 bytes each.
  • Read the answer under What your agent receives, or call dopl.ask, which sends and waits in one call.
Permission
Scope ask.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.

Call

const { action_id, status } = await dopl.devices.action(deviceId, "ask.choice", {
  question: "Book the 9:40 flight?",
  options: [
    {
      label: "Yes"
    },
    {
      label: "No"
    }
  ]
});

Example response

{
  "action_id": "a6d1c0b2-7e45-4f19-8c3a-2b9e5d4f7a11",
  "status": "queued"
}

Supported on

  • Even Realities G2Live
  • MentraComing soon

Notify

present.notifyT1

A short title and body that clears on its own. Use it for something the user should know now but need not act on.

Limits
  • Title up to 64 bytes, body up to 400 bytes, shown as up to 4 lines of 100 bytes.
  • Clears after 60 seconds.
Permission
Scope present.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.

Call

const { action_id, status } = await dopl.devices.action(deviceId, "present.notify", {
  title: "Build finished",
  body: "main passed in 4m 12s"
});

Example response

{
  "action_id": "a6d1c0b2-7e45-4f19-8c3a-2b9e5d4f7a11",
  "status": "queued"
}

Supported on

  • Even Realities G2Live
  • MentraComing soon