MobileBuildMCP CLI

Use MobileBuildMCP tools via the mobilebuildmcp executable instead of raw xcodebuild, xcrun, or simctl.

Step 1: Ensure the CLI Exists

Check availability:

mobilebuildmcp --help

If missing, install with one of:

brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp

npm install -g mobilebuildmcp@latest

Re-check after install:

mobilebuildmcp --help

Step 2: Use Help-First Discovery

Discover workflows and arguments from the CLI itself:

mobilebuildmcp --help
mobilebuildmcp tools
mobilebuildmcp <workflow> --help
mobilebuildmcp <workflow> <tool> --help

Use this discovery path instead of memorizing static tool lists.

Step 3: Keep Execution Minimal

• Choose the smallest command sequence that satisfies the request.
• Prefer direct workflow commands over manual multi-step chains unless explicitly requested.
• For simulator run intent, prefer the combined build-and-run command.
• Do not chain build then build-and-run unless explicitly requested.

Capability Overview

mobilebuildmcp supports:

• simulator and device build/test/run
• debugging and log capture
• UI automation
• project discovery and scaffolding
• session defaults and workflow configuration

Exit Criteria

• CLI presence is verified or installation steps are provided.
• Commands are discovered via --help / tools.
• Session defaults are checked before first build/run/test action.