mcp

# Limrun MCP Server

`https://mcp.limrun.com/mcp` is [Limrun](https://limrun.com)'s remote MCP server. Connect it
once and your agent can create cloud iOS simulators and Android emulators on demand, drive
them through screenshots and the accessibility tree, and delete them when done. Devices are
real simulators/emulators running in Limrun's cloud, not mocks.

> This repository is the listing home for the server. The server is a hosted, remote
> streamable-HTTP MCP server; there is nothing to install from here.

## What it does

- **Create and manage devices**: `create-ios-simulator`, `create-android-emulator`,
  `list-instances`, `get-instance-status`, `delete-instance` (instances also
  self-terminate on inactivity).
- **Drive iOS**: `ios-use` (tap, type, scroll, action chains), `ios-app` (list/launch/
  terminate apps), `ios-open-url`, `ios-logs`, `ios-screenshot-and-element-tree`.
- **Drive Android**: `android-use`, `android-open-url`,
  `android-screenshot-and-element-tree`.
- **Apps and skills**: `list-apps` (pre-installable app assets), `get-agent-skill`
  (step-by-step CLI procedures for builds and anything touching local files, which stay
  on the [lim CLI](https://docs.limrun.com/docs/agents/cli)).

## Configure

The endpoint is `https://mcp.limrun.com/mcp` (streamable HTTP, stateless). Auth is OAuth
sign-in on first use, or a Limrun org API key as a bearer token for headless use. Sign up
at [limrun.com](https://limrun.com).

**VS Code / Copilot** (`mcp.json`):

```json
{
  "servers": {
    "limrun": { "type": "http", "url": "https://mcp.limrun.com/mcp" }
  }
}
```

**Claude Code**:

```bash
claude mcp add --transport http limrun https://mcp.limrun.com/mcp
```

Any other MCP client that speaks streamable HTTP works the same way; the server advertises
its authorization server through standard discovery metadata, so OAuth-capable clients
find the sign-in flow on their own.

## Use

Ask your agent things like:

- "Create an iOS simulator and show me a screenshot."
- "Open example.com on it and tap the first link."
- "Install my app from the asset list and walk through the signup flow."
- "Clean up all my running devices."

## Links

- Docs: https://docs.limrun.com/docs/agents/remote-mcp
- Registry listing: `com.limrun/mcp` in the [official MCP registry](https://registry.modelcontextprotocol.io)
- Agent skills and plugin (Claude Code, Cursor, Codex, Gemini CLI): https://github.com/limrun-inc/skills
- Support: contact@limrun.com