# osama.me developer resources

> Scoped context for the machine-readable surface of osama.me. The whole-site
> version is at https://osama.me/llms.txt

## Endpoints

- [Content API](https://osama.me/api/v1): read-only JSON for the profile, work history, initiatives, products, projects, events, posts, press, and page text. No authentication.
- [OpenAPI 3.1 spec](https://osama.me/openapi.json): every operation with a unique operationId, typed schemas, and descriptions, ready for function calling.
- [MCP server](https://osama.me/api/mcp): Model Context Protocol over Streamable HTTP, JSON-RPC 2.0 on POST. 13 read-only tools. No authentication.
- [MCP discovery](https://osama.me/.well-known/mcp.json): server description and tool list.
- [Ask endpoint](https://osama.me/ask?query=design%20battlefield): natural-language search over the site, JSON or server-sent events.
- [Schema feed](https://osama.me/schema-feed.jsonl): the whole entity graph as JSON Lines, one schema.org object per line.
- [Agent skills index](https://osama.me/.well-known/agent-skills/index.json): what an agent can do with this site.
- [AI catalog](https://osama.me/.well-known/ai-catalog.json) and [API catalog](https://osama.me/.well-known/api-catalog) (RFC 9727).
- [auth.md](https://osama.me/auth.md): there is no authentication, stated in the shape of an auth guide.

## Content files

- [llms.txt](https://osama.me/llms.txt): short context for the whole site.
- [llms-full.txt](https://osama.me/llms-full.txt): every page as one Markdown document.
- [sitemap.xml](https://osama.me/sitemap.xml): every URL, with real lastmod dates.
- [feed.xml](https://osama.me/feed.xml): RSS 2.0 for the blog.

## Markdown negotiation

Every page answers `Accept: text/markdown`, or add `.md` to any URL, or append
`?mode=agent`. Responses carry `Vary: Accept`, HTML advertises its Markdown
sibling with a `Link: rel="alternate"` header, and an unsatisfiable `Accept`
returns `406` listing what is available. See https://acceptmarkdown.com

## Open source

- [OK Skills](https://github.com/byosamah/ok-skills): open-source Claude Code skills and plugins. Also at https://skills.osama.me

## Contact

ok@osama.me