Skip to main content

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.

Tools

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

Tool What it does
devices list the phones this key can use; start or stop one
observe the screen as an image plus every text on it
act tap, swipe, scroll, tap_text, wait_text, type, key, open_app, close_app, open_url, installed
snapshots list, save, restore (reset between runs) or clone a phone

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

Metadata

Release files for clousd-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for clousd-mcp 0.1.1
File Size Uploaded
clousd_mcp-0.1.1.tar.gz 5.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for clousd-mcp 0.1.1
File Interpreter ABI Platform
clousd_mcp-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 12.1 kB

Release files / clousd_mcp-0.1.1.tar.gz

Download URL clousd_mcp-0.1.1.tar.gz
Size 5.7 kB
Tags Source
SHA-256 checksum
How to use checksums
3fdc4aa977608bdc785c3be736a8939d66be6021ce086d1eff74054980b18d41
BLAKE2b-256 checksum
How to use checksums
8f573b27cdbdd3416b6872c2ae6146185372b0b096b5d57be8e5d685cfe700ac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.

Transparency log

Release files / clousd_mcp-0.1.1-py3-none-any.whl

Download URL clousd_mcp-0.1.1-py3-none-any.whl
Size 6.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
214a44c5d361b885a5bb75f4d9b068933b3d407dc2435a214aad369785eb3fc8
BLAKE2b-256 checksum
How to use checksums
05d89f5a9813525b06a3b2c428f8dd1330e0ea44fc9ee0b0696cc76b7c8db8d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.

Transparency log

Release history Release notifications | RSS feed

0.2.0

2 release files

0.1.2

2 release files

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page