MCP server
- Format
- Streamable HTTP
The best option for an MCP-capable agent. It exposes read-only tools for profile retrieval, content listing, deterministic search, and document retrieval, plus every public document as a Markdown resource.
Use the protocol's server/discover RPC to inspect capabilities. An ordinary browser GET returns 405 because MCP clients communicate through protocol requests.
Markdown
- Format
- text/markdown
Use direct .md routes, request a normal page with Accept: text/markdown, or call the compatibility endpoint with a published path. Responses include YAML metadata, canonical URLs, ETags, and approximate token counts.
Start with llms.txt or the sitemap instead of guessing paths. Unknown documents return application/problem+json with a recovery hint.
OpenAPI
- Format
- OpenAPI 3.1 JSON
A typed description of the public HTTP operations, suitable for documentation generators and OpenAPI-based function calling. MCP remains a separate protocol and is identified as such in the document metadata.
Every documented HTTP operation has a unique operationId, a description, typed inputs, typed response representations where present, and structured error definitions.
Discovery
- Format
- RFC 9727 Linkset
The API catalog connects the MCP endpoint, Markdown API, OpenAPI description, this guide, and llms.txt. Global Link headers advertise the same resources from every public page.
The sitemap and llms.txt remain the simplest content indexes for crawlers that do not use MCP or OpenAPI.