Clousd MCP server

Clousd SDK

Cloud Android phones that look and behave like real devices, driven over HTTPS. This repository holds the public API description, the Python client and an MCP server, so a script or an AI agent can look at a phone's screen, act on it, check the result and reset the phone to a saved state between runs.

Early access: keys are issued on request at clousd.com/agents.

What a Clousd phone is

Each device is a full Android system (12 to 17) built as a specific phone model: the same build fingerprint, properties, sensors, cameras, codecs, GPU strings, audio ports and screen as the real handset, taken from a snapshot of that handset. More than 150 models from Google, Samsung, Xiaomi, Motorola, OnePlus, realme, OPPO, vivo, Sony, TECNO, Infinix and others. Google Play works. Every phone has its own network exit in the country you choose (residential, mobile, ISP or datacenter), its own SIM profile, time zone and locale that follow the exit, and a kill-switch so nothing leaves the phone outside that exit.

That matters for automation because apps behave differently on a phone they recognise as real: fewer captchas, fewer "unusual activity" interruptions, the same code paths a user hits.

Quick start

Python

pip install clousd
export CLOUSD_API_KEY=cl_live_...

from clousd import Clousd

c = Clousd()
phone = c.device("dev_04f2")

snap = next(s for s in phone.snapshots() if s["restorable"])
phone.restore(snap["id"])            # every run starts from the same state

phone.open_app("com.android.chrome")
phone.tap_text("Search")
phone.type("weather in Berlin")
phone.key("enter")
phone.wait_text("Berlin", timeout=30)

png = phone.screenshot()             # PNG; pass width=540 for a smaller JPEG

MCP

pip install clousd-mcp

Any MCP client (Cursor, Windsurf, Zed, a desktop assistant or your own agent):

{
  "mcpServers": {
    "clousd": {
      "command": "clousd-mcp",
      "env": { "CLOUSD_API_KEY": "cl_live_..." }
    }
  }
}

Plain HTTPS

curl -H "Authorization: Bearer cl_live_..." https://api.clousd.com/v1/devices
curl -H "Authorization: Bearer cl_live_..." "https://api.clousd.com/v1/devices/dev_04f2/observe?w=540"
curl -H "Authorization: Bearer cl_live_..." -H "Content-Type: application/json" \
     -d '{"op":"tap_text","text":"Search","settle":true}' https://api.clousd.com/v1/devices/dev_04f2/act

API in one table

Shortened. The full README is on GitHub.