Mobitru MCP Server

Give your AI agent a real phone or browser. Mobitru MCP Server lets agents (Claude, Cursor, VS Code, GitHub Copilot) drive real iOS/Android devices and web browsers in the Mobitru cloud — booking a device, installing a build, tapping through a flow, and reading back structured accessibility snapshots.

Ships as two servers:

• mobile — native iOS/Android automation (device booking, app install, tap/swipe, Appium, Espresso/XCUITest, recording, network throttling, logs)
• playwright — web browser automation (navigation, snapshots, screenshots, keyboard input, network interception)

What you can do

• 🚀 Book real iOS/Android devices — no local device lab
• 🤖 Drive apps via accessibility snapshots (no computer-vision model needed), with screenshot fallback when snapshot data is unavailable
• 📱 Install and exercise APK/IPA builds
• 🌐 Automate web browsers with Playwright
• 🧪 Run Appium, Espresso, XCUITest and Playwright tests on cloud infrastructure
• 📹 Capture screen recordings, device logs, and HTTP traffic (HAR)
• 📡 Simulate network throttling, GPS, and IP geolocation
• ♿ Inspect accessibility — screen-reader traversal, platform audits, and a11y settings
• 🧿 Extract structured data from anything on screen

Prerequisites

An approved Mobitru account (account creation is reviewed — it is not instant signup), then two credentials:

| Credential | Where to get it | |---|---| | DEVICE_FARM_API_KEY | Account menu → User Settings → + Access key. Copy it immediately — it is shown only once. | | DEVICE_FARM_SLUG | Your billing-unit identifier, shown as a chip next to your account icon in the top bar (e.g. acme-42). |

Quickstart

Set credentials first (see Configuration for the full list), then register the server:

export DEVICE_FARM_BASE_URL=app.mobitru.com
export DEVICE_FARM_BROWSER_HUB_BASE_URL=https://browserhub-us.mobitru.com
export DEVICE_FARM_API_KEY=your_access_key
export DEVICE_FARM_SLUG=your_slug

# Mobile — then ask: "Book an Android device and open the settings app."
claude mcp add mobitru-mobile -- npx -y mobitru-mcp-server mobile

# Playwright — then ask: "Open example.com and screenshot the page."
claude mcp add mobitru-playwright -- npx -y mobitru-mcp-server playwright

In Cursor / VS Code / Copilot, pass the same variables under env in your mcpServers entry.

Configuration

Credentials come from environment variables, or from a config file at ~/.mobitru-mcp/api-config.json. Environment variables take precedence.

| Variable | Required | Description | |---|---|---| | DEVICE_FARM_BASE_URL | yes | API host, hostname only, no https:// (e.g. app.mobitru.com) | | DEVICE_FARM_BROWSER_HUB_BASE_URL | yes | Browser hub URL (e.g. https://browserhub-us.mobitru.com) | | DEVICE_FARM_API_KEY | yes | Your access key | | DEVICE_FARM_SLUG | yes | Your billing-unit slug | | DEVICE_FARM_WID | no | Workspace id (default 0) |

File alternative — ~/.mobitru-mcp/api-config.json:

{
  "baseUrl": "app.mobitru.com",
  "browserHubBaseUrl": "https://browserhub-us.mobitru.com",
  "apiKey": "your_access_key",
  "slug": "your_slug"
}

Troubleshooting

If tools fail or the agent says the server isn't configured, credentials are missing or incomplete — all four variables above are required, and a partial set is rejected. Configuration errors (missing keys, invalid JSON, a https:// prefix on DEVICE_FARM_BASE_URL) are reported with a message that names the problem.

Links

• Documentation: https://mobitru.com/docs/
• Access keys: https://mobitru.com/docs/access-key/

This is a Model Context Protocol server. It lets agents and LLMs interact with native iOS/Android apps, desktop browsers, and mobile devices through structured accessibility snapshots or coordinate-based taps.