# Cloud iOS Simulator for Codex — no Mac required

> Keep Codex on Linux or in the cloud. AgentCloud gives it managed iOS builds and a disposable hosted Simulator through one remote OAuth MCP endpoint.

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

- Canonical page: [https://agentcloud.so/codex-ios-simulator.html](https://agentcloud.so/codex-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 Codex

```sh
codex mcp add agentcloud --url https://api.agentcloud.so/mcp
codex mcp login agentcloud
```

Codex registers the Streamable HTTP endpoint, discovers AgentCloud's authorization metadata, and completes OAuth 2.1 authorization with PKCE in the browser.

## Example request

> Build the current branch for iPhone Simulator, launch the app, verify the onboarding deep link, and show me the retained screenshots and logs.

Codex 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.