# Hosted iOS Simulator for Cursor

> Keep Cursor on your machine, in its CLI, or in a Cloud Agent while AgentCloud supplies a managed iOS build and disposable hosted Simulator through OAuth-enabled MCP.

AgentCloud accepts build-ready iOS source, then exposes focused tools for building, launching, observing, acting, reading logs, and retaining the evidence. Cursor does not receive a Mac desktop, Xcode interface, or raw worker shell.

- Canonical page: [https://agentcloud.so/cursor-ios-simulator.html](https://agentcloud.so/cursor-ios-simulator.html)
- Start free: [https://app.agentcloud.so/signup?plan=free](https://app.agentcloud.so/signup?plan=free)
- Compare pricing: [https://agentcloud.so/pricing.html](https://agentcloud.so/pricing.html)

## Connect a Cursor project

Create `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "agentcloud": {
      "url": "https://api.agentcloud.so/mcp"
    }
  }
}
```

Complete OAuth from Cursor's MCP settings. Cursor CLI uses the same configuration and can verify or authorize the server with `agent mcp list` and `agent mcp login agentcloud`.

For Cursor Cloud Agents, enable a personal MCP from the agent MCP picker, or add a shared HTTP MCP under Dashboard → Integrations & MCP, then complete OAuth for the user.

## Example request

> Build this branch for iPhone Simulator, launch it, verify the onboarding flow, and show me the retained screenshots and logs.

Cursor can use AgentCloud tools such as `ios.create_source_upload`, `ios.build`, `ios.create`, `ios.install`, `ios.observe`, `ios.act`, `ios.logs`, and `ios.destroy`.

## Technical boundaries

- Source uploads must include a build-ready Xcode workspace or project and required dependencies.
- App uploads must be Simulator-compatible `.app` bundles; device-signed `.ipa` files are not supported.
- AgentCloud provides focused build and Simulator tools through remote OAuth MCP, not a Mac, Xcode UI, or general-purpose remote computer.
- The Free plan includes 2 total iOS Simulator hours and 1 source build total without a card.