Prepare for next release 2.8.17/3.0.3

Author: bnasslahsen

docs/faq.html

@@ -2004,7 +2004,7 @@ <h3 id="_what_is_the_compatibility_matrix_of_springdoc_openapi_with_spring_boot"
 <p><code>springdoc-openapi 2.x</code> is compatible with <code>spring-boot 3</code>.</p>
 </div>
 <div class="paragraph">
-<p>In general, <strong>you should only pick the last stable version as per today 2.8.16.</strong></p>
+<p>In general, <strong>you should only pick the last stable version as per today 2.8.17.</strong></p>
 </div>
 <div class="paragraph">
 <p>More precisely, this the exhaustive list of spring-boot versions against which <code>springdoc-openapi</code> has been built:</p>

docs/getting-started.html

@@ -40,7 +40,7 @@ <h2 id="getting-started"><a class="anchor" href="#getting-started"></a>Getting S
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webmvc-ui&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>

docs/index.html

@@ -16,7 +16,7 @@
 <meta property="og:site_name" content="OpenAPI 3 Library for spring-boot" />
 <meta property="og:image" content="https://springdoc.org/img/banner-logo.svg" />
 <meta name="author" content="Library for OpenAPI 3 with spring-boot By Badr NASS LAHSEN">
-<title>springdoc-openapi v2.8.16</title>
+<title>springdoc-openapi v2.8.17</title>
 <link rel="stylesheet" href="css/site.css">
 <style>
     #header #revnumber {
@@ -53,7 +53,7 @@
   <div id="main" class="contained">
     <div id="doc" class="doc">
 <div id="header">
-<h1>springdoc-openapi v2.8.16</h1>
+<h1>springdoc-openapi v2.8.17</h1>
 <div id="toc" class="toc2">
 <div id="toctitle">Table of Contents</div>
 <ul class="sectlevel1">
@@ -319,7 +319,7 @@ <h2 id="getting-started"><a class="anchor" href="#getting-started"></a>2. Gettin
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webmvc-ui&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>
@@ -427,7 +427,7 @@ <h3 id="spring-webmvc-support"><a class="anchor" href="#spring-webmvc-support"><
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webmvc-api&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>
@@ -479,7 +479,7 @@ <h3 id="spring-webflux-support"><a class="anchor" href="#spring-webflux-support"
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webflux-api&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>
@@ -501,7 +501,7 @@ <h3 id="swagger-ui-support"><a class="anchor" href="#swagger-ui-support"></a>3.4
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webmvc-ui&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>
@@ -517,7 +517,7 @@ <h3 id="swagger-ui-support"><a class="anchor" href="#swagger-ui-support"></a>3.4
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webflux-ui&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>
@@ -560,7 +560,7 @@ <h3 id="scalar-support"><a class="anchor" href="#scalar-support"></a>3.5. Scalar
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webmvc-scalar&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>
@@ -576,7 +576,7 @@ <h3 id="scalar-support"><a class="anchor" href="#scalar-support"></a>3.5. Scalar
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webflux-scalar&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>
@@ -1079,7 +1079,7 @@ <h3 id="springdoc-openapi-bom"><a class="anchor" href="#springdoc-openapi-bom"><
             &lt;dependency&gt;
                 &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
                 &lt;artifactId&gt;springdoc-openapi-bom&lt;/artifactId&gt;
-                &lt;version&gt;2.8.16&lt;/version&gt;
+                &lt;version&gt;2.8.17&lt;/version&gt;
                 &lt;type&gt;pom&lt;/type&gt;
                 &lt;scope&gt;import&lt;/scope&gt;
             &lt;/dependency&gt;
@@ -2379,7 +2379,7 @@ <h2 id="migrating-from-springfox"><a class="anchor" href="#migrating-from-spring
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webmvc-ui&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>
@@ -4695,7 +4695,7 @@ <h3 id="what-is-the-compatibility-matrix-of-springdoc-openapi-with-spring-boot">
 <p><code>springdoc-openapi 2.x</code> is compatible with <code>spring-boot 3</code>.</p>
 </div>
 <div class="paragraph">
-<p>In general, <strong>you should only pick the last stable version as per today 2.8.16.</strong></p>
+<p>In general, <strong>you should only pick the last stable version as per today 2.8.17.</strong></p>
 </div>
 <div class="paragraph">
 <p>More precisely, this the exhaustive list of spring-boot versions against which <code>springdoc-openapi</code> has been built:</p>

docs/migrating-from-springfox.html

@@ -44,7 +44,7 @@ <h2 id="migrating-from-springfox"><a class="anchor" href="#migrating-from-spring
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webmvc-ui&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>

docs/modules.html

@@ -73,7 +73,7 @@ <h3 id="_spring_webmvc_support"><a class="anchor" href="#_spring_webmvc_support"
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webmvc-api&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>
@@ -125,7 +125,7 @@ <h3 id="_spring_webflux_support"><a class="anchor" href="#_spring_webflux_suppor
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webflux-api&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>
@@ -147,7 +147,7 @@ <h3 id="_swagger_ui_support"><a class="anchor" href="#_swagger_ui_support"></a>S
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webmvc-ui&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>
@@ -163,7 +163,7 @@ <h3 id="_swagger_ui_support"><a class="anchor" href="#_swagger_ui_support"></a>S
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webflux-ui&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>
@@ -206,7 +206,7 @@ <h3 id="_scalar_support"><a class="anchor" href="#_scalar_support"></a>Scalar su
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webmvc-scalar&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>
@@ -222,7 +222,7 @@ <h3 id="_scalar_support"><a class="anchor" href="#_scalar_support"></a>Scalar su
 <pre class="highlight"><code class="language-xml" data-lang="xml">   &lt;dependency&gt;
       &lt;groupId&gt;org.springdoc&lt;/groupId&gt;
       &lt;artifactId&gt;springdoc-openapi-starter-webflux-scalar&lt;/artifactId&gt;
-      &lt;version&gt;2.8.16&lt;/version&gt;
+      &lt;version&gt;2.8.17&lt;/version&gt;
    &lt;/dependency&gt;</code></pre>
 </div>
 </div>
@@ -725,7 +725,7 @@ <h3 id="_springdoc_openapi_bom"><a class="anchor" href="#_springdoc_openapi_bom"
 			&lt;dependency&gt;
 				&lt;groupId&gt;org.springdoc&lt;/groupId&gt;
 				&lt;artifactId&gt;springdoc-openapi-bom&lt;/artifactId&gt;
-                &lt;version&gt;2.8.16&lt;/version&gt;
+                &lt;version&gt;2.8.17&lt;/version&gt;
 				&lt;type&gt;pom&lt;/type&gt;
 				&lt;scope&gt;import&lt;/scope&gt;
 			&lt;/dependency&gt;

docs/v4/core-properties.html

@@ -5,7 +5,7 @@
 <meta http-equiv="X-UA-Compatible" content="IE=edge">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <meta name="generator" content="Asciidoctor 2.0.15">
-<title>Untitled</title>
+<title>springdoc-openapi MCP properties</title>
 <link rel="stylesheet" href="css/site.css">
 <script src="js/setup.js"></script><script defer src="js/site.js"></script>
 
@@ -330,10 +330,89 @@
 </tr>
 </tbody>
 </table>
+<div class="sect2">
+<h3 id="_springdoc_openapi_mcp_properties"><a class="anchor" href="#_springdoc_openapi_mcp_properties"></a>springdoc-openapi MCP properties</h3>
+<div class="paragraph">
+<p>All properties are under the <code>springdoc.ai.mcp</code> prefix. These properties require the <code>springdoc-openapi-starter-webmvc-mcp</code> or <code>springdoc-openapi-starter-webflux-mcp</code> dependency.</p>
+</div>
+<table class="tableblock frame-all grid-all stretch">
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 33.3333%;">
+<col style="width: 33.3334%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Parameter name</th>
+<th class="tableblock halign-left valign-top">Default Value</th>
+<th class="tableblock halign-left valign-top">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">springdoc.ai.mcp.enabled</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Boolean</code>. Enable the MCP tool integration.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">springdoc.ai.mcp.base-url</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>http://localhost:8080</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>String</code>. Base URL for tool execution HTTP calls. If not set, defaults to <code>http://localhost:{server.port}</code>.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">springdoc.ai.mcp.init-timeout-seconds</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>30</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Integer</code>. Timeout in seconds waiting for the OpenAPI spec at startup.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">springdoc.ai.mcp.paths-to-exclude</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>List of Strings</code>. List of ant patterns for paths to exclude from MCP tool generation.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">springdoc.ai.mcp.mcp-endpoint</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>/mcp</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>String</code>. The MCP server endpoint path.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">springdoc.ai.mcp.dashboard-enabled</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>false</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Boolean</code>. Enable the MCP Developer Dashboard UI.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">springdoc.ai.mcp.dashboard-path</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>/mcp-ui</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>String</code>. The dashboard UI mount path.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">springdoc.ai.mcp.guardrails.require-approval-for-mutating-tools</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Boolean</code>. When <code>true</code>, calling a mutating tool (POST/PUT/DELETE/PATCH) via MCP returns an approval-required response instead of executing the HTTP call.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">springdoc.ai.mcp.guardrails.safe-methods</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>GET,HEAD,OPTIONS</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>List of Strings</code>. Comma-separated list of HTTP methods considered safe (read-only). All other methods are treated as mutating.</p></td>
+</tr>
+</tbody>
+</table>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+When MCP is enabled, <code>springdoc.pre-loading-enabled</code> is automatically forced to <code>true</code> by an environment post-processor, ensuring the OpenAPI specification is available at startup for tool registration.
+</td>
+</tr>
+</table>
+</div>
+</div>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2026-02-28 15:35:27 +0100
+Last updated 2026-03-18 02:48:29 +0100
 </div>
 </div>
 </div>

docs/v4/demos.html

@@ -63,6 +63,9 @@ <h3 id="_springdoc_applications_demos"><a class="anchor" href="#_springdoc_appli
 <li>
 <p><a href="https://demos1.springdoc.org/demo-microservices/swagger-ui.html" target="_blank" rel="noopener">Demo Spring Boot 4 and Spring Cloud Gateway</a></p>
 </li>
+<li>
+<p><a href="https://demos1.springdoc.org/demo-spring-boot-mcp/mcp-ui/index.html" target="_blank" rel="noopener">Demo Spring Boot 4 with MCP Support</a></p>
+</li>
 </ul>
 </div>
 <div class="imageblock">
@@ -97,7 +100,7 @@ <h3 id="_source_code_of_the_demo_applications"><a class="anchor" href="#_source_
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2025-09-07 15:08:33 +0200
+Last updated 2026-03-18 20:49:51 +0100
 </div>
 </div>
 </div>

docs/v4/faq.html

@@ -2004,7 +2004,7 @@ <h3 id="_what_is_the_compatibility_matrix_of_springdoc_openapi_with_spring_boot"
 <p><code>springdoc-openapi 3.x</code> is compatible with <code>spring-boot 4</code>.</p>
 </div>
 <div class="paragraph">
-<p>In general, <strong>you should only pick the last stable version as per today 3.0.2.</strong></p>
+<p>In general, <strong>you should only pick the last stable version as per today 3.0.3.</strong></p>
 </div>
 <div class="paragraph">
 <p>More precisely, this the exhaustive list of spring-boot versions against which <code>springdoc-openapi</code> has been built:</p>