Agent Metadata Endpoints

The site exposes machine-readable metadata endpoints that describe crawl policy, content discovery, and agent behavior.

Endpoints

/robots.txt - Crawl permissions and sitemap discovery for legacy crawlers.
/sitemap.xml - XML sitemap for search engine indexing.
/sitemap.md - Human and LLM-friendly markdown sitemap grouped by content type.
/llms.txt - LLM usage guidance, markdown access notes, and discovery pointers.
/agents.md - Guidance for autonomous agents on how to interact with the site.
/api/openapi.json - OpenAPI 3.1 specification for the public JSON API (source of truth).
/api/content - Cross-type list/search endpoint.
/api/blogposts and /api/blogposts/{slug} - Blogpost list and detail endpoints.
/api/guides and /api/guides/{slug_path} - Guide list and detail endpoints.
/api/livestreams and /api/livestreams/{slug_path} - Livestream list and detail endpoints.
/api/kickstarts and /api/kickstarts/{slug_path} - Kickstart list and detail endpoints.
/api/pages and /api/pages/{slug_path} - Page list and detail endpoints.
/api/persons and /api/persons/{name} - Person list and detail endpoints.
/api/search/typeahead?q={query} - Search suggestion endpoint used by on-site search UX.

All endpoints are served as static routes with hourly revalidation.
agents.md includes a dynamically generated content index and access guidance.
The MCP server at /api/mcp provides content_search, content_get, people_get_profile, and people_list.
content_get supports blog posts, guides (including chapter sub-pages), livestreams, kickstarts, and person pages.
The public JSON API provides list/detail endpoints for blog posts, guides, livestreams, kickstarts, pages, and persons.