BK

For agents / For developers

Brian Kimball developer resources

Machine-readable entry points and specifications for this site. There is no public authenticated HTTP API, write endpoint, or hosted MCP endpoint on this origin — these resources describe a curated subset of public read-only resources for agent discovery, markdown content negotiation, OpenAPI documentation, and public projects.

Machine-readable discovery

/openapi.jsonOpenAPI 3.1

Machine-readable OpenAPI 3.1 specification documenting a curated subset of public read-only GET endpoints, markdown negotiation, and negotiated JSON 404/406 Problem Details.

/llms.txtIndex

Curated markdown index for AI assistants following the llmstxt.org proposal.

/llms-full.txtCorpus

Full concatenated markdown archive of all published field notes and articles.

/index.mdMarkdown

Raw markdown variant of the homepage with structured navigation links.

Markdown content negotiation

Send Accept: text/markdown to any HTML page URL (for example / or/blog/high-availability/). The same path returnsContent-Type: text/markdown; charset=utf-8with Vary: Accept. Equivalent static files also live at index.mdnext to each page.

OpenAPI 3.1 specification

The OpenAPI document at /openapi.jsondocuments a curated subset of public read-only GET endpoints, markdown content negotiation rules, and negotiated RFC 9457 Problem Details schemas for JSON 404 and 406 error responses.

Discovery links in the HTML document head include:

  • <link rel="service-desc" type="application/json" href="https://brian-kimball.com/openapi.json" />
  • <link rel="describedby" type="text/markdown" href="https://brian-kimball.com/llms.txt" />
  • <link rel="alternate" type="application/rss+xml" href="https://brian-kimball.com/rss.xml" />

Public projects

Identity & contact