diff --git a/plugins/build-ios-apps/.mcp.json b/plugins/build-ios-apps/.mcp.json
index 7105b445..8065dd12 100644
--- a/plugins/build-ios-apps/.mcp.json
+++ b/plugins/build-ios-apps/.mcp.json
@@ -6,6 +6,10 @@
       "env": {
         "XCODEBUILDMCP_ENABLED_WORKFLOWS": "simulator,ui-automation,debugging,logging"
       }
+    },
+    "swiftdoc": {
+      "type": "http",
+      "url": "https://sosumi.ai/mcp"
     }
   }
 }
diff --git a/plugins/build-ios-apps/README.md b/plugins/build-ios-apps/README.md
index 1926fb52..ecd4499a 100644
--- a/plugins/build-ios-apps/README.md
+++ b/plugins/build-ios-apps/README.md
@@ -17,6 +17,7 @@ It currently includes these skills:
 - building and refactoring SwiftUI UI using current platform patterns
 - reviewing or adopting iOS 26+ Liquid Glass APIs
 - auditing SwiftUI performance and guiding profiling workflows
+- looking up Swift and Apple-platform API docs through SwiftDoc MCP
 - debugging iOS apps on simulators with XcodeBuildMCP-backed flows
 - restructuring large SwiftUI views toward smaller, more stable compositions
 
@@ -35,6 +36,7 @@ with this shape:
 - `.mcp.json`
   - plugin-local MCP config
   - wires in XcodeBuildMCP for simulator build/run/debug workflows
+  - wires in SwiftDoc MCP for Swift and Apple-platform documentation lookup
 
 - `agents/`
   - plugin-level agent metadata
diff --git a/plugins/build-macos-apps/.codex-plugin/plugin.json b/plugins/build-macos-apps/.codex-plugin/plugin.json
index 73269150..540715be 100644
--- a/plugins/build-macos-apps/.codex-plugin/plugin.json
+++ b/plugins/build-macos-apps/.codex-plugin/plugin.json
@@ -24,6 +24,7 @@
     "oslog"
   ],
   "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
   "interface": {
     "displayName": "Build macOS Apps",
     "shortDescription": "Build, debug, instrument, and implement macOS apps with SwiftUI and AppKit guidance",
diff --git a/plugins/build-macos-apps/.mcp.json b/plugins/build-macos-apps/.mcp.json
new file mode 100644
index 00000000..2033aeaf
--- /dev/null
+++ b/plugins/build-macos-apps/.mcp.json
@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "swiftdoc": {
+      "type": "http",
+      "url": "https://sosumi.ai/mcp"
+    }
+  }
+}
diff --git a/plugins/build-macos-apps/README.md b/plugins/build-macos-apps/README.md
index 4b7be879..17a06896 100644
--- a/plugins/build-macos-apps/README.md
+++ b/plugins/build-macos-apps/README.md
@@ -31,6 +31,7 @@ It currently includes these skills:
 - triaging failing unit, integration, and UI-hosted macOS tests
 - debugging launch failures, crashes, linker problems, and runtime regressions
 - inspecting signing identities, entitlements, hardened runtime, and Gatekeeper issues
+- looking up Swift and Apple-platform API docs through SwiftDoc MCP
 - preparing packaging and notarization workflows for distribution
 
 ## What It Does Not Cover
@@ -52,6 +53,10 @@ with this shape:
   - required plugin manifest
   - defines plugin metadata and points Codex at the plugin contents
 
+- `.mcp.json`
+  - plugin-local MCP config
+  - wires in SwiftDoc MCP for Swift and Apple-platform documentation lookup
+
 - `agents/`
   - plugin-level agent metadata
   - currently includes `agents/openai.yaml` for the OpenAI surface
@@ -66,8 +71,8 @@ with this shape:
 
 ## Notes
 
-This plugin is currently skills-first at the plugin level. It does not ship a
-plugin-local `.mcp.json`, matching the public `plugins/build-ios-apps` shape.
+This plugin combines skills with a small plugin-local `.mcp.json` for
+documentation lookup.
 
 The default posture is shell-first. Unlike the iOS build plugin, this plugin
 does not assume simulator tooling or touch-driven UI inspection for its main