> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revyl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugin

> Run, verify, and test mobile apps on real cloud iOS and Android devices from Cursor

Run, verify, and test mobile apps on live cloud iOS and Android devices from
Cursor. The plugin bundles Revyl's focused MCP tools, development skills,
routing rule, and a pinned Revyl runtime bootstrap.

## What the plugin adds

* **MCP server and Skills**: Focused setup, dev-loop, and device tools with streamed
  progress, screenshots, grounding, and structured outcomes.
* **Rules**: routes mobile run, preview, and verification requests to Revyl.
* **Runtime bootstrap**: downloads and pins a published Revyl CLI runtime when
  the plugin starts MCP. See
  [how the Marketplace plugin runtime will work](/cli/mcp-setup#how-the-marketplace-plugin-runtime-will-work)
  for the verification and caching details.

## Setup

### 1. Install plugin

In Cursor, install a [new plugin](https://cursor.com/docs/plugins) by navigating to the [Revyl Marketplace Plugin](https://cursor.com/marketplace/revyl) and selecting `Add to Cursor`.

### 2. Set authentication

In Revyl, create a new [API key](https://docs.revyl.com/cli/authentication#getting-an-api-key). The Cursor plugin will use this API key to communicate with Revyl.

For Cursor Cloud Agents: Navigate to Cursor and create a new [Runtime Secret](https://cursor.com/docs/cloud-agent/security-network) called `REVYL_API_KEY` with the API Key.

For Cursor local Agents: include `REVYL_API_KEY` as an environment variable in your local shell so that it is accessible by the agent.

### 3. Allow network traffic

Cursor cloud agents need to be able to communicate with Revyl servers. Depending on the Cursor [Network Access Mode](https://cursor.com/docs/cloud-agent/security-network#access-modes), the following domains need to be allowlisted:

* revyl.com
* \*.revyl.com
* revyl.ai
* \*.revyl.ai

### 4. Verify

After installing the plugin or completing the current CLI-based MCP setup, start a new Cursor Agent chat and ask: **"is the Revyl plugin installed, authenticated, and ready?"** The agent should confirm that everything is set up

### 5. Start using Revyl

Ask Cursor Agent chat ask: **"Run this app on a Revyl device"** and Cursor will start a Revyl device session.