Preflight iOS MCP

Get the UDID of the currently booted iOS Simulator.

Read the text content of the simulator clipboard.

Retrieve crash reports from ~/Library/Logs/DiagnosticReports/. Shows stack traces, exception info, and thread states. Filter by process name.

Read an environment variable from the running simulator device (e.g., HOME, TMPDIR, PATH).

Get recent device/app logs. Filter by process name, subsystem, log level, time range, and message content. Essential for debugging app behavior.

Get diagnostic info about the Simulator window geometry and coordinate mapping. Useful for debugging tap/swipe accuracy.

Grant, revoke, or reset app permissions (camera, location, photos, contacts, microphone, etc.).

Dump heap allocation summary for a running app. Shows object counts by class and total memory usage.

Trigger iCloud sync on the device. Requires the device to be signed into an Apple ID.

Install a .app bundle onto the simulator from a local file path.

Install an .xcappdata package to replace the current app container contents. Useful for restoring test data snapshots.

Manipulate the device keychain: add root certificates, add certificates, or reset the entire keychain.

Launch an app by bundle ID. Optionally pass launch arguments and environment variables.

Check a running app for memory leaks using Apple's leaks tool. Returns leak count, leaked bytes, and details.

List files in an app's data container. Shows Documents, Library, Preferences, Caches, tmp, etc. Use to find databases, plists, caches.

List all installed apps on the simulator with their bundle IDs.

List iOS Simulator devices. Shows name, UDID, state, and runtime.

Simulate movement along a custom route with waypoints. Specify GPS coordinates and speed for realistic location testing.

Run predefined GPS location scenarios (Freeway Drive, City Run, City Bicycle Ride). Simulates realistic movement patterns for testing location features.

Long press at a point on the simulator screen. Useful for context menus, drag-and-drop initiation, etc.

Trigger a simulated memory warning. Apps will receive didReceiveMemoryWarning and can be tested for proper memory cleanup.

Navigate back in the current app. Sends Cmd+[ (standard back navigation). Works in Safari and apps with standard UINavigationController. Workaround for edge-swipe-back gesture limitation.

Capture a snapshot of network activity: active TCP connections, DNS resolution, host interfaces, and any active network conditioning.

Apply network throttling: bandwidth limits, latency, and packet loss. Presets: 3G, LTE, Edge, WiFi, WiFi-lossy, 100%-loss (offline). Simulator shares host network stack, so conditioning affects all simulator traffic.

Get the current network configuration inside the simulator — interfaces, IP addresses, DNS config.

Post a Darwin notification inside the simulator. Useful for triggering system events or testing notification observers.

Opens the iOS Simulator application.

Open a URL or deep link in the simulator (e.g., "https://example.com" or "myapp://screen").

Override the simulator status bar: set time, battery, signal bars, carrier name, network type. Use clear=true to reset.

Press a special key (return, escape, delete, tab, arrows, etc.) with optional modifiers (command, shift, option, control).

Read a file from an app's data container. Handles plists (converts to JSON), SQLite databases (shows schema), and text files. Specify path relative to data container.

Start recording the simulator screen to a video file. Use simulator_stop_recording to stop. Supports H.264 and HEVC codecs.

Rename a simulator device.

Rotate the simulator device left or right. Uses Cmd+Arrow keyboard shortcut in Simulator.app.

Sample a running app's CPU activity for a few seconds. Returns call stack tree — useful for finding performance hotspots and hangs.

Take a screenshot of the iOS Simulator screen. Returns the image directly for viewing.

Send a push notification to an app. Provide the full APNs payload JSON (e.g., {"aps": {"alert": "Hello"}}).

Switch the simulator between light and dark mode.

Enable or disable Bold Text accessibility setting. Test text rendering with bold system fonts.

Set text on the simulator clipboard. Useful for pasting content into apps.

Set the preferred content size for Dynamic Type testing. Test your app with accessibility text sizes without changing device settings manually.

Enable or disable the Increase Contrast accessibility setting. Test how your app responds to high contrast mode.

Set the device locale and language for internationalization testing. Requires device reboot to take effect.

Set the simulated GPS location (latitude, longitude). Useful for testing location-based features.

Enable or disable the Reduce Motion accessibility setting. Test animations and transitions with motion sensitivity.

Enable or disable Reduce Transparency. Test UI readability without blur/vibrancy effects.

Enable or disable Smart Invert Colors. Test how your app handles inverted color schemes.

Shut down a running simulator device.

Capture a structured accessibility snapshot of the current screen — like Playwright's browser_snapshot. Returns roles, labels, values, and positions. PREFERRED over screenshots for understanding UI structure and targeting interactions. No vision model needed.

Stop an active video recording and save the file.

Enable or disable StoreKit testing on the simulator. Required before using other StoreKit tools.

Delete all StoreKit test transactions. Clears purchase history for fresh testing.

Expire or force-renew a StoreKit test subscription by transaction ID.

Refund, approve, or decline ask-to-buy for a StoreKit test transaction.

Reset introductory offer eligibility for all StoreKit products. Allows re-testing intro pricing.

List all StoreKit test transactions (purchases, subscriptions, etc.).

Start/read/stop a live log stream. Use action="start" to begin, "read" to get the buffer, "stop" to end. Great for watching app behavior in real-time.

Swipe/drag from one point to another on the simulator screen. Coordinates are in simulator screen points. Use for scrolling, pulling down, or any drag gesture.

Tap at a point on the simulator screen. Coordinates are in simulator screen points (e.g., 0-393 for iPhone width). Take a screenshot first to identify coordinates.

Force-terminate a running app by bundle ID.

Simulate thermal pressure changes (nominal, fair, serious, critical). Test how your app responds to device overheating.

Invoke Siri on the simulator. Use simulator_type_text to enter a query if text input is available.

Type text into the currently focused text field in the simulator. Make sure a text field is focused first (tap on it).

Uninstall an app from the simulator by bundle ID.

Enable or disable verbose device logging for deep debugging. Requires device reboot to take effect.

Show virtual memory map for a running app. Displays memory regions, sizes, and permissions. Useful for diagnosing memory issues.

Wait for an accessibility element to appear on screen. Polls until the element matching your criteria (label, role, or text) appears, or times out. Like Playwright's browser_wait_for.