# serve.build

> serve.build documentation

## Docs

- [Installation](https://serve.build/docs/installation): How to add serve.build to a Java 25 Maven project. Covers prerequisites (Java 25 + preview features), module selection by layer, Maven dependency declarations, compiler plugin configuration, and module-info.java setup.
- [Introduction](https://serve.build/docs/introduction): Introduces serve.build — a lightweight Java 25 HTTP server framework built on jdk.httpserver, virtual threads, and structured concurrency. Covers the design philosophy (routes are code, explicit DI, JPMS-native), the module layers (core, protocol, middleware, template), and the key abstractions (Exchange, Handler, Router, Middleware).
- [Middleware](https://serve.build/docs/middleware): Explains middleware composition in serve.build — the Middleware functional interface, registration order (first = outermost), and the built-in middleware: logging, CORS, security headers, compression, JSON, health, and static files. Focuses on usage patterns rather than exhaustive configuration.
- [Protocols](https://serve.build/docs/protocols): Covers the protocol modules in serve.build — WebSocket (RFC 6455 over jdk.httpserver), Server-Sent Events (RFC 8895), Model Context Protocol (JSON-RPC 2.0 over HTTP), and GraphQL (SDL-first via graphql-java with GraphiQL IDE). Includes wiring patterns and key caveats for each.
- [Quickstart](https://serve.build/docs/quickstart): Step-by-step guide to running a serve.build HTTP server. Shows a minimal working application first, then covers Maven setup, module-info, and how to run the included example app. Requires Java 25 with preview features.
- [Routing](https://serve.build/docs/routing): Covers routing in serve.build — RouterBuilder DSL, route parameter patterns, sub-routers, the Exchange abstraction (request/response/attributes), path parameters, and error handling with HttpException subclasses.

## API

- [Full docs as markdown](https://serve.build/llms-full.txt): Complete documentation in a single markdown file
- [Structured JSON](https://serve.build/api/docs): All documentation pages as structured JSON

## MCP (Model Context Protocol)

For richer AI integration, connect via MCP at `https://serve.build/mcp` (Streamable HTTP transport).
Tools: search_docs, get_doc, get_all_docs. Resources: docs://index, docs://{slug}.