{
 "kind": "mcp",
 "slug": "ai-sosumi-sosumi",
 "path": "mcp/servers/ai-sosumi-sosumi/",
 "name": "Sosumi",
 "maker": "NSHipster",
 "density": "full",
 "crumbs": [
  [
   "MCP servers",
   "mcp/"
  ],
  [
   "Search and knowledge",
   "mcp/search/"
  ]
 ],
 "lead": "Apple developer docs your AI assistant can read.",
 "chips": [
  {
   "label": "Search and knowledge",
   "path": "mcp/search/"
  },
  {
   "label": "Remote"
  }
 ],
 "primary": {
  "label": "Copy connect command",
  "copy": "claude mcp add --transport http sosumi https://sosumi.ai/mcp"
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/NSHipster/sosumi.ai"
  },
  {
   "label": "Website",
   "href": "https://sosumi.ai"
  }
 ],
 "track": "New versions and outages of the remote endpoint on your dashboard",
 "verdicts": [
  {
   "key": "official",
   "label": "Made by",
   "value": "A third party",
   "status": "info",
   "sub": "Community server",
   "quote": "This is an unofficial, independent project and is not affiliated with or endorsed by Apple Inc.",
   "note": "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.",
   "src": "https://github.com/NSHipster/sosumi.ai/blob/2a6c686d91a5edeb7b699e23eae8d2afa151f7bd/README.md"
  },
  {
   "key": "secrets",
   "label": "Keys",
   "value": "No key needed",
   "status": "yes",
   "sub": "No account",
   "quote": "claude mcp add --transport http sosumi https://sosumi.ai/mcp",
   "note": "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.",
   "src": "https://sosumi.ai/llms.txt"
  },
  {
   "key": "where",
   "label": "Runs",
   "value": "Remote",
   "status": "yes",
   "sub": "Nothing runs on your machine",
   "note": "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.",
   "src": "https://sosumi.ai/mcp"
  },
  {
   "key": "license",
   "label": "Commercial use",
   "value": "Allowed",
   "status": "yes",
   "sub": "MIT license",
   "quote": "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",
   "note": "The code is MIT; Apple's content you read through it stays under Apple's terms.",
   "src": "https://github.com/NSHipster/sosumi.ai/blob/2a6c686d91a5edeb7b699e23eae8d2afa151f7bd/LICENSE.md"
  }
 ],
 "vfoot": "Checked against its repository at one commit, on Nov 10, 2026.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What Sosumi does",
   "parts": [
    {
     "t": "prose",
     "text": "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."
    },
    {
     "t": "h3",
     "text": "What people use it for"
    },
    {
     "t": "uses",
     "items": [
      {
       "title": "Correct Swift code from your assistant",
       "text": "When the assistant writes an iPhone or Mac app, it reads the current Apple page for each building block instead of guessing from memory.",
       "idea": false
      },
      {
       "title": "Read one Apple page as plain text",
       "text": "Take any developer.apple.com documentation address and get the same page as plain text, in a browser or from the command line.",
       "idea": false
      },
      {
       "title": "Follow Apple's design rules",
       "text": "Ask how buttons, colors or layout should look on iPhone, and the assistant reads Apple's Human Interface Guidelines for the answer.",
       "idea": false
      },
      {
       "title": "Learn from a WWDC talk",
       "text": "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.",
       "idea": false
      },
      {
       "title": "Docs for Swift packages",
       "text": "Many Swift packages publish their docs in Apple's DocC format on their own sites. Sosumi reads those pages too.",
       "idea": false
      },
      {
       "title": "Catch up on this year's WWDC",
       "text": "Ask the assistant to read the sessions about the frameworks your app uses and list what changed for you.",
       "idea": true
      }
     ]
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "Sosumi popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "492",
       "l": "GitHub stars, NSHipster/sosumi.ai"
      },
      {
       "n": "0",
       "l": "public agent projects connect it"
      }
     ]
    }
   ]
  },
  {
   "id": "tools",
   "nav": "Tools",
   "h2": "Tools it gives your agent (4)",
   "parts": [
    {
     "t": "tools",
     "items": [
      {
       "name": "searchAppleDocumentation",
       "text": "Searches Apple's developer documentation and returns titles, links, short descriptions and tags. Risk: read-only; sends the search text to Apple's documentation search through sosumi.ai."
      },
      {
       "name": "fetchAppleDocumentation",
       "text": "Fetches one page of Apple's documentation or Human Interface Guidelines by path, as Markdown. Risk: read-only."
      },
      {
       "name": "fetchExternalDocumentation",
       "text": "Fetches a page from a public Swift-DocC documentation site by its full https address, as Markdown. Risk: read-only; sosumi.ai fetches the address you give."
      },
      {
       "name": "fetchAppleVideoTranscript",
       "text": "Fetches the transcript of an Apple developer video, such as a WWDC session, as Markdown. Risk: read-only."
      }
     ]
    }
   ]
  },
  {
   "id": "data",
   "nav": "Data and license",
   "h2": "What it sends and its license",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Sends",
       "v": "the search text, documentation path or address the tool is called with",
       "sub": "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."
      },
      {
       "l": "Sends",
       "v": "IP address and headers of requests that fail or end abnormally",
       "sub": "To Cloudflare logs, kept up to 7 days; only for errors and unusual requests. Opt out: none on the hosted server."
      }
     ]
    },
    {
     "t": "prose",
     "text": "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."
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In a paid app",
       "v": "Yes",
       "status": "yes",
       "sub": "The code is MIT; Apple's content you read through it stays under Apple's terms.",
       "quote": "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",
       "src": "https://github.com/NSHipster/sosumi.ai/blob/2a6c686d91a5edeb7b699e23eae8d2afa151f7bd/LICENSE.md"
      },
      {
       "l": "Pass on its files",
       "v": "No",
       "status": "no",
       "sub": "Do not republish the Apple pages you get through it; the code itself may be shared with its MIT notice.",
       "quote": "Do not use this service to circumvent technical measures or for redistribution.",
       "src": "https://github.com/NSHipster/sosumi.ai/blob/2a6c686d91a5edeb7b699e23eae8d2afa151f7bd/README.md"
      }
     ]
    }
   ]
  },
  {
   "id": "alive",
   "nav": null,
   "spy_as": "data",
   "h2": "Is it alive",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Latest version",
       "v": "1.1.1 in the registry, updated Nov 9, 2026"
      },
      {
       "l": "Last release",
       "v": "1.1.1 on npm and in server.json (2026-11-09)"
      },
      {
       "l": "Remote endpoint",
       "v": "yes: https://sosumi.ai/mcp answered 406 (expects an MCP client) to one plain GET on 2026-11-10",
       "status": "yes"
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "Sosumi",
       "me": true,
       "facts": [
        "492 stars",
        "Remote"
       ]
      },
      {
       "name": "Context7",
       "why": "Pick it if you need current docs for many libraries outside Apple, such as web frameworks",
       "path": "mcp/servers/io-github-upstash-context7/",
       "facts": [
        "65K stars",
        "Remote",
        "in 1323 projects"
       ]
      },
      {
       "name": "io-github-yamadashy-repomix",
       "why": "Pick it if the assistant should read a whole code repository, not documentation pages",
       "path": null,
       "facts": [
        "Local"
       ]
      }
     ],
     "more": "All search and knowledge servers",
     "more_path": "mcp/search/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "prompt",
     "text": "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."
    },
    {
     "t": "h3",
     "text": "Connect it"
    },
    {
     "t": "tabs",
     "label": "Connect by client",
     "items": [
      {
       "tab": "Claude Code",
       "code": "claude mcp add --transport http sosumi https://sosumi.ai/mcp"
      },
      {
       "tab": "Cursor",
       "code": "Add to Cursor deep link on sosumi.ai, or a remote server with the url https://sosumi.ai/mcp"
      },
      {
       "tab": "Any client (JSON)",
       "code": "{\n  \"mcpServers\": {\n    \"sosumi\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://sosumi.ai/mcp\"]\n    }\n  }\n}"
      }
     ]
    },
    {
     "t": "small",
     "text": "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."
    },
    {
     "t": "h3",
     "text": "Mistakes to avoid"
    },
    {
     "t": "mistakes",
     "items": [
      {
       "dont": "Fetching https://developer.apple.com/documentation/... with a plain web fetch",
       "fix": "Swap the host to sosumi.ai or call fetchAppleDocumentation with the path",
       "why": "Apple's pages need JavaScript, so a plain fetch gets only a notice."
      },
      {
       "dont": "fetchAppleDocumentation with a guessed path",
       "fix": "Search with searchAppleDocumentation first, then fetch the best match",
       "why": "The skill's workflow says to search when the exact path is unknown."
      },
      {
       "dont": "Fetching a broad top-level page such as /documentation/swiftui to answer a specific question",
       "fix": "Fetch the specific symbol page, such as /documentation/swiftui/view",
       "why": "Symbol pages carry the exact signatures and availability."
      },
      {
       "dont": "Looping over many pages to copy a whole framework's docs",
       "fix": "Fetch only the pages the task needs",
       "why": "The service is on-demand, rate limited, and not for bulk download or redistribution."
      }
     ]
    }
   ]
  },
  {
   "id": "faq",
   "nav": "Questions",
   "h2": "Questions",
   "parts": [
    {
     "t": "faq",
     "items": [
      {
       "q": "Do I need an account or a key?",
       "a": "No. It has no accounts and does not ask for personal information.",
       "evidence": {
        "url": "https://sosumi.ai/privacy",
        "quote": "It has no accounts, and it doesn't ask for your name, email address, or other personal information."
       }
      },
      {
       "q": "Is it made by Apple?",
       "a": "No. It is an independent project, not affiliated with or endorsed by Apple.",
       "evidence": {
        "url": "https://github.com/NSHipster/sosumi.ai/blob/2a6c686d91a5edeb7b699e23eae8d2afa151f7bd/README.md",
        "quote": "This is an unofficial, independent project and is not affiliated with or endorsed by Apple Inc."
       }
      },
      {
       "q": "Can I use it without the hosted server?",
       "a": "Yes. The command-line tool runs on your computer and fetches from Apple directly, without sending requests to sosumi.ai.",
       "evidence": {
        "url": "https://sosumi.ai/privacy",
        "quote": "It fetches documentation directly from Apple and doesn't send requests to sosumi.ai."
       }
      },
      {
       "q": "Does it keep what I search for?",
       "a": "It has no database and does not save requests; only errors and unusual requests are logged, for up to 7 days.",
       "evidence": {
        "url": "https://sosumi.ai/privacy",
        "quote": "It doesn't have a database, and it doesn't save the requests it receives or the pages it returns."
       }
      }
     ]
    }
   ]
  }
 ],
 "glance": [
  [
   "Registry name",
   "ai.sosumi/sosumi"
  ],
  [
   "Category",
   "Search and knowledge"
  ],
  [
   "Version",
   "1.1.1"
  ],
  [
   "Remote endpoint",
   "https://sosumi.ai/mcp"
  ],
  [
   "License",
   "MIT"
  ],
  [
   "GitHub",
   "NSHipster/sosumi.ai"
  ],
  [
   "In the registry since",
   "Nov 9, 2026"
  ],
  [
   "Works with",
   "Claude Code, OpenAI Codex, OpenCode, LangChain, n8n, LangGraph"
  ]
 ],
 "good": [
  "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."
 ],
 "checked_line": "Read by AgentGid from 9 pages and files at one commit, checked Nov 10, 2026; stars update daily.",
 "logo": "https://agentgid.com/media/avatars/nshipster.png"
}