sosumi.ai - Apple Docs for LLMs

Ever notice Claude struggling to write Swift code? It might not be their fault!

Apple Developer docs are locked behind JavaScript, making them invisible to most LLMs. If they try to fetch it, all they see is This page requires JavaScript. Please turn on JavaScript in your browser and refresh the page to view its content.

This service translates Apple Developer documentation and Human Interface Guidelines into AI-friendly Markdown.

HTTP Usage

Replace developer.apple.com with sosumi.ai:

Original: https://developer.apple.com/documentation/swift/array
AI-readable: https://sosumi.ai/documentation/swift/array

Examples

MCP Usage

Connect your MCP client to https://sosumi.ai/mcp.

GitHub Copilot for Xcode

Open GitHub Copilot for Xcode and go to Settings…
Select the MCP tab
Click Edit Config
Enter the following configuration:

{  "servers": {  "sosumi": { "type": "http", "url": "https://sosumi.ai/mcp" } } }

For more information, see the GitHub Copilot for Xcode README.

Cursor

Click the button below to automatically install the sosumi MCP server:

For more information, see the Cursor documentation.

VSCode

Create a .vscode/mcp.json file in your workspace and enter the following configuration:

{  "servers": {  "sosumi": { "type": "http", "url": "https://sosumi.ai/mcp" } } }

For more information, see the VSCode documentation.

Claude Desktop

Open Claude Desktop
Go to Settings → Connectors
Click "Add custom connector"
Set "Name" to sosumi
Set "Remote MCP server URL" to https://sosumi.ai/mcp
Click "Add"

See the Claude Desktop documentation for more information.

Claude Code

Run the following command in your terminal:

claude mcp add --transport http sosumi https://sosumi.ai/mcp

For more information, see the Claude Code MCP documentation.

Other MCP Clients

Sosumi's MCP server supports Streamable HTTP and Server-Sent Events (SSE) transport. If your client supports either of these, configure it to connect directly to https://sosumi.ai/mcp.

Otherwise, you can run this command to proxy over stdio:

{  "mcpServers": {  "sosumi": { "command": "npx", "args": [ "-y", "mcp-remote", "https://sosumi.ai/mcp" ] } } }

Available Resources

doc://{path}

Apple Developer documentation and Human Interface Guidelines in Markdown format
Example: doc://swift/array returns Swift Array documentation
Example: doc://design/human-interface-guidelines/foundations/color returns HIG Color guidelines

Available Tools

searchAppleDocumentation

Searches Apple Developer documentation
Parameters: query (string)
Returns structured results with titles, URLs, descriptions, breadcrumbs, and tags
fetchAppleDocumentation

Fetches Apple Developer documentation and Human Interface Guidelines by path
Parameters: path (string) - Documentation path (e.g., '/documentation/swift', 'design/human-interface-guidelines/foundations/color')
Returns content as Markdown

Troubleshooting

If you're experiencing connection timeouts or network issues with the MCP server, you may need to configure a proxy. This is particularly common in corporate environments or regions with restricted internet access.

Configure your MCP client to use a proxy by adding environment variables:

{  "mcpServers": {  "sosumi": { "command": "npx", "args": [ "-y", "mcp-remote", "https://sosumi.ai/mcp" ], "env": { "HTTP_PROXY": "http://proxy.example.com:8080", "HTTPS_PROXY": "http://proxy.example.com:8080" } } } }

Replace proxy.example.com:8080 with your actual proxy server details. For authenticated proxies, use the format: http://username:password@proxy.example.com:8080