# Mobilerun

> Lets your agent control phones on Mobilerun Cloud: read the screen, tap and type, run multi-step tasks and build automated flows.

Mobilerun's hosted MCP server connects your agent to Mobilerun Cloud, Droidrun's service that gives AI agents real phones: hosted Android phones, dedicated iPhones or your own devices. Your agent can look at a phone's screen, work its apps, hand whole tasks to Mobilerun's own agent and set up flows that run on a schedule or a trigger.

What you can do with it
- List your devices, start new cloud phones and shut them down
- Take screenshots and read a device's UI state, then tap, swipe and type
- Install and manage apps, and change device files, settings and eSIMs
- Run agent tasks on a device, follow their progress, message them and stop them
- Build workflows from actions, triggers and flows, and manage webhooks
- Work with stored credentials, phone numbers and SMS, mailboxes and proxies
- Chat with the Mobilerun Assistant and answer its questions and approval requests

How it connects
The install steps here use Mobilerun's API-key address, https://api.mobilerun.ai/v1/mcp, with an Authorization: Bearer header holding a Mobilerun API key (dr_sk_...) that you create in Mobilerun Cloud. To sign in with your Mobilerun account instead, connect to https://cloud.mobilerun.ai/api/mcp, and your agent opens a browser sign-in the first time. Mobilerun documents setup for Claude, Claude Code, Codex CLI, Cursor and VS Code.

Good to know
- Some tools cost money: new devices, proxy purchases and work the assistant does are charged to the account behind the key or sign-in.
- The assistant acts with your account's full authority, so only approve its requests when you mean to.
- Which tools you get depends on your account's permissions.
- The MCP server is open source (droidrun/mobilerun-mcp) and can be self-hosted.

- Type: Plugin
- Made by: droidrun
- Category: AI & agents
- Formats: Remote MCP
- Version: 1.0.0
- Website: https://mobilerun.ai
- Source: https://github.com/droidrun/mobilerun
- Page: https://pluginboard.ai/plugins/mobilerun

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

You'll need:

- `Authorization` (required): Bearer token — Mobilerun API key (dr_sk_...), from the app under AI & Agents.

Replace each `<NAME>` placeholder with your own value.

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://api.mobilerun.ai/v1/mcp under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://api.mobilerun.ai/v1/mcp

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://api.mobilerun.ai/v1/mcp. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://api.mobilerun.ai/v1/mcp". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://api.mobilerun.ai/v1/mcp and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22mobilerun%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.mobilerun.ai%2Fv1%2Fmcp%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http --header 'Authorization: <Authorization>' mobilerun https://api.mobilerun.ai/v1/mcp
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=mobilerun&config=eyJ1cmwiOiJodHRwczovL2FwaS5tb2JpbGVydW4uYWkvdjEvbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiPEF1dGhvcml6YXRpb24%2BIn19

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "mobilerun": {
      "url": "https://api.mobilerun.ai/v1/mcp",
      "headers": {
        "Authorization": "<Authorization>"
      }
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add --transport http --header 'Authorization: <Authorization>' mobilerun https://api.mobilerun.ai/v1/mcp
```

### Codex

Run in your terminal:

```shell
codex mcp add mobilerun --url https://api.mobilerun.ai/v1/mcp
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "mobilerun": {
      "url": "https://api.mobilerun.ai/v1/mcp",
      "headers": {
        "Authorization": "<Authorization>"
      }
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add --transport http --header 'Authorization: <Authorization>' mobilerun https://api.mobilerun.ai/v1/mcp
```

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://api.mobilerun.ai/v1/mcp (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add mobilerun --url https://api.mobilerun.ai/v1/mcp --transport streamable-http
```

If it needs a key or sign-in: For https://api.mobilerun.ai/v1/mcp, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login mobilerun.

### OpenCode

Run in your terminal:

```shell
opencode mcp add mobilerun --url https://api.mobilerun.ai/v1/mcp
```

If it needs a key: For https://api.mobilerun.ai/v1/mcp, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add mobilerun --url https://api.mobilerun.ai/v1/mcp
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "mobilerun": {
      "url": "https://api.mobilerun.ai/v1/mcp",
      "headers": {
        "Authorization": "<Authorization>"
      }
    }
  }
}
```

If it signs in with OAuth: If https://api.mobilerun.ai/v1/mcp asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).