perf(xcode-ide): Add gateway tools and unblock MCP handshake

Add manifest-managed xcode_ide_list_tools and xcode_ide_call_tool for MCP xcode-ide access. Keep runtime manifest loading and CLI xcode-ide behavior unchanged.

Remove handshake-time bridge tool sync from MCP startup and defer non-critical Xcode state and Sentry enrichment work until after connect to reduce startup latency.

Include before/after profiling reports and startup stage instrumentation to measure handshake-path costs and validate improvements.

Fixes #210

Co-Authored-By: Claude <noreply@anthropic.com>

Author: cameroncooke

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [Unreleased]
+
+### Changed
+
+- Changed MCP `xcode-ide` integration to expose manifest-managed gateway tools (`xcode_ide_list_tools`, `xcode_ide_call_tool`) while keeping CLI dynamic `xcode_tools_*` behavior unchanged ([#210](https://github.com/getsentry/XcodeBuildMCP/issues/210))
+- Deferred non-critical Xcode IDE state synchronization and Sentry enrichment work until after MCP connect to reduce handshake-path latency ([#210](https://github.com/getsentry/XcodeBuildMCP/issues/210))
+
+### Fixed
+
+- Removed startup dependency on handshake-time Xcode bridge `tools/list` sync for MCP tool registration, preventing bridge list latency from delaying initial connect ([#210](https://github.com/getsentry/XcodeBuildMCP/issues/210))
+
 ## [2.0.7]
 
 ### Changed
@@ -273,4 +284,3 @@ Please note that the UI automation features are an early preview and currently i
 - Initial release of XcodeBuildMCP
 - Basic support for building iOS and macOS applications
 
-

docs/CONFIGURATION.md

@@ -147,7 +147,7 @@ enabledWorkflows: ["simulator", "ui-automation", "debugging"]
 
 See [TOOLS.md](TOOLS.md) for available workflows and their tools.
 
-To proxy Xcode IDE tools (Xcode 26+ `xcrun mcpbridge`), enable `xcode-ide`. See [XCODE_IDE_MCPBRIDGE.md](XCODE_IDE_MCPBRIDGE.md).
+To access Xcode IDE tools (Xcode 26+ `xcrun mcpbridge`), enable `xcode-ide`. This workflow exposes `xcode_ide_list_tools` and `xcode_ide_call_tool` for MCP clients. See [XCODE_IDE_MCPBRIDGE.md](XCODE_IDE_MCPBRIDGE.md).
 
 ### Experimental workflow discovery
 

docs/TOOLS-CLI.md

@@ -2,7 +2,7 @@
 
 This document lists CLI tool names as exposed by `xcodebuildmcp <workflow> <tool>`.
 
-XcodeBuildMCP provides 71 canonical tools organized into 13 workflow groups.
+XcodeBuildMCP provides 73 canonical tools organized into 13 workflow groups.
 
 ## Workflow Groups
 
@@ -171,20 +171,22 @@ XcodeBuildMCP provides 71 canonical tools organized into 13 workflow groups.
 
 
 ### Xcode IDE Integration (`xcode-ide`)
-**Purpose**: Bridge tools for connecting to Xcode's built-in MCP server (mcpbridge) to access IDE-specific functionality. (3 tools)
+**Purpose**: Bridge tools for connecting to Xcode's built-in MCP server (mcpbridge) to access IDE-specific functionality. (5 tools)
 
 - `bridge-disconnect` - Disconnect bridge and unregister proxied `xcode_tools_*` tools.
 - `bridge-status` - Show xcrun mcpbridge availability and proxy tool sync status.
 - `bridge-sync` - One-shot connect + tools/list sync (manual retry; avoids background prompt spam).
+- `xcode-ide-call-tool` - Call a remote Xcode IDE MCP tool through mcpbridge.
+- `xcode-ide-list-tools` - List remote Xcode IDE MCP tools available through mcpbridge.
 
 
 
 ## Summary Statistics
 
-- **Canonical Tools**: 71
-- **Total Tools**: 95
+- **Canonical Tools**: 73
+- **Total Tools**: 97
 - **Workflow Groups**: 13
 
 ---
 
-*This documentation is automatically generated by `scripts/update-tools-docs.ts` from the tools manifest. Last updated: 2026-02-08T12:09:33.648Z UTC*
+*This documentation is automatically generated by `scripts/update-tools-docs.ts` from the tools manifest. Last updated: 2026-02-13T23:22:09.102Z UTC*

docs/TOOLS.md

@@ -1,6 +1,6 @@
 # XcodeBuildMCP MCP Tools Reference
 
-This document lists MCP tool names as exposed to MCP clients. XcodeBuildMCP provides 76 canonical tools organized into 15 workflow groups for comprehensive Apple development workflows.
+This document lists MCP tool names as exposed to MCP clients. XcodeBuildMCP provides 78 canonical tools organized into 15 workflow groups for comprehensive Apple development workflows.
 
 ## Workflow Groups
 
@@ -186,8 +186,10 @@ This document lists MCP tool names as exposed to MCP clients. XcodeBuildMCP prov
 
 
 ### Xcode IDE Integration (`xcode-ide`)
-**Purpose**: Bridge tools for connecting to Xcode's built-in MCP server (mcpbridge) to access IDE-specific functionality. (3 tools)
+**Purpose**: Bridge tools for connecting to Xcode's built-in MCP server (mcpbridge) to access IDE-specific functionality. (5 tools)
 
+- `xcode_ide_call_tool` - Call a remote Xcode IDE MCP tool through mcpbridge.
+- `xcode_ide_list_tools` - List remote Xcode IDE MCP tools available through mcpbridge.
 - `xcode_tools_bridge_disconnect` - Disconnect bridge and unregister proxied `xcode_tools_*` tools.
 - `xcode_tools_bridge_status` - Show xcrun mcpbridge availability and proxy tool sync status.
 - `xcode_tools_bridge_sync` - One-shot connect + tools/list sync (manual retry; avoids background prompt spam).
@@ -196,10 +198,10 @@ This document lists MCP tool names as exposed to MCP clients. XcodeBuildMCP prov
 
 ## Summary Statistics
 
-- **Canonical Tools**: 76
-- **Total Tools**: 100
+- **Canonical Tools**: 78
+- **Total Tools**: 102
 - **Workflow Groups**: 15
 
 ---
 
-*This documentation is automatically generated by `scripts/update-tools-docs.ts` from the tools manifest. Last updated: 2026-02-08T12:09:33.648Z UTC*
+*This documentation is automatically generated by `scripts/update-tools-docs.ts` from the tools manifest. Last updated: 2026-02-13T23:22:09.102Z UTC*

docs/XCODE_IDE_MCPBRIDGE.md

@@ -15,12 +15,16 @@ enabledWorkflows: ["simulator", "debugging", "xcode-ide"]
 
 If the workflow is not enabled, XcodeBuildMCP does not start the bridge.
 
-## Tool naming
+## MCP tools in `xcode-ide` workflow
 
-Proxied tools are registered dynamically, based on whatever Xcode advertises via `tools/list`:
+When `xcode-ide` is enabled and `mcpbridge` is available, XcodeBuildMCP exposes two gateway tools:
 
-- Remote: `XcodeListWindows`
-- Local proxy: `xcode_tools_XcodeListWindows`
+- `xcode_ide_list_tools`: Lists remote tools from Xcode's MCP server (name, description, schemas).
+- `xcode_ide_call_tool`: Calls a remote Xcode tool by name with a JSON argument payload.
+
+These tools are stable and manifest-managed. They are shown only when `mcpbridge` is available.
+
+CLI behavior is unchanged and continues to use dynamic `xcode_tools_*` proxy naming.
 
 ## Bridge debug tools
 
@@ -38,7 +42,7 @@ Recommended flow:
 
 1. Launch Xcode.
 2. Start XcodeBuildMCP with `xcode-ide` enabled.
-3. If you don’t see any `xcode_tools_*` tools, temporarily set `debug: true` and call `xcode_tools_bridge_sync` after approving any prompts.
+3. If `xcode_ide_list_tools` fails, temporarily set `debug: true` and call `xcode_tools_bridge_status` to inspect bridge health, then retry after approving prompts.
 
 ## Targeting a specific Xcode instance (optional)
 

manifests/tools/xcode_ide_call_tool.yaml

@@ -0,0 +1,11 @@
+id: xcode_ide_call_tool
+module: mcp/tools/xcode-ide/xcode_ide_call_tool
+names:
+  mcp: xcode_ide_call_tool
+  cli: xcode-ide-call-tool
+description: Call a remote Xcode IDE MCP tool through mcpbridge.
+predicates:
+  - mcpRuntimeOnly
+annotations:
+  title: Call Xcode IDE Tool
+  readOnlyHint: false

manifests/tools/xcode_ide_list_tools.yaml

@@ -0,0 +1,11 @@
+id: xcode_ide_list_tools
+module: mcp/tools/xcode-ide/xcode_ide_list_tools
+names:
+  mcp: xcode_ide_list_tools
+  cli: xcode-ide-list-tools
+description: List remote Xcode IDE MCP tools available through mcpbridge.
+predicates:
+  - mcpRuntimeOnly
+annotations:
+  title: List Xcode IDE Tools
+  readOnlyHint: true

manifests/workflows/xcode-ide.yaml

@@ -4,9 +4,10 @@ description: Bridge tools for connecting to Xcode's built-in MCP server (mcpbrid
 availability:
   cli: false
 predicates:
-  - xcodeToolsAvailable
   - hideWhenXcodeAgentMode
 tools:
+  - xcode_ide_list_tools
+  - xcode_ide_call_tool
   - xcode_tools_bridge_status
   - xcode_tools_bridge_sync
   - xcode_tools_bridge_disconnect

src/cli.ts

@@ -63,8 +63,7 @@ async function main(): Promise<void> {
     excludeWorkflows: ['session-management', 'workflow-discovery'],
   });
   const topLevelCommand = findTopLevelCommand(process.argv.slice(2));
-  const discoveryMode =
-    topLevelCommand === 'xcode-ide' || topLevelCommand === 'tools' ? 'quick' : 'none';
+  const discoveryMode = topLevelCommand === 'xcode-ide' ? 'quick' : 'none';
 
   // CLI uses a manifest-resolved catalog plus daemon-backed xcode-ide dynamic tools.
   const catalog = await buildCliToolCatalog({

src/cli/cli-tool-catalog.ts

@@ -85,7 +85,7 @@ function createCliXcodeProxyTool(remoteTool: DynamicBridgeTool): ToolDefinition
   const cliSchema = jsonSchemaToToolSchemaShape(remoteTool.inputSchema);
 
   return {
-    cliName: `xcode-ide-${toKebabCase(remoteTool.name)}`,
+    cliName: toKebabCase(remoteTool.name),
     mcpName: toLocalToolName(remoteTool.name),
     workflow: 'xcode-ide',
     description: remoteTool.description ?? '',