1. Made by
“This is an unofficial, independent project and is not affiliated with or endorsed by Apple Inc.”
It reads Apple's documentation but is not made by Apple. The repository belongs to NSHipster and the README calls it an unofficial, independent project.
github.com/NSHipster/sosumi.ai/blob/2a6c686d91a5edeb7b699e23eae8d2afa151f7bd/README.md2. Keys
“claude mcp add --transport http sosumi https://sosumi.ai/mcp”
No account and no key. Claude Code can also install the plugin, which adds the server and a Sosumi skill. The README gives no Codex server config; any client with remote server support uses the same URL.
sosumi.ai/llms.txt3. Runs
Endpoint: https://sosumi.ai/mcp. Checked: yes: https://sosumi.ai/mcp answered 406 (expects an MCP client) to one plain GET on 2026-11-10.
sosumi.ai/mcp4. Commercial use
“Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction”
The code is MIT; Apple's content you read through it stays under Apple's terms.
github.com/NSHipster/sosumi.ai/blob/2a6c686d91a5edeb7b699e23eae8d2afa151f7bd/LICENSE.mdChecked against its repository at one commit, on Nov 10, 2026. Tap a verdict to see its source.How we checkedReport an error
What Sosumi does
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.
What people use it for
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 Idea
Ask the assistant to read the sessions about the frameworks your app uses and list what changed for you.
Sosumi popularity
Tools it gives your agent (4)
What it sends and its license
the search text, documentation path or address the tool is called with
To sosumi.ai (Cloudflare Workers), then Apple's documentation site or search, or the Swift-DocC host you name; on each tool call. Opt out: use the command-line tool, which fetches from Apple directly.
IP address and headers of requests that fail or end abnormally
To Cloudflare logs, kept up to 7 days; only for errors and unusual requests. Opt out: none on the hosted server.
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.
The code is MIT; Apple's content you read through it stays under Apple's terms.
“Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction” source
Do not republish the Apple pages you get through it; the code itself may be shared with its MIT notice.
“Do not use this service to circumvent technical measures or for redistribution.” source
Is it alive
1.1.1 in the registry, updated Nov 9, 2026
1.1.1 on npm and in server.json (2026-11-09)
Alternatives
Sosumi This page
Pick it if you need current docs for many libraries outside Apple, such as web frameworks
io-github-yamadashy-repomix
Pick it if the assistant should read a whole code repository, not documentation pages
Get started
Tell your AI assistant
“Connect the Sosumi server at https://sosumi.ai/mcp and, before you write any SwiftUI code, fetch the Apple docs for each API you use and check its availability.”
Connect it
claude mcp add --transport http sosumi https://sosumi.ai/mcpAdd to Cursor deep link on sosumi.ai, or a remote server with the url https://sosumi.ai/mcp{
"mcpServers": {
"sosumi": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://sosumi.ai/mcp"]
}
}
}No account and no key. Claude Code can also install the plugin, which adds the server and a Sosumi skill. The README gives no Codex server config; any client with remote server support uses the same URL.
Mistakes to avoid
Apple's pages need JavaScript, so a plain fetch gets only a notice.
The skill's workflow says to search when the exact path is unknown.
Symbol pages carry the exact signatures and availability.
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.