springdoc/springdoc-openapi

Health v2 · maintenance only

Adoption not part of the score

3737 stars · 601 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

springdoc-openapi is a Java library that automatically generates OpenAPI 3 API documentation for Spring Boot applications, with built-in Swagger UI and Scalar integration. It supports Spring WebMvc, WebFlux, Spring Security, Spring Data REST, Hateoas, Kotlin, and now exposes Spring REST endpoints as MCP tools for AI agents.

Use cases

• generate openapi 3 spec from spring boot controllers
• add swagger ui to a spring boot rest api
• document spring webflux endpoints automatically
• migrate from springfox to openapi 3
• expose spring boot rest api as mcp tools for ai agents
• generate api docs in json and yaml from spring mvc
• secure and document oauth2 apis with spring security

When to choose

• you have a Spring Boot (MVC or WebFlux) REST API and want auto-generated OpenAPI 3 docs
• you want an embedded Swagger UI or Scalar viewer with minimal configuration
• you need Spring Security, Data REST, Hateoas, or Actuator-aware API documentation
• you want to expose your Spring endpoints as MCP tools with guardrails for AI agents

When to avoid

• your backend is not Spring-based (use framework-native OpenAPI tools instead)
• you need OpenAPI 2.0/Swagger 2.0 output rather than OpenAPI 3
• you want hand-authored, fully controlled API specs rather than code-first generation

Facets

library · maturity stable

api-documentation documentation mcp middleware apis web-development backend documentation developer-tools jvm self-hosted openapi swagger-ui spring-boot rest-api api-specification spring-webflux spring-security springdoc ai-agents spring

Member repositories

For agents

markdown · JSON · MCP: product_card(name="springdoc/springdoc-openapi")