> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobilerun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Examples

> Pick a use case. Each one starts small and builds up from there.

> [card] [Read app data as JSON](https://docs.mobilerun.ai/examples/extract-data.md)
>
> Turn what a phone shows into structured data.

> [card] [Same app, different markets](https://docs.mobilerun.ai/examples/markets.md)
>
> See what an app shows in another country.

> [card] [Test a flow and keep proof](https://docs.mobilerun.ai/examples/test-and-prove.md)
>
> Run a test and keep video and screenshots.

> [card] [Drive the phone step by step](https://docs.mobilerun.ai/examples/drive-the-phone.md)
>
> Read the screen and tap from your own code.

> [card] [Watch an app and get alerts](https://docs.mobilerun.ai/examples/watch-and-alert.md)
>
> Get notified when something changes.

> [card] [Automate your own phone](https://docs.mobilerun.ai/examples/personal-phone.md)
>
> Briefings and approved actions on your phone.

> [card] [Finish a sign-up that sends a code](https://docs.mobilerun.ai/examples/sign-up-codes.md)
>
> Read email and SMS codes during a sign-up.

> [card] [Your work phone in the browser](https://docs.mobilerun.ai/examples/stream-phone.md)
>
> Watch and control a phone from your browser.

## Before you start

1. Create a key on the [API Keys](https://docs.mobilerun.ai/api-keys.md) page and `export MOBILERUN_API_KEY=...`.
2. Install `pip install mobilerun-sdk` or `npm install @mobilerun/sdk`, or connect the [MCP server](https://docs.mobilerun.ai/mcp-server.md).
3. Have a ready phone. Start a Cloud Android phone in the [dashboard](https://cloud.mobilerun.ai), or connect [your own phone](https://docs.mobilerun.ai/device-types.md#personal-phone). Stop cloud phones when you're done.

> [!TIP]
>
> Each example includes a multi-phone version, whether that's running tasks in parallel, comparing markets, or streaming a grid of phones.

## Phones and add-ons

Run the examples on our phones or yours, and add what a use case needs.

> [card] [Cloud Android](https://docs.mobilerun.ai/device-types.md)
>
> Pay per minute or a dedicated phone. Stop and resume keeps apps and logins.

> [card] [Cloud iOS](https://docs.mobilerun.ai/device-types.md)
>
> A dedicated real iPhone, or a virtual iPhone billed per minute.

> [card] [Your own phone](https://docs.mobilerun.ai/guides/connect-android.md)
>
> Connect your own Android phone to Mobilerun.

> [card] [Proxies and countries](https://docs.mobilerun.ai/proxies.md)
>
> Residential IPs and GPS for other countries.

> [card] [Mailboxes and numbers](https://docs.mobilerun.ai/examples/sign-up-codes.md)
>
> Receive email and SMS codes during a flow.

> [card] [Live stream in your app](https://docs.mobilerun.ai/guides/embed-device-stream.md)
>
> Show a phone to your users and let them take over.

> [accordion] Advanced
>
> * **Many phones at once:** examples include multi-phone variants. See [Devices](https://docs.mobilerun.ai/devices.md).
> * **Logins:** store app logins in [Credentials](https://docs.mobilerun.ai/credentials.md) and attach them to tasks. Never put passwords in prompts.
> * **Your own apps:** upload your APK to the [app library](https://docs.mobilerun.ai/apps.md) and install it on any Cloud Android phone.
> * **Events instead of polling:** [Webhooks](https://docs.mobilerun.ai/webhooks.md) send `task.run.completed` and `task.run.failed` to your backend.
> * **Browser control:** drive Chrome on the phone with Puppeteer or Playwright, see [Browser automation](https://docs.mobilerun.ai/browser-automation.md).
> * **Traffic inspection:** see an app's HTTP and WebSocket traffic while you walk its screens, see [Network inspection](https://docs.mobilerun.ai/integrations/network-inspection.md).

> [accordion] For AI assistants
>
> 1. Ask what the user wants to build and match it to an example above. Start at Level 1.
> 2. Use MCP if it's connected; otherwise write SDK code.
> 3. List phones and capabilities first. Ask before creating phones, proxies, mailboxes, numbers or webhooks, and never approve a purchase.
> 4. Report the result, the steps, and anything that failed.
>
> Never put passwords in prompts. Use [Credentials](https://docs.mobilerun.ai/credentials.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.