MCP Status: Checking...

Agent-ready Apple developer docs

For Claude Code, Cursor, Copilot, and any MCP client.

Connect your client GitHub

334,203

Documents

378

Frameworks

Feb 6

Last Updated

<1s

Response Time

Connect your client

Run the following command in your terminal:

Terminal

claude mcp add --transport http apple-docs https://xdocs.dev/mcp

Add an API key Optional, removes rate limiting

Terminal

claude mcp add --transport http apple-docs https://xdocs.dev/mcp \
    --header "Authorization: Bearer YOUR_API_KEY"

⭐️ Add a SKILL.md file Recommended, teaches Claude when to use apple-docs

Terminal

mkdir -p .claude/skills/searching-apple-docs

Then create .claude/skills/searching-apple-docs/SKILL.md with:

SKILL.md

---
name: searching-apple-docs
description: Searches Apple developer documentation for Swift, SwiftUI, UIKit, AppKit, and 370+ frameworks. Useful for looking up iOS/macOS/visionOS APIs, checking method signatures, finding platform availability, or debugging Apple framework issues.
---

# Searching Apple Documentation

335K pre-indexed Apple developer documents.

## Default Workflow

Step 1: Search with summaries first
apple-docs:search_apple_docs(
  query: "NavigationStack",
  framework: "SwiftUI",
  summary_mode: true
)
→ Results include Path: documentation/SwiftUI/navigationstack.md

Step 2: Expand using the path from results
apple-docs:expand_result(
  file_path: "documentation/SwiftUI/navigationstack.md"
)

## Tool Reference

apple-docs:search_apple_docs - Find symbols, search documentation
apple-docs:expand_result - Get full documentation for a symbol
apple-docs:list_frameworks - Browse available frameworks

## Key Parameters

query: "NavigationStack" (use exact symbol names)
framework: "SwiftUI" (optional filter)
platform: "visionos" (ios/macos/visionos/watchos/tvos)
summary_mode: true (use for initial searches)
token_budget: 5000 (default, max 25000)

## Tips

- Always use summary_mode: true for initial searches
- Use full path from results for apple-docs:expand_result
- Symbol-only lookups resolve ambiguously across frameworks

For more information, see the Claude Code MCP documentation.

Add a custom connector in Claude Desktop settings:

Claude Desktop

1. Open Claude Desktop
2. Navigate to Settings → Connectors
3. Select "Add custom connector"
4. Enter apple-docs as the name
5. Set URL to https://xdocs.dev/mcp
6. Click "Add"

⭐️ Add a custom skill Recommended, teaches Claude when to use apple-docs

Create a skill folder and package it as a ZIP:

Terminal

mkdir -p apple-docs

Create apple-docs/SKILL.md with the content below, then ZIP the folder:

SKILL.md

---
name: searching-apple-docs
description: Searches Apple developer documentation for Swift, SwiftUI, UIKit, AppKit, and 370+ frameworks. Useful for looking up iOS/macOS/visionOS APIs, checking method signatures, finding platform availability, or debugging Apple framework issues.
---

# Searching Apple Documentation

335K pre-indexed Apple developer documents.

## Default Workflow

Step 1: Search with summaries first
apple-docs:search_apple_docs(
  query: "NavigationStack",
  framework: "SwiftUI",
  summary_mode: true
)
→ Results include Path: documentation/SwiftUI/navigationstack.md

Step 2: Expand using the path from results
apple-docs:expand_result(
  file_path: "documentation/SwiftUI/navigationstack.md"
)

## Tool Reference

apple-docs:search_apple_docs - Find symbols, search documentation
apple-docs:expand_result - Get full documentation for a symbol
apple-docs:list_frameworks - Browse available frameworks

## Key Parameters

query: "NavigationStack" (use exact symbol names)
framework: "SwiftUI" (optional filter)
platform: "visionos" (ios/macos/visionos/watchos/tvos)
summary_mode: true (use for initial searches)
token_budget: 5000 (default, max 25000)

## Tips

- Always use summary_mode: true for initial searches
- Use full path from results for apple-docs:expand_result
- Symbol-only lookups resolve ambiguously across frameworks

Terminal

zip -r apple-docs.zip apple-docs/

Upload via Settings → Capabilities → Custom Skills. See the Claude Skills documentation for more.

Add to your Cursor MCP settings:

Cursor Settings → MCP

{
  "apple-docs": {
    "url": "https://xdocs.dev/mcp"
  }
}

Create .vscode/mcp.json in your workspace:

.vscode/mcp.json

{
  "servers": {
    "apple-docs": {
      "type": "http",
      "url": "https://xdocs.dev/mcp"
    }
  }
}

Add to your Copilot for Xcode extensions configuration:

Copilot for Xcode → Extensions

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://xdocs.dev/mcp"]
    }
  }
}

For clients supporting Streamable HTTP, connect directly to the server URL. For stdio-only clients, use mcp-remote as a proxy:

MCP Config

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://xdocs.dev/mcp"]
    }
  }
}

MCP Tools

Full control over search and retrieval

Token-aware responses, framework filtering, and complete documentation retrieval.

🔍

search_apple_docs

Full-text search with framework, platform, token_budget, summary_mode, and relevance_threshold options.

📄

expand_result

Retrieve full documentation for any symbol or file path.

📚

list_frameworks

Browse all 370+ frameworks with document counts.

Why xdocs

Pre-indexed and always instant

Unlike on-demand fetching, we've already done the work. Updated twice a week, every search is instant.

⚡

Meilisearch Powered

Instant results from a pre-built search index. No fetching required.

🥷

Agent Optimized

Token budgets, relevance scoring, and summary modes built for AI context windows.

📦

Complete Coverage

370+ frameworks, Human Interface Guidelines, Swift Language Guide, and MLX docs.

🤐

No Snooping

Zero query logging. No middleware. Your searches stay between you and your agent.

Free forever. If you find xdocs useful and want to help with server costs, you can buy me a coffee.

☕ Buy me a coffee