Overview
Your phones, run from code and AI agents: what ran, what it cost, and how to start.
Get started
Read the quickstart →Limits & pricing
Tiers
credits per stepA step is one action on the phone. A task costs steps × its tier's rate; one cancelled before it starts costs nothing.
API keys
Keys act as your account on your own phones, over REST and MCP. Send one as Authorization: Bearer om_live_…, keep it in an environment variable, and never commit it.
New API key
Your keys 0
Up to 20 keys| Name | Key | Scopes | Created | Last used | Risky actions | Max mode | Status | Actions |
|---|---|---|---|---|---|---|---|---|
| Loading… | ||||||||
Sessions
Every task your keys and AI agents ran, newest first. Open one for its full timeline.
| Status | Instruction | Phone | Key | Tier | Steps | Credits | Duration | Started |
|---|---|---|---|---|---|---|---|---|
| Loading… | ||||||||
Webhooks
Get a signed POST when a task finishes or needs you, instead of polling.
Endpoint
Not setMust be a public https:// URL. Saving it again makes a new signing secret.
Events
task.finished- succeeded, failed or cancelled
task.needs_input- asked a question
task.needs_confirmation- waiting for approval
orchestration.finished- a multi-phone run ended
The body is {"type", "created", "task"}, where task is the same object as GET /v1/tasks/{id}; for orchestration.finished it has orchestration (as GET /v1/orchestrations/{id}) instead of task, so check type first. Failed deliveries are retried for about an hour with the same X-OpenMob-Delivery id, so drop ids you've seen. Answer 2xx fast, then do the work.
Verify the signature
Each request carries X-OpenMob-Signature: t=…,v1=…: the hex HMAC-SHA256 of "{t}.{raw body}" with your signing secret. Reject a t older than 5 minutes.
Full details: Webhooks docs.
Logs
Your account's audit log: every key change, task, answer, screenshot and setting. Instructions are never stored here, only what happened.
| Time | Action | Key | Phone | Task | Outcome |
|---|---|---|---|---|---|
| Loading… | |||||
Connect an AI agent
OpenMob is an MCP server. Any MCP client can run tasks on your phone with one of your keys, under the same scopes, limits and audit log as the REST API.
Server URL
Streamable HTTP · statelessOPENMOB_API_KEY. Create a key, then export OPENMOB_API_KEY=om_live_… in your shell.Settings
What API and MCP tasks may do on your phones.
Safety
Account
- Signed in as
- —
- API access
- —
- REST base URL