Models
The Dopl plugin in Even Hub, Even's official plugin runtime
A Dopl app on MentraOS
Not supported yetRokid · XREAL · Vuzix · Brilliant Labs · INMO
| Capability | Even Realities G2 | Mentra |
|---|---|---|
ask.choice | Live | Coming soon |
presence.read | Live | Coming soon |
input.utterance | Coming soon | Coming soon |
input.tap | Coming soon | Coming soon |
present.display | Live | Coming soon |
present.notify | Live | Coming 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.choiceT1The 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.askwaits up to 200 seconds, then returnstimeoutand you can keep reading the action. - A dismissed question completes with
dismissed: trueand no label.
- The question stays on the lens for 10 minutes.
- 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.readT0Whether the glasses are connected and when they were last seen. Check it before sending something time sensitive.
- Limits
onlineuses 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.utteranceT1What 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_messagein Get context staysnull.
- Not recorded for API end users yet, so
- 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.tapT1Touchpad 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.displayT1A 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_showwith the samecard_idorglasses_updatereplaces 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.choiceT1A 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.notifyT1A 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