By default, XcodeBuildMCP uses a session-aware mode. The client sets shared defaults once (simulator, device, project/workspace, scheme, etc.) and all tools reuse them. This reduces schema size and repeated payloads.
- Call
session_set_defaultsonce at the start of a workflow. - Tools reuse those defaults automatically.
- Use
session_show_defaultsto inspect current values. - Use
session_clear_defaultsto clear values when switching contexts.
See the session-management tools in TOOLS.md.
If you prefer explicit parameters on every tool call, set:
"env": {
"XCODEBUILDMCP_DISABLE_SESSION_DEFAULTS": "true"
}This restores the legacy schemas with per-call parameters while still honoring any defaults you choose to set.
- Configuration options: CONFIGURATION.md
- Tools reference: TOOLS.md