Allows agents to lease and interact with Android emulators from a shared pool, providing exclusive bounded access to running emulator instances and the ability to release or observe sessions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@emulator-hub lease an Android emulator for 30 minutes and run my instrumented tests"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A lease-based pool of self-hosted Android emulators for agents and humans.
Check out a phone, tablet, or TV over MCP or HTTP, use it exclusively for a bounded lease, then release it back to the pool.
Related MCP server: Emulator MCP Server
Berth runs on Kubernetes: the hub server starts one emulator Pod per lease.
docker pull ghcr.io/noahchalifour/emulator-hub:v0.1.1Deployment manifests live in home-lab-infrastructure. Set HUB_API_TOKEN, HUB_EMULATOR_IMAGE, and HUB_SLOT_IPS on the hub.
Point an MCP client at the machine port (8081) and let the agent lease a device:
claude mcp add --transport http berth http://localhost:8081/mcp \
--header "Authorization: Bearer $HUB_API_TOKEN"Ask the agent to call acquire with a profile such as phone. The grant returns the lease id, the adb address to adb connect to, and expires_at. Call release when you finish, or let the lease expire.
MCP tools: list_profiles, acquire, heartbeat, release, and status over streamable HTTP at /mcp.
Bounded leases: Each lease has a TTL, extends with heartbeat, and hits a hard stop after four hours.
REST API: Manage leases and profiles at /api/leases and /api/profiles.
Metrics: Scrape Prometheus metrics at /metrics and probe /healthz.
Watch any active session in the browser and take over with touch, keyboard, and the Back, Home, Recents, volume, and power buttons.
Form factors: Phone, tablet, and Android TV profiles ship by default.
Editable profiles: Choose the system image, device, RAM (1024 to 4096 MB), and cores (1 to 4) per profile.
Lease history: Review the last 100 leases with holder, duration, and how each ended.
android-tv images only trust the key the emulator pushes at boot. Give the hub one key pair for every emulator:
adb keygen adbkey
kubectl -n emulator-hub create secret generic emulator-hub-adb-key \
--from-file=adbkey --from-file=adbkey.pubMount the Secret into the hub and set HUB_ADB_KEY_DIR to the mount path. Agents fetch the key from GET /adbkey on the machine port. Anyone with the API token can then reach any leased device over adb.
MIT. See CONTRIBUTING.md to develop or run the tests.
This server cannot be deployed
Disposable cloud Android emulators for coding agents: run an APK or PR build, tap, type, screenshot.
Cloud iOS simulators and Android emulators your agent can create, drive, and throw away.
Hosted AgentLux MCP server for marketplace, identity, creator, services, and social flows.
Hosted MCP server for task-first delegation to remote workstations and workers.
