Apple Docs MCP Server

{
  "type": "object",
  "properties": {
    "topicId": {
      "type": "string",
      "description": "Topic ID to explore. Available IDs: \"accessibility-inclusion\", \"app-services\", \"app-store-distribution-marketing\", \"audio-video\", \"business-education\", \"design\", \"developer-tools\", \"essentials\", \"graphics-games\", \"health-fitness\", \"machine-learning-ai\", \"maps-location\", \"photos-camera\", \"privacy-security\", \"safari-web\", \"spatial-computing\", \"swift\", \"swiftui-ui-frameworks\", \"system-services\". Leave empty to see all topics with video counts."
    },
    "includeVideos": {
      "type": "boolean",
      "description": "List videos in the topic. Set false for topic structure only. Default: true"
    },
    "year": {
      "type": "string",
      "description": "Filter topic videos by year. Only when browsing specific topic."
    },
    "limit": {
      "type": "number",
      "description": "Max videos per topic (default: 20)."
    }
  },
  "required": []
}

{
  "type": "object",
  "properties": {
    "videoId": {
      "type": "string",
      "description": "Source video ID. Example: \"10101\" for keynote."
    },
    "year": {
      "type": "string",
      "description": "Source video year. Example: \"2025\""
    },
    "includeExplicitRelated": {
      "type": "boolean",
      "description": "Include Apple's recommended related videos. Usually prerequisites or follow-ups. Default: true"
    },
    "includeTopicRelated": {
      "type": "boolean",
      "description": "Include videos from same topic categories. Good for comprehensive learning. Default: true"
    },
    "includeYearRelated": {
      "type": "boolean",
      "description": "Include other videos from same WWDC. Default: false"
    },
    "limit": {
      "type": "number",
      "description": "Max related videos (default: 15)."
    }
  },
  "required": [
    "videoId",
    "year"
  ]
}

{
  "type": "object",
  "properties": {
    "apiUrl": {
      "type": "string",
      "description": "Starting API URL. Example: \"https://developer.apple.com/documentation/uikit/uialertview\" (finds modern alternatives)"
    },
    "searchDepth": {
      "type": "string",
      "enum": [
        "shallow",
        "medium",
        "deep"
      ],
      "description": "How thoroughly to search. \"shallow\" = direct recommendations only, \"medium\" = topic siblings, \"deep\" = full relationship analysis. Default: \"medium\""
    },
    "filterByCategory": {
      "type": "string",
      "description": "Focus on specific functionality like \"Animation\", \"Navigation\", \"Data\". Case-sensitive partial match."
    },
    "includeAlternatives": {
      "type": "boolean",
      "description": "Include functionally similar APIs that might be better choices. Default: true"
    }
  },
  "required": [
    "apiUrl"
  ]
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Full URL of the Apple Developer Documentation page. Must start with https://developer.apple.com/documentation/. Example: \"https://developer.apple.com/documentation/uikit/uiviewcontroller\""
    },
    "includeRelatedApis": {
      "type": "boolean",
      "description": "Include inheritance hierarchy and protocol conformances. Useful for understanding API relationships. Default: false"
    },
    "includeReferences": {
      "type": "boolean",
      "description": "Resolve and include all referenced types and APIs. Helps understand dependencies. Default: false"
    },
    "includeSimilarApis": {
      "type": "boolean",
      "description": "Discover APIs with similar functionality. Great for finding alternatives. Default: false"
    },
    "includePlatformAnalysis": {
      "type": "boolean",
      "description": "Analyze platform availability and version requirements. Essential for cross-platform development. Default: false"
    }
  },
  "required": [
    "url"
  ]
}

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "all",
        "wwdc",
        "technology",
        "release-notes"
      ],
      "description": "Update type filter. \"wwdc\" = conference highlights, \"technology\" = API updates, \"release-notes\" = version changes. Default: \"all\""
    },
    "technology": {
      "type": "string",
      "description": "Filter by framework (case-sensitive). Examples: \"SwiftUI\", \"UIKit\", \"ARKit\". Get names from list_technologies."
    },
    "year": {
      "type": "string",
      "description": "WWDC year filter (\"2025\", \"2024\", etc.). Only for wwdc category."
    },
    "searchQuery": {
      "type": "string",
      "description": "Search keywords. Examples: \"async\", \"performance\", \"widgets\". Case-insensitive."
    },
    "includeBeta": {
      "type": "boolean",
      "description": "Include beta/preview features. Default: true"
    },
    "limit": {
      "type": "number",
      "description": "Max results (default: 50). Sorted by relevance and date."
    }
  },
  "required": []
}

{
  "type": "object",
  "properties": {
    "apiUrl": {
      "type": "string",
      "description": "API URL to check compatibility. Example: \"https://developer.apple.com/documentation/swiftui/list\""
    },
    "compareMode": {
      "type": "string",
      "enum": [
        "single",
        "framework"
      ],
      "description": "Check single API or entire framework. \"framework\" shows all APIs in the framework. Default: \"single\""
    },
    "includeRelated": {
      "type": "boolean",
      "description": "Also check related APIs' compatibility. Useful for finding platform-specific alternatives. Default: false"
    }
  },
  "required": [
    "apiUrl"
  ]
}

{
  "type": "object",
  "properties": {
    "apiUrl": {
      "type": "string",
      "description": "Apple documentation URL to analyze. Example: \"https://developer.apple.com/documentation/uikit/uiview\""
    },
    "includeInherited": {
      "type": "boolean",
      "description": "Show inherited methods/properties from superclasses. Helps understand full API surface. Default: true"
    },
    "includeConformance": {
      "type": "boolean",
      "description": "Show protocol conformances and requirements. Essential for protocol-oriented programming. Default: true"
    },
    "includeSeeAlso": {
      "type": "boolean",
      "description": "Show Apple's recommended related APIs. Great for finding better alternatives or complementary APIs. Default: true"
    }
  },
  "required": [
    "apiUrl"
  ]
}

{
  "type": "object",
  "properties": {
    "framework": {
      "type": "string",
      "description": "Framework filter (case-insensitive). Examples: \"SwiftUI\", \"ARKit\", \"CoreML\". Note: Some samples are under generic categories - use searchQuery for better results."
    },
    "beta": {
      "type": "string",
      "enum": [
        "include",
        "exclude",
        "only"
      ],
      "description": "Beta samples: \"include\" = all, \"exclude\" = stable only, \"only\" = beta only. Default: \"include\""
    },
    "searchQuery": {
      "type": "string",
      "description": "Search keywords. Most effective approach. Examples: \"animation\", \"camera\", \"machine learning\", \"widgets\"."
    },
    "limit": {
      "type": "number",
      "description": "Max results (default: 50)."
    }
  },
  "required": []
}

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Topic category. Popular: \"app-design-and-ui\", \"games\", \"ai-machine-learning\", \"augmented-reality\", \"privacy-and-security\". Leave empty to browse all."
    },
    "platform": {
      "type": "string",
      "enum": [
        "all",
        "ios",
        "macos",
        "watchos",
        "tvos",
        "visionos"
      ],
      "description": "Target platform. \"all\" for cross-platform content. Default: \"all\""
    },
    "searchQuery": {
      "type": "string",
      "description": "Search terms. Try: \"getting started\", \"best practices\", \"architecture\", \"performance\"."
    },
    "includeSubcategories": {
      "type": "boolean",
      "description": "Include nested topics for comprehensive results. Set false for overview only. Default: true"
    },
    "limit": {
      "type": "number",
      "description": "Max results (default: 50). Includes subcategories when enabled."
    }
  },
  "required": []
}

{
  "type": "object",
  "properties": {
    "framework": {
      "type": "string",
      "description": "Framework to find examples for. Examples: \"SwiftUI\", \"SwiftData\", \"RealityKit\"."
    },
    "topic": {
      "type": "string",
      "description": "Topic ID or concept keyword. Can use exact topic IDs (\"swiftui-ui-frameworks\", \"machine-learning-ai\", etc.) for precise filtering, or general keywords like \"animation\", \"performance\", \"concurrency\" for broader search."
    },
    "year": {
      "type": "string",
      "description": "WWDC year filter (\"2025\", \"2024\", etc.)."
    },
    "language": {
      "type": "string",
      "description": "Programming language: \"swift\", \"objc\", \"javascript\", \"metal\"."
    },
    "limit": {
      "type": "number",
      "description": "Max examples (default: 30). Each includes code and source video info."
    }
  },
  "required": []
}

{
  "type": "object",
  "properties": {
    "year": {
      "type": "string",
      "description": "WWDC year. Example: \"2025\""
    },
    "videoId": {
      "type": "string",
      "description": "Session ID. Example: \"10101\" for keynote, \"238\" for session 238."
    },
    "includeTranscript": {
      "type": "boolean",
      "description": "Include full session transcript with timestamps. Default: true"
    },
    "includeCode": {
      "type": "boolean",
      "description": "Include all code examples from the session. Default: true"
    }
  },
  "required": [
    "year",
    "videoId"
  ]
}

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Filter by category (case-sensitive). Popular: \"App frameworks\" (SwiftUI, UIKit), \"Graphics and games\" (Metal, SpriteKit), \"App services\" (CloudKit, StoreKit), \"Media\" (AVFoundation), \"System\" (Foundation). Leave empty to see all categories."
    },
    "language": {
      "type": "string",
      "enum": [
        "swift",
        "occ"
      ],
      "description": "Filter by language support. \"swift\" for Swift-compatible frameworks, \"occ\" for Objective-C. Leave empty for all."
    },
    "includeBeta": {
      "type": "boolean",
      "description": "Include beta/preview technologies. Set to false to see only stable frameworks. Default: true"
    },
    "limit": {
      "type": "number",
      "description": "Max results per category. Useful for quick overviews. Default: 200"
    }
  },
  "required": []
}

{
  "type": "object",
  "properties": {
    "year": {
      "type": "string",
      "description": "WWDC year (\"2025\", \"2024\", etc.) or \"all\". Available: 2020-2025. Example: \"2025\" for latest."
    },
    "topic": {
      "type": "string",
      "description": "Topic ID for exact filtering or keyword for title search. Available topic IDs: \"accessibility-inclusion\", \"app-services\", \"app-store-distribution-marketing\", \"audio-video\", \"business-education\", \"design\", \"developer-tools\", \"essentials\", \"graphics-games\", \"health-fitness\", \"machine-learning-ai\", \"maps-location\", \"photos-camera\", \"privacy-security\", \"safari-web\", \"spatial-computing\", \"swift\", \"swiftui-ui-frameworks\", \"system-services\". Use exact ID for topic filtering, or any keyword to search in video titles."
    },
    "hasCode": {
      "type": "boolean",
      "description": "Filter by code availability. true = sessions with code, false = without code. Leave empty for all."
    },
    "limit": {
      "type": "number",
      "description": "Max videos to show (default: 50). Videos include title, duration, and content indicators."
    }
  },
  "required": []
}

{
  "type": "object",
  "properties": {},
  "required": []
}

{
  "type": "object",
  "properties": {
    "sourceUrl": {
      "type": "string",
      "description": "Documentation URL to analyze for references. Example: \"https://developer.apple.com/documentation/swiftui/view\""
    },
    "maxReferences": {
      "type": "number",
      "description": "Limit resolved references (default: 20, max: 50). Higher values = more comprehensive but slower.",
      "minimum": 1,
      "maximum": 50
    },
    "filterByType": {
      "type": "string",
      "enum": [
        "all",
        "symbol",
        "collection",
        "article",
        "protocol",
        "class",
        "struct",
        "enum"
      ],
      "description": "Filter by reference type. Use \"protocol\" for protocol requirements, \"class\" for class hierarchies. Default: \"all\""
    }
  },
  "required": [
    "sourceUrl"
  ]
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query for Apple Developer Documentation. Tips: Use specific API names (e.g., \"UIViewController\"), framework names (e.g., \"SwiftUI\"), or technical terms. Avoid generic terms like \"how to\" or \"tutorial\". Examples: \"NSPredicate\", \"SwiftUI List\", \"Core Data migration\", \"URLSession authentication\"."
    },
    "type": {
      "type": "string",
      "enum": [
        "all",
        "documentation",
        "sample"
      ],
      "description": "Type of content to filter. Use \"all\" for comprehensive results, \"documentation\" for API references/guides, \"sample\" for code snippets. Note: \"sample\" returns individual code examples, not full projects. For complete sample projects, use get_sample_code instead. Default: \"all\"."
    }
  },
  "required": [
    "query"
  ]
}

{
  "type": "object",
  "properties": {
    "framework": {
      "type": "string",
      "description": "Framework identifier in lowercase. Common: \"uikit\", \"swiftui\", \"foundation\", \"combine\", \"coredata\". Get exact names from list_technologies. Example: \"swiftui\" for SwiftUI framework."
    },
    "symbolType": {
      "type": "string",
      "enum": [
        "all",
        "class",
        "struct",
        "enum",
        "protocol",
        "method",
        "property",
        "init",
        "func",
        "var",
        "let",
        "typealias"
      ],
      "description": "Filter by symbol type. Use \"class\" for UIViewController subclasses, \"protocol\" for delegates, \"struct\" for value types. Default: \"all\" shows everything."
    },
    "namePattern": {
      "type": "string",
      "description": "Filter by name pattern. Use \"*View\" for all views, \"UI*\" for UI-prefixed symbols, \"*Delegate\" for delegates. Case-sensitive. Leave empty for all symbols."
    },
    "language": {
      "type": "string",
      "enum": [
        "swift",
        "occ"
      ],
      "description": "Language preference. Some APIs differ between Swift and Objective-C. Default: \"swift\""
    },
    "limit": {
      "type": "number",
      "description": "Results limit (default: 50, max: 200). Includes nested symbols.",
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "framework"
  ]
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search terms. Examples: \"async await\", \"@Observable\", \"Vision Pro\", \"performance optimization\"."
    },
    "searchIn": {
      "type": "string",
      "enum": [
        "transcript",
        "code",
        "both"
      ],
      "description": "Search scope. \"transcript\" = spoken content, \"code\" = code examples only, \"both\" = everything. Default: \"both\""
    },
    "year": {
      "type": "string",
      "description": "Limit to specific year (\"2025\", \"2024\", etc.). Leave empty for all years."
    },
    "language": {
      "type": "string",
      "description": "Code language filter (\"swift\", \"objc\", \"javascript\"). Only for code search."
    },
    "limit": {
      "type": "number",
      "description": "Max results (default: 20). Results include context snippets."
    }
  },
  "required": [
    "query"
  ]
}