clousd-mcp

An MCP server that gives any MCP-capable agent a real Android phone in the cloud: a device modelled on a real phone, with Google Play, a network in the country you choose, and saved states to reset to between runs.

Early access: ask for a key at clousd.com/agents.

Install

pip install clousd-mcp

Any MCP client (Cursor, Windsurf, Zed, a desktop assistant or your own agent) - stdio server, one environment variable:

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

Clients that take a command line instead of JSON: clousd-mcp with CLOUSD_API_KEY in the environment.

Remote server (no install)

The same server runs at https://api.clousd.com/mcp (streamable HTTP). Point any MCP client at it with your key in the Authorization header; clients that cannot set headers can pass ?api_key=cl_live_... in the URL.

{
  "mcpServers": {
    "clousd": {
      "url": "https://api.clousd.com/mcp",
      "headers": { "Authorization": "Bearer cl_live_..." }
    }
  }
}

Self-hosting the remote mode: CLOUSD_MCP_HTTP=127.0.0.1:8790 clousd-mcp serves /mcp over HTTP; every request must carry a key, nothing is read from the environment.

Tools

Four tools, on purpose - agents choose better from a few large tools than from a dozen small ones:

Screenshots come back 540 px wide (CLOUSD_SHOT_WIDTH to change); tap and swipe take coordinates in that image and the server scales them to the phone. tap_text is usually the more reliable way to press a button. Typing works in any language.

Built on the clousd Python client. MIT license.

mcp-name: io.github.Clousd-Android/clousd-mcp