Osama Khalil Developer Resources

Everything on this site that is meant to be read by a machine rather than a person: open-source code, an MCP server, and the structured files that describe osama.me to AI agents and crawlers. If you are looking for the human version, start at the homepage or The Lab.

Content API

A read-only JSON API over everything this site publishes. No key, no signup, no rate limit to negotiate. It is the same content the pages show, shaped for a program instead of a reader.

curl https://osama.me/api/v1                      # every endpoint, described
curl https://osama.me/api/v1/profile              # who I am, contact, links
curl https://osama.me/api/v1/events               # every event I have run
curl https://osama.me/api/v1/posts/how-i-built-a-40k-design-community-in-mena
curl "https://osama.me/api/v1/search?q=design%20battlefield"

The full contract lives in an OpenAPI 3.1 document at /openapi.json. Every operation has a unique operationId, a typed response schema, and a description, so it drops straight into an LLM function-calling setup. Errors are always JSON, never an HTML page:

{
  "error": {
    "code": "not_found",
    "message": "No event exists with the slug \"nope\".",
    "resolution": "List everything available at https://osama.me/api/v1/events.",
    "status": 404,
    "documentation_url": "https://osama.me/openapi.json"
  }
}

MCP server for this site

The same content as native tools, over the Model Context Protocol. Streamable HTTP transport, JSON-RPC 2.0 on POST, no authentication. Point any MCP client at it:

{
  "mcpServers": {
    "osama-me": {
      "type": "http",
      "url": "https://osama.me/api/mcp"
    }
  }
}

Thirteen read-only tools: get_profile, list_work, list_initiatives, list_products, list_projects, list_events, get_event, list_posts, get_post, list_media, list_pages, get_page, and search_content. Every page is also exposed as an MCP resource. Discovery lives at /.well-known/mcp.json, and the capability index at /.well-known/agent-skills/index.json.

Open source

OK Skills github.com/byosamah/ok-skills

An open-source collection of Claude Code skills and plugins. Install them into your own Claude Code setup. Also reachable at skills.osama.me, which redirects to the repository.

Other MCP servers

Beyond this site's own server above, one more Model Context Protocol endpoint you can connect an AI client to.

Halulu MCP hih.osama.me/api/mcp

The MCP server behind Halulu is Hungry, the AI restaurant finder built on Google Maps reviews. Search restaurants, save favourites, and share results from inside an AI client. Requires a bearer token: connect through the app at hih.osama.me.

Machine-readable files

Stable URLs. None of them require authentication, and all of them are safe to poll.

openapi.json osama.me/openapi.json

OpenAPI 3.1 description of the content API, ready for function calling.

llms.txt osama.me/llms.txt

The short context file: who Osama Khalil is, what this site covers, and where each section lives.

llms-full.txt osama.me/llms-full.txt

Every public page of this site as one Markdown document, for a single-fetch ingest.

sitemap.xml osama.me/sitemap.xml

Every public URL, regenerated every five minutes so scheduled posts appear on time.

feed.xml osama.me/feed.xml

RSS 2.0 feed of the blog.

robots.txt osama.me/robots.txt

Crawl rules. AI crawlers are allowed on purpose: GPTBot, ClaudeBot, PerplexityBot, and Google-Extended.

Markdown content negotiation

Every public page here answers on one URL with two representations: HTML for browsers, Markdown for agents. The implementation follows acceptmarkdown.com and RFC 9110 section 12.5.1.

Ask for Markdown

curl -H "Accept: text/markdown" https://osama.me/
curl -H "Accept: text/markdown" https://osama.me/blog

Or add .md to any URL

curl https://osama.me/index.md
curl https://osama.me/events/farid-omara-in-amman.md
curl "https://osama.me/about?mode=agent"

Scoped context files exist for the busy areas: /developers/llms.txt, /blog/llms.txt, and /events/llms.txt. Markdown and 406 responses carry Vary: Accept. HTML responses advertise their Markdown sibling with a Link: rel="alternate" header. An Accept header this site cannot satisfy gets a 406 Not Acceptable that lists what is available, rather than a silent fallback.

Experiments and prototypes

The running experiments, each on its own osama.me subdomain, are listed on The Lab: a Three.js games portal, a Claude usage tracker, a booking app, and Halulu is Hungry.

Something here broken or missing? Email ok@osama.me.