# ExecBro MCP server

> Connects an AI coding agent to a running React Native app to inspect logs, network traffic, state, and UI, and to test fixes on the device.

- Repository: https://github.com/igorzheludkov/execbro
- Page: https://hostedmcp.org/servers/igorzheludkov/execbro
- Transport: stdio
- Stars: 81
- Latest version: 2.25.0

## Install

### Claude Code

```sh
claude mcp add execbro -- npx -y execbro
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "execbro": {
      "command": "npx",
      "args": [
        "-y",
        "execbro"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "execbro": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "execbro"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"execbro","type":"stdio","command":"npx","args":["-y","execbro"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "execbro": {
      "command": "npx",
      "args": [
        "-y",
        "execbro"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add execbro -- npx -y execbro
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.execbro]
command = "npx"
args = ["-y", "execbro"]
```

### Gemini CLI

```sh
gemini mcp add -s user execbro npx -- -y execbro
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "execbro": {
      "command": "npx",
      "args": [
        "-y",
        "execbro"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `EXECBRO_API_URL` | no | no | Override the license/account API base URL. Defaults to the production endpoint. |

## Tools (11)

- `scan_metro`
- `get_network_requests`
- `get_timeline`
- `get_screen_state`
- `get_screen_layout`
- `tap`
- `pinch`
- `input_text`
- `dismiss_keyboard`
- `execute_in_app`
- `screenshot`

## FAQ

### Does ExecBro require changes to my React Native app?

No. It works with zero config and no SDK or code changes to get started, though installing the optional SDK is recommended for more robust log and network capture.

### Can an AI agent check network requests in my running app?

Yes, it monitors HTTP requests and responses with headers, timing, and body content, and can mock or tamper with responses.

### Does ExecBro keep secrets out of the conversation?

Yes, tool output is redacted so credentials become handles instead of raw values, and the agent can use a credential without reading it.

### Can ExecBro control iOS simulators and Android devices?

Yes, it supports screenshots, app management, booting and terminating on the iOS simulator, and screenshots, install and launch on Android.

### What do I need before asking my AI assistant to use ExecBro?

Set it up as an MCP server for your agent, start your React Native app, then ask in plain language.
