Your agent wrote the code.
Now let it see what the app did.
Claude Code, Cursor and Codex can read your iOS app's requests and responses, mock a failing server, and drive the simulator, all through SimKit on your Mac. Free.
npx -y simkit-mcp
Beta Needs SimKit 1.8, which is in beta: choose Beta in the Download menu on the home page. Setup takes three steps.
Mock /login to return a 500, relaunch the app and show me what the user sees.
- set_mockPOST /login answers 500
- relaunch_appcom.example.shop restarted
- wait_for_requestPOST /login finished, 500 from the mock
- screenshotthe login screen, as the simulator shows it
- remove_mockback to the real server
The app shows a blank screen on a 500: LoginViewModel only handles 401. I've added an error state and checked it the same way.
An illustration of a session. The tool names are SimKit's own.
An agent can read your code. It can't see your app run.
It doesn't know which request went out, what came back, or what happens on a 401 or a slow connection, so it guesses. SimKit already watches all of that beside your simulator. MCP hands it to the agent.
- List the requests my app made in the last minute and tell me which ones failed.
- Throttle the network to 3G and tell me which requests get slow.
- Switch the simulator to dark mode with the largest text size and show me the screen.
- Expire my auth token and check that the app refreshes it once, not five times.
- Create a bug report for my app.
About 90 tools, grouped the way you work.
Your agent starts with the everyday ones and looks the others up as it needs them, so they don't fill its context.
Network
Read captured requests and WebSockets, export cURL and HAR, throttle the connection, generate Swift models and OpenAPI.
Mocks
Add and remove mocked responses, expire a token, play a bad-network scenario such as hotel Wi-Fi or a flapping connection.
Simulator
Boot, open links, set location and routes, appearance, text size, permissions, clipboard, Face ID and push notifications.
Apps and their data
Relaunch and reset apps; read and change UserDefaults, files, keychain, databases and cookies; save and restore an app's whole state.
Capture
Screenshots, video, the app's console, received pushes and links, an accessibility audit, and a zipped bug report.
Real devices
Many of the same tools on an iPhone or iPad that connects through the SimKit SDK or Xcode.
Three steps.
-
Get SimKit
The MCP server is part of the Mac app, from version 1.8. That version is in beta: on the home page, open the Download menu and choose Beta. SimKit 1.7 doesn't have it yet.
-
Turn on Coding Agents
Open SimKit's panel, go to the Agents tab and switch it on. It is off until you do.
-
Connect your agent
Add SimKit to your agent:
Claude Code
claude mcp add simkit -- npx -y simkit-mcpCursor, Kiro and other clients
{ "mcpServers": { "simkit": { "command": "npx", "args": ["-y", "simkit-mcp"] } } }Codex
[mcp_servers.simkit] command = "npx" args = ["-y", "simkit-mcp"]
It stays on your Mac.
- Local only. The server listens on 127.0.0.1 and turns away anything that isn't on your Mac.
- Off by default, behind a token. Nothing can connect until you turn it on, and only with the token SimKit made for you.
- Reads are marked as reads. Every tool says whether it changes anything, so your agent can ask before it resets an app and not before it lists requests.
- Nothing is uploaded by SimKit. What your agent reads, it sends to its own model provider, as with any file it reads.
Questions, answered.
Is it free?
Yes. SimKit and its MCP server are free, with no account.
Which coding agents does it work with?
Any MCP client. simkit-mcp works with any client that runs a command, including Claude Code, Cursor, Codex and Kiro.
Do I need the SimKit SDK?
For the simulator tools, no. Network capture, mocks and throttling need the one-line SimKit SDK in your debug build, or the DMG build of SimKit.
Can the agent tap and type in my app?
No. SimKit observes and sets things up: requests, mocks, app data, simulator settings and screenshots. Use it next to the tool you already build and tap with.
Does my app's data leave my Mac?
Not through SimKit. Headers and bodies reach your agent as the app sent them, tokens included, so treat them as you would any secret your agent can read. Tools that return them take a redact option.
It says SimKit isn't reachable.
Open SimKit and check that Coding Agents is on in the Agents tab. The agent connects to the app, so the app has to be running.
Give your agent eyes.
Free. MCP is in the 1.8 beta: choose Beta in the Download menu.