# Sosumi

The Sosumi MCP server for Claude Code searches Apple documentation and returns pages as Markdown. It can also retrieve HIG pages and WWDC session transcripts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 492 repo stars
- Author: NSHipster
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NSHipster/sosumi.ai
- Updated: 2026-10-21
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/sosumi

## What it does

Sosumi gives an agent searchable access to Apple Developer pages in Markdown. One tool searches by query and returns structured results; others retrieve API documentation, Human Interface Guidelines, and WWDC transcripts. Transcripts include session code samples when available.

The hosted endpoint uses Streamable HTTP at `https://sosumi.ai/mcp`. For MCP clients limited to stdio, the documented proxy runs `mcp-remote` through `npx`. Public Swift-DocC sites can also be fetched by HTTPS URL, unless their `robots.txt` blocks the Sosumi crawler.

In Claude Code, add the server with `claude mcp add --transport http sosumi https://sosumi.ai/mcp`. Setup for other clients depends on which MCP transports they support.

## Requirements
- Remote server: `https://sosumi.ai/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http sosumi https://sosumi.ai/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add sosumi --url https://sosumi.ai/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sosumi": {
            "url": "https://sosumi.ai/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "sosumi": {
            "type": "http",
            "url": "https://sosumi.ai/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http sosumi https://sosumi.ai/mcp
```

## When to use it
- search Apple Developer references by query
- retrieve API documentation as Markdown
- read a HIG page or WWDC transcript

## Example prompts
- Search Apple documentation for `SwiftData`.
- Fetch `/documentation/swiftui/view` as Markdown.
- Get the transcript at `/videos/play/wwdc2021/10133`.

## Similar
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/bingowon-mcp-server.md) — MCP server · ★ 117 repo stars
- [Apple Docs 2.0 MCP](https://affpapa.org/en/nevibecode/mcp/apple-docs-20-mcp.md) — MCP server · ★ 26 repo stars
- [wwdc](https://affpapa.org/en/nevibecode/skills/wwdc.md) — skill · 2800 installs
- [axiom-apple-docs](https://affpapa.org/en/nevibecode/skills/axiom-apple-docs.md) — skill · 1600 installs
- [swiftui](https://affpapa.org/en/nevibecode/skills/swiftui.md) — skill · 787 installs
- [swift-engineering](https://affpapa.org/en/nevibecode/plugins/swift-engineering.md) — plugin · ★ 233 repo stars

From the same set: [nshipster/sosumi.ai](https://affpapa.org/en/nevibecode/by/nshipster/sosumi.ai.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
