Ramus Android — Claude Code MCP server: cloud emulator for agents
Hands a coding agent a throwaway Android emulator in the cloud: launch an APK, tap, type, screenshot, pull logs. Useful for checking a build from the chat.
claude mcp add --transport http ramus-android https://api.ramus.dev/api/mcpWhat Ramus Android does
The server wires your agent to a real Android emulator on stock Google images, running on Ramus hardware and streamed over WebRTC. Tools come under the android_* prefix. An agent can open a session from a demo app or a pull request, grab a snapshot of the UI tree, tap a referenced element, enter text, press a key, wait, take a screenshot, read logs and share the session. You can watch the same device in a browser and take over the controls.
The bundled skill teaches the observe, act, verify loop. Snapshot the tree first, act on one element, then confirm the outcome. Skip that and the agent pokes the screen blindly. The remote server speaks Streamable HTTP, so no local process is needed; uploading a local APK and the dev loop go through the ramus-cli CLI.
A Ramus account covers it (free during alpha), or you can try the CLI for 60 minutes without signing up. The remote endpoint wants an API key from your account settings: there is no Authorization header, no access. Android only, and it is meant for apps you built or are allowed to test.
What it helps with
- walk a fresh APK build through its screens without starting an emulator by hand
- exercise a pull request build before merging
- snapshot the UI tree and locate the right element to tap
- collect screenshots and crash logs in a single run
- hand a live device session to a teammate in the browser
Example prompts for the agent
- Start an Android session from
app-debug.apk, open the login screen and send me a screenshot. - Tap the pay button, snapshot the UI tree and check whether an error message appeared.
- Open a session from the pull request, run through onboarding and pull the logs.
How to install Ramus Android
Platform CLI: remote server
claude mcp add --transport http ramus-android https://api.ramus.dev/api/mcpPlatform CLI: remote server
codex mcp add ramus-android --url https://api.ramus.dev/api/mcpConfig file
{
"mcpServers": {
"ramus-android": {
"url": "https://api.ramus.dev/api/mcp"
}
}
}Config file
{
"servers": {
"ramus-android": {
"type": "http",
"url": "https://api.ramus.dev/api/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http ramus-android https://api.ramus.dev/api/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Ramus Android
How do I install Ramus Android in Claude Code?
Add the remote server with claude mcp add --transport http ramus-android https://api.ramus.dev/api/mcp. For the skill as well, install the plugin: /plugin marketplace add ramus-dev/android-use, then /plugin install ramus@ramus.
What does Ramus Android do?
It gives an agent a cloud Android emulator where it taps, types, screenshots and reads logs. Each session is disposable and you can follow it live in a browser.
What do I need before it works?
A Ramus account, or the 60-minute CLI trial started with npx ramus-cli trial. The remote MCP server also needs an API key from account settings, sent in the Authorization header.
