Skip to content
Back to search

simkit

MarketplaceWorks with Claude CodeGitHub

SimKit for coding agents: see an iOS app's network traffic and drive the simulator.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ealtaca--simkit-mcp/badge.svg)](/listings/ealtaca--simkit-mcp)

HTML

<a href="/listings/ealtaca--simkit-mcp"><img src="/api/listings/ealtaca--simkit-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Claude Code**

claude mcp add simkit -- npx -y simkit-mcp

Or as a plugin, which also adds a skill that teaches the agent when to use SimKit:

claude plugin marketplace add ealtaca/simkit-mcp
claude plugin install simkit@simkit

**Cursor, Kiro and other clients** — add to the client's MCP config:

{
  "mcpServers": {
    "simkit": { "command": "npx", "args": ["-y", "simkit-mcp"] }
  }
}

**Codex** — in `~/.codex/config.toml`:

[mcp_servers.simkit]
command = "npx"
args = ["-y", "simkit-mcp"]

If you already pressed Install in SimKit's Agents tab, your client is connected over HTTP and you don't need this package as well.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines
  1. {
  2. "name": "simkit",
  3. "description": "SimKit for coding agents: see an iOS app's network traffic and drive the simulator.",
  4. "owner": {
  5. "name": "SimKit",
  6. "url": "https://simkit.dev"
  7. },
  8. "plugins": [
  9. {
  10. "name": "simkit",
  11. "source": "./",
  12. "description": "See your iOS app's network traffic, mock responses and drive the simulator from your agent. Needs SimKit for Mac."
  13. }
  14. ]
  15. }
README.md · README · 94 lines
  1. # SimKit MCP
  2. Let Claude Code, Cursor, Codex and other coding agents see what your iOS app actually does: the requests it sends, the responses it gets, and how it behaves when the server returns a 500 or the network is slow. The agent can also drive the simulator: relaunch, screenshot, dark mode, location, push, deep links, app data.
  3. This package is a small bridge. The tools themselves live in [SimKit for Mac](https://simkit.dev), which is free; the bridge connects your agent to the SimKit app running on the same Mac.
  4. > **Beta.** This needs SimKit 1.8, which is in beta: pick Beta from the Download menu on [simkit.dev](https://simkit.dev). SimKit 1.7 has no MCP server.
  5. ## Requirements
  6. - macOS with [SimKit](https://simkit.dev) 1.8 beta or later, running, with **Coding Agents** turned on in the Agents tab
  7. - Node.js 18 or later
  8. ## Install
  9. **Claude Code**
  10. ```bash
  11. claude mcp add simkit -- npx -y simkit-mcp
  12. ```
  13. Or as a plugin, which also adds a skill that teaches the agent when to use SimKit:
  14. ```bash
  15. claude plugin marketplace add ealtaca/simkit-mcp
  16. claude plugin install simkit@simkit
  17. ```
  18. **Cursor, Kiro and other clients** — add to the client's MCP config:
  19. ```json
  20. {
  21. "mcpServers": {
  22. "simkit": { "command": "npx", "args": ["-y", "simkit-mcp"] }
  23. }
  24. }
  25. ```
  26. **Codex** — in `~/.codex/config.toml`:
  27. ```toml
  28. [mcp_servers.simkit]
  29. command = "npx"
  30. args = ["-y", "simkit-mcp"]
  31. ```
  32. If you already pressed Install in SimKit's Agents tab, your client is connected over HTTP and you don't need this package as well.
  33. ## Try it
  34. - "List the requests my app made in the last minute and tell me which ones failed."
  35. - "Mock /login to return a 500, relaunch the app and take a screenshot."
  36. - "Throttle the network to 3G and tell me which requests get slow."
  37. - "Create a bug report for my app."
  38. ## What agents can do
  39. | Area | Examples |
  40. |---|---|
  41. | Network | list and inspect requests and WebSockets, export cURL/HAR, throttle, generate models and OpenAPI |
  42. | Mocks | add and remove mocked responses, expire a token, run a network scenario |
  43. | Simulator | boot, open links, location, appearance, text size, permissions, clipboard, Face ID, push |
  44. | Apps and data | relaunch, reset, UserDefaults, files, keychain, databases, cookies, whole-state snapshots |
  45. | Capture | screenshots, video, console logs, bug report bundle |
  46. SimKit has about 90 tools. To keep your agent's context small, the bridge lists some 20 of them and the agent looks the others up as it needs them. Tools that only read are run through `read_tool`, which is marked read-only, so a client that asks before every change doesn't ask before a lookup.
  47. Network capture needs either the SimKit SDK in your app or the direct-download build of SimKit.
  48. ## How it works, and what it touches
  49. SimKit serves MCP on `127.0.0.1` only, protected by a token. This bridge is one dependency-free Node script (`server/simkit-mcp.mjs`). Everything it does:
  50. - **Reads one value from your Mac:** SimKit's agent token, from SimKit's own settings file (`~/Library/Containers/com.simkit.app/Data/Library/Preferences/com.simkit.app.plist`), using `/usr/bin/plutil`. It reads nothing else.
  51. - **Talks to one address:** `http://127.0.0.1:47290/mcp`, the SimKit app on the same Mac. It sends the token there and nowhere else, and makes no other network request.
  52. - **Writes nothing** to disk, and collects no analytics.
  53. What the tools return (requests, headers, bodies, screenshots) comes from the SimKit app and goes to your agent, which sends it to its model provider like anything else it reads. SimKit's own data handling is in its [privacy policy](https://simkit.dev/privacy-policy).
  54. | Variable | Use |
  55. |---|---|
  56. | `SIMKIT_MCP_TOKEN` | Use this token instead of reading SimKit's settings |
  57. | `SIMKIT_MCP_PORT` | SimKit's MCP port, if you changed it (default 47290) |
  58. | `SIMKIT_MCP_TOOLS` | `all` lists every SimKit tool up front. By default the bridge lists the everyday ones and the agent finds the rest with `find_tools` and runs them with `read_tool` or `call_tool` |
  59. | `SIMKIT_BUNDLE_ID` | Read the token from another SimKit build's settings |
  60. ## Troubleshooting
  61. - **"SimKit isn't reachable"** — open SimKit and turn on Coding Agents in the Agents tab.
  62. - **"SimKit refused the token"** — set `SIMKIT_MCP_TOKEN` to the token shown in the Agents tab.
  63. ## License
  64. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.