Data and MCP server
Everything on sosx.ai is public, and the site publishes what it says as data too, so software can read it without scraping the pages. It is all read-only: nothing here signs anyone up, sends a message or changes anything, and there is no key to ask for.
Each JSON document says where its words come from (source, the page they are taken
from) and when it was built (generated). The files are rebuilt with the site, from the
same content as the pages, so the data and the pages never disagree.
The data API
Static JSON over HTTPS, GET only. The OpenAPI 3.1 description is /api/v1/openapi.json, and the API catalog (RFC 9727) is /.well-known/api-catalog.
- /api/v1/editions.json: editions
- /api/v1/books.json: books
- /api/v1/videos.json: videos
- /api/v1/events.json: events
- /api/v1/pages.json: pages
The MCP server
A read-only Model Context Protocol server at https://sosx.ai/mcp (Streamable HTTP, POST; protocol versions 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26). Add it to an MCP client as a remote server; it needs no authentication. Its server card is https://sosx.ai/mcp/server-card. The same tools are offered to AI agents in the browser on every page, through WebMCP.
search_site: Search every public page of sosx.ai by its title, headings and description. Returns the best-matching pages with their URLs and a Markdown copy of each.list_editions: List the SOSX Editions (SOSX set up for one field each), with each one's status, summary, page, book and videos.get_edition: One SOSX Edition by its slug (e.g. 'engineering') or name (e.g. 'SOSX Engineering'), with its lead sentence, summary, page, Markdown copy, book and videos.list_books: List the SOSX book series: each book's title, subtitle, audience, the edition it accompanies, whether a copy is offered now, and its page.list_videos: List the short narrated SOSX videos with their watch pages and full transcripts, optionally only those whose title, description or transcript holds every word of a query.list_events: List events SOSX or Digital Tactics is at. 'upcoming' (the default) runs until an event's last day is over, judged on today's date in UTC.
Pages as Markdown
Request any page with Accept: text/markdown and it comes back as Markdown, or add index.md to its address.
For agents
An agent skill that explains how to answer questions about SOSX from this data is at /.well-known/agent-skills/sosx-site-data/SKILL.md, listed in /.well-known/agent-skills/index.json. How authentication works here (it does not: everything is public) is in /auth.md.
SOSX itself, the platform, is a separate application with its own sign-in. To ask about using it, talk to us.