# Claude connector

**0bull Phone Control** lets Claude see and operate the real iPhones you rent on 0bull. Claude
can take a screenshot, read the text on screen, tap, swipe and type, send device commands,
replay macros you recorded, and hand a task to the on-phone AI agent.

The connector is served at:

```
https://0bull.net/mcp/phone
```

It is a smaller server than the full [0bull Phone Farm](/mcp/overview) server at
`https://0bull.net/mcp`. It only controls phones. It has no billing, posting accounts,
video publishing or automations.

## Before you start

- A [0bull.net](https://0bull.net) account.
- At least one phone on that account. [Rent one](https://0bull.net/pricing) or ask a team
  owner to share one with you.
- The phone must be online. `list-phones-tool` shows `video_live: true` for a phone Claude
  can use.

## Connect it in Claude

1. In Claude, open **Settings → Connectors** and find **0bull Phone Control** in the
   directory. If it is not there yet, choose **Add custom connector**, name it
   `0bull Phone Control` and paste `https://0bull.net/mcp/phone`.
2. Choose **Connect**. A 0bull window opens.
3. Log in with your 0bull account and choose **Authorize**.

There is no API key to copy. Claude only sees the phones your own account can reach.

In Claude Code:

```bash
claude mcp add --transport http 0bull-phone https://0bull.net/mcp/phone
```

Then run `/mcp`, pick `0bull-phone` and authenticate in the browser.

## Tools

| Tool | Title | What it does |
|---|---|---|
| `list-phones-tool` | List phones | Your phones, with the `slot` id every other tool takes, whether each is live, and whether you may control it. |
| `phone-snapshot-tool` | Take phone screenshot | A JPEG of the phone screen right now. |
| `phone-ocr-tool` | Read phone screen text | The text on screen, cheaper than an image when you only need words. |
| `phone-control-tool` | Tap, swipe or type on a phone | One input: tap, swipe, a key such as home or back, or typed text. |
| `phone-command-tool` | Send phone command | Clipboard, open a URL or deep link, brightness, Wi-Fi, airplane mode, cellular, flashlight, clear the camera roll, read the LAN IP. |
| `list-macros-tool` | List macros | The macros you recorded in 0bull. |
| `run-macro-tool` | Run macro | Replays a macro exactly as recorded, on one phone. |
| `run-phone-agent-tool` | Run phone agent task | Gives the on-phone AI agent one task in plain words. |
| `list-phone-runs-tool` | List phone runs | Recent commands, macros and agent tasks on a phone, with their status. |
| `get-phone-run-tool` | Get phone run | One run's status, result or error. |

The screenshot, screen text and list tools only read. Claude can run them without asking.
Every tool that acts on a phone is marked destructive, so Claude asks you before each call.
Some actions cannot be undone, such as clearing the camera roll or sending a message in an
app.

Commands, macros and agent tasks run in the background. The call returns a run id at once,
and Claude checks `get-phone-run-tool` until the run finishes. Taps, swipes, typing,
screenshots and screen text return straight away.

## Example prompts

- "Show me what's on my 0bull phone right now."
- "On my iPhone, open Settings and turn on Wi-Fi, then take a screenshot so I can check."
- "Open https://example.com in Safari on my phone and read me the headline."
- "List my macros, run the first one on my phone and tell me when it finishes."
- "Ask the phone agent to open the App Store and check for updates, then show me the result."
- "Copy this text to my phone's clipboard: meet at 6pm."

## Troubleshooting

- **"No phones" or an empty list.** Your account has no phone yet, or the phone you rented
  has not been assigned. Check your [dashboard](https://0bull.net/dashboard).
- **`video_live: false`.** The phone is offline or restarting. Wait a minute and ask again.
  If it stays offline, contact support.
- **`can_control: false`.** Someone shared the phone with you as view-only. Claude can take
  screenshots and read the screen but cannot tap or run anything.
- **A macro or agent task failed.** Ask Claude for the run's `error`, or take a screenshot.
  Macros replay exact taps, so they fail when the screen is not where the recording started.
- **Claude asks you to sign in again.** Your authorization expired or was revoked. Choose
  **Connect** again in **Settings → Connectors**.

## Data and privacy

Screenshots and screen text are read live from the phone and sent to Claude. The connector
does not save them. Commands, macros and agent tasks are kept in the phone's run history with
their status and result, so you can check them later in 0bull. See the
[privacy policy](https://0bull.net/privacy) and [terms](https://0bull.net/terms).

## Support

Email [support@0bull.net](mailto:support@0bull.net). Report security issues to the same
address.
