# Sosumi — MCP server card for AI agents

Search and read Apple developer documentation, HIG, and WWDC transcripts as Markdown.

Registry name: `ai.sosumi/sosumi` · category: Search and knowledge · version 1.1.1 · updated 2026-11-09

## Connect
- Remote (Claude Code): `claude mcp add --transport http sosumi https://sosumi.ai/mcp`

## Facts
- Repository: https://github.com/NSHipster/sosumi.ai (492 stars)
- Website: https://sosumi.ai

Before you connect a server: read its repository, and give it only the permissions and keys it needs.

## Links
- AgentGid page: https://agentgid.com/mcp/servers/ai-sosumi-sosumi/


## Sosumi: Apple developer docs your AI assistant can read

Apple's developer documentation only shows up in a browser that runs scripts, so AI assistants often cannot read it. Sosumi turns those pages, Apple's design guidelines and WWDC talk transcripts into plain text the assistant can read. It is free, needs no account and only reads; it changes nothing on your computer.

### Where to use it
- Correct Swift code from your assistant: When the assistant writes an iPhone or Mac app, it reads the current Apple page for each building block instead of guessing from memory.
- Read one Apple page as plain text: Take any developer.apple.com documentation address and get the same page as plain text, in a browser or from the command line.
- Follow Apple's design rules: Ask how buttons, colors or layout should look on iPhone, and the assistant reads Apple's Human Interface Guidelines for the answer.
- Learn from a WWDC talk: Give the assistant a WWDC session link and it reads the full transcript, so it can summarize the talk or use its advice in your code.
- Docs for Swift packages: Many Swift packages publish their docs in Apple's DocC format on their own sites. Sosumi reads those pages too.
- Catch up on this year's WWDC: Ask the assistant to read the sessions about the frameworks your app uses and list what changed for you. (idea, not from the official pages)

### How to start
- Add the server to your assistant. There is no account or key.

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

- For a client that only runs local servers, bridge to it with mcp-remote.

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


### License
The code is free under the MIT license. The Apple pages it shows stay Apple's; follow Apple's terms and do not use it to republish Apple content.

### Good to know
- It only reads documentation pages. It cannot change files, your code or any account.
- All rights in the pages stay with Apple. Use it to read while you work, not to copy Apple's docs into your own site.
- It converts one page when asked and has rate limits, so it is not meant for downloading whole doc sets.
- Your search words and page paths pass through sosumi.ai to Apple. Failed requests may be logged for up to 7 days.

Checked 2026-11-10 against: https://github.com/NSHipster/sosumi.ai/blob/2a6c686d91a5edeb7b699e23eae8d2afa151f7bd/README.md, https://github.com/NSHipster/sosumi.ai/blob/2a6c686d91a5edeb7b699e23eae8d2afa151f7bd/LICENSE.md, https://github.com/NSHipster/sosumi.ai/blob/2a6c686d91a5edeb7b699e23eae8d2afa151f7bd/server.json, https://github.com/NSHipster/sosumi.ai/blob/2a6c686d91a5edeb7b699e23eae8d2afa151f7bd/package.json, https://github.com/NSHipster/sosumi.ai/blob/2a6c686d91a5edeb7b699e23eae8d2afa151f7bd/src/lib/mcp.ts, https://github.com/NSHipster/sosumi.ai/blob/2a6c686d91a5edeb7b699e23eae8d2afa151f7bd/public/SKILL.md, https://sosumi.ai/llms.txt, https://sosumi.ai/privacy, https://registry.npmjs.org/@nshipster/sosumi

### Mistakes to avoid
- Don't: Fetching https://developer.apple.com/documentation/... with a plain web fetch → Do: Swap the host to sosumi.ai or call fetchAppleDocumentation with the path (Apple's pages need JavaScript, so a plain fetch gets only a notice.)
- Don't: fetchAppleDocumentation with a guessed path → Do: Search with searchAppleDocumentation first, then fetch the best match (The skill's workflow says to search when the exact path is unknown.)
- Don't: Fetching a broad top-level page such as /documentation/swiftui to answer a specific question → Do: Fetch the specific symbol page, such as /documentation/swiftui/view (Symbol pages carry the exact signatures and availability.)
- Don't: Looping over many pages to copy a whole framework's docs → Do: Fetch only the pages the task needs (The service is on-demand, rate limited, and not for bulk download or redistribution.)

### Questions
- Do I need an account or a key? No. It has no accounts and does not ask for personal information.
- Is it made by Apple? No. It is an independent project, not affiliated with or endorsed by Apple.
- Can I use it without the hosted server? Yes. The command-line tool runs on your computer and fetches from Apple directly, without sending requests to sosumi.ai.
- Does it keep what I search for? It has no database and does not save requests; only errors and unusual requests are logged, for up to 7 days.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
