Agentic Testing
for React Native

Ceraph is an MCP server that lets your AI coding agent drive and test your React Native or Expo app end-to-end on a real iOS device or the iOS Simulator. Your agent can tap, type, swipe, deep-link, take screenshots, read a structured accessibility snapshot of the current screen, and pull runtime errors, so a code change is verified against the running app, not just the type checker.

Those tools have you author a test — an Appium script, a Detox flow, a Maestro YAML — and keep it green as the UI moves. Ceraph is MCP-native and lives in your edit loop: your coding agent drives the running app directly, reasoning over a deterministic accessibility snapshot instead of a script bound to brittle selectors. It is Expo-first and runs on your own agent's tokens. Under the hood Ceraph builds on WebDriverAgent — the same XCUITest foundation Appium's iOS driver uses — so the edge is the agentic, React-Native-native layer above the driver, not a different driver.

Not yet. Ceraph is iOS-only today — a real iOS device over USB, or the iOS Simulator, windowed or headless. Android is on the roadmap.

Yes. Ceraph is Expo-first and also works with bare React Native. It needs an Expo dev client or a prebuilt app — Expo Go is not supported.

Any MCP client. ceraph init auto-configures the ones it detects — Claude Code, Cursor, Codex, VS Code, Windsurf, and Antigravity — and Cline, Roo Code, and JetBrains IDEs can be set up manually. Your agent supplies its own model tokens; Ceraph hands it the driving and testing primitives.

A Mac with Xcode — the runtime path is Apple-specific — plus Node.js 18 or newer, and either a real iOS device connected over USB and unlocked, or a booted iOS Simulator. Expo Go is not supported, so use a dev client or a prebuilt app.

From your project root, run npx @ceraph/react-native-mcp@latest init to configure your MCP client. init also sets up the ceraph command on your PATH, so you can bring the app up with ceraph start. You usually don't run ceraph start yourself, though — your coding agent runs the same bring-up through the MCP, so on the simulator or any time it's driving, just ask it to test what you changed. The manual ceraph start is for hands-on device bring-up, like unlocking the phone. If ceraph isn't found — some locked-down machines can't install globally — use npx @ceraph/react-native-mcp@latest start instead.

The Starter plan is free and works with any MCP client, surfaces runtime errors in your chat, lets your agent drive the app on a real iOS device or simulator, and mocks the camera with test images. Pro is $10 per month and adds test-user provisioning and hooks to get your agent past auth walls and paywalls.