> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobster.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Mobster from opencode

> Add Mobster's MCP server to opencode with one command, so its agent can check iOS apps on a simulator and drive your iPhone.

Mobster adds its MCP server to opencode's own config. opencode then lists Mobster's tools (`verify_start`, `screen`, `tap`, `run_tests` and the rest of [the MCP server](https://docs.mobster.dev/mcp-server.md)).

## Add it

```sh theme={"theme":"css-variables"}
mobster mcp install opencode
```

It prints what it changed:

```text theme={"theme":"css-variables"}
Mobster's MCP server: /Applications/Mobster.app/Contents/MacOS/mobster-agent mcp
  opencode        added      ~/.config/opencode/opencode.json
New sessions of the other clients pick it up. Check it with `mobster mcp doctor`.
```

Add `--dry-run` to see the change first and write nothing. Run the command again and nothing changes. `mobster mcp install --all` sets up every agent it finds, opencode included.

## What it writes

The entry goes in `~/.config/opencode/opencode.json`. Mobster edits `opencode.jsonc` instead when that file exists, and keeps its comments. `$XDG_CONFIG_HOME` moves the folder.

```json theme={"theme":"css-variables"}
{
  "mcp": {
    "mobster": {
      "type": "local",
      "command": ["/Applications/Mobster.app/Contents/MacOS/mobster-agent", "mcp"],
      "enabled": true
    }
  }
}
```

Mobster keeps the rest of the file as it is, with a copy of the old one beside it (`.mobster-backup`). It writes the full path to `mobster` because apps opened from the Dock don't see your shell's `PATH`, and it never writes a key. `--project DIR` writes `DIR/opencode.json`.

## Check it

```sh theme={"theme":"css-variables"}
mobster mcp doctor
```

The doctor starts the server the way opencode does, lists its tools and calls `status`. Then it checks that the opencode entry runs a `mobster` that exists, and says which command to run if it doesn't. Start a new opencode session. `opencode mcp list` shows the server.

## Add the skill

```sh theme={"theme":"css-variables"}
mobster mcp install opencode --with-skill
```

This copies the `mobster` skill into `~/.agents/skills`, so the agent also knows the verify loop and the rules for a real iPhone: ask before anything that sends, buys, posts or deletes, and never enter a passcode.

## Take it out

```sh theme={"theme":"css-variables"}
mobster mcp install opencode --remove
```

This removes the `mobster` entry and leaves your other servers alone. opencode's own reference for the file is at [https://opencode.ai/docs/mcp-servers/](https://opencode.ai/docs/mcp-servers/).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.