# \[Bug\]\[2026.Q3.0\] MCP Server tool-summaries return HTTP 400 "OpenAPI document has no paths object" for all tool sets after restart (VulcanRequestForwarder & ToolSetUtil cache poison)

**URL:** <https://discuss.liferay.com/t/bug-2026-q3-0-mcp-server-tool-summaries-return-http-400-openapi-document-has-no-paths-object-for-all-tool-sets-after-restart-vulcanrequestforwarder-toolsetutil-cache-poison/1160>\
**Category:** Bug Reports\
**Tags:** product\
**Created:** [November 4, 2026, 7:14pm UTC](https://discuss.liferay.com/t/bug-2026-q3-0-mcp-server-tool-summaries-return-http-400-openapi-document-has-no-paths-object-for-all-tool-sets-after-restart-vulcanrequestforwarder-toolsetutil-cache-poison/1160 "2026-11-04T19:14:00Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Himanshu\_Chauhan](https://dub1.discourse-cdn.com/flex014/user_avatar/discuss.liferay.com/himanshu_chauhan/32/958_2.png) [@Himanshu\_Chauhan](https://discuss.liferay.com/u/Himanshu_Chauhan)\
**Post date:** [November 4, 2026, 7:14pm UTC](https://discuss.liferay.com/t/bug-2026-q3-0-mcp-server-tool-summaries-return-http-400-openapi-document-has-no-paths-object-for-all-tool-sets-after-restart-vulcanrequestforwarder-toolsetutil-cache-poison/1160/1 "2026-11-04T19:14:00Z")

</div>

**Product:** Liferay DXP 2026.Q3.0 (Build 7413, GitHash: `a9f1e04db4a23a5fa2afc788b329d58a01ae0756`)  
**Components:**

- MCP Server (`com.liferay.mcp.server.rest.impl` `1.0.5` / `com.liferay.mcp.server.rest.api` `2.0.0`)
- REST Builder / Vulcan (`com.liferay.portal.vulcan.impl` `5.0.157` / `com.liferay.portal.remote.rest.extender` `6.0.31`)

**Proposed Severity:** Major (Every MCP tool listing fails silently for all 105 tool sets across the instance, even for Administrators, and never self-recovers).

* * *

### 1. Summary

After a cold portal (JVM) restart, the Liferay MCP Server enters a poisoned cache state where:

1. Calling `GET /o/mcp-server/v1.0/tool-sets/{toolSetName}/tool-summaries` returns **HTTP 400 `IllegalArgumentException: OpenAPI document has no "paths" object`** for **every** REST application (`headless-delivery-v1.0`, `admin-server-v1.0`, `headless-admin-user-v1.0`, etc.) as an authenticated Administrator.
2. Connecting to the MCP endpoint logs **`ERROR [MCPServerServlet:190] Skipping MCP tool …`** for every single tool, including all four tools of its own `mcp-server-v1.0` tool set.
3. **Crucially:** At the exact same moment, requesting any application’s OpenAPI document directly via HTTP (e.g., `GET /o/headless-delivery/v1.0/openapi.json`) succeeds with **HTTP 200** and returns the complete specification (959 KB, 298 `paths`, 503 operations).

Restarting `com.liferay.mcp.server.rest.impl` via App Manager does **not** clear the issue. The broken state persists permanently until `com.liferay.portal.vulcan.impl` is restarted.

* * *

### 2. Environment

| Item | Value |
| --- | --- |
| **Product** | Liferay DXP **2026.Q3.0** (Build 7413, GitHash `a9f1e04db4a23a5fa2afc788b329d58a01ae0756`) |
| **App Server / OS** | Bundled Tomcat 10.1.57, Windows 11 Pro |
| **JVM** | Java 21.0.11 LTS |
| **Database / Search** | MySQL 5.7 / Elasticsearch (sidecar) |
| **Unmodified Bundles** | `com.liferay.mcp.server.rest.impl` (`1.0.5`), `com.liferay.mcp.server.rest.api` (`2.0.0`), `com.liferay.portal.vulcan.impl` (`5.0.157`), `com.liferay.portal.remote.rest.extender` (`6.0.31`) |

* * *

### 3. Steps to Reproduce

1. Perform a cold JVM start of a Liferay DXP 2026.Q3.0 bundle.

2. As an Administrator, invoke the MCP Server REST endpoints:

Log Output & Stack Trace (After restarting `com.liferay.mcp.server.rest.impl`):

> ```auto
> 2026-11-04 13:20:12.746 INFO [http-nio-8090-exec-6][BundleStartStopLogger:69] STOPPED com.liferay.mcp.server.rest.impl_1.0.5 [924]
> 2026-11-04 13:22:24.685 INFO [http-nio-8090-exec-6][BundleStartStopLogger:66] STARTED com.liferay.mcp.server.rest.impl_1.0.5 [924]
> 
> 2026-11-04 13:29:00.753 ERROR [http-nio-8090-exec-7][MCPServerServlet:190] Skipping MCP tool "getToolSetsPage" from tool set "mcp-server-v1.0"
> java.lang.RuntimeException: java.lang.IllegalArgumentException: OpenAPI document has no "paths" object
> at com.liferay.mcp.server.rest.internal.servlet.MCPServerServlet._getTool(MCPServerServlet.java:472) ~[bundleFile:?]
> at com.liferay.mcp.server.rest.internal.servlet.MCPServerServlet.lambda$_buildServlet$2(MCPServerServlet.java:181) ~[bundleFile:?]
> at com.liferay.mcp.server.rest.internal.servlet.MCPServerServlet._buildServlet(MCPServerServlet.java:164) ~[bundleFile:?]
> at com.liferay.mcp.server.rest.internal.servlet.MCPServerServlet.lambda$_getServlet$4(MCPServerServlet.java:406) ~[bundleFile:?]
> at com.liferay.mcp.server.rest.internal.servlet.MCPServerServlet._getServlet(MCPServerServlet.java:404) ~[bundleFile:?]
> at com.liferay.mcp.server.rest.internal.servlet.MCPServerServlet.service(MCPServerServlet.java:132) ~[bundleFile:?]
> at com.liferay.mcp.server.rest.internal.servlet.filter.MCPServerAuthVerifierFilter.processFilter(MCPServerAuthVerifierFilter.java:81) ~[bundleFile:?]
> Caused by: java.lang.IllegalArgumentException: OpenAPI document has no "paths" object
> at com.liferay.mcp.server.rest.internal.util.OpenAPIUtil._getOperation(OpenAPIUtil.java:837) ~[bundleFile:?]
> at com.liferay.mcp.server.rest.internal.util.OpenAPIUtil.getTool(OpenAPIUtil.java:156) ~[bundleFile:?]
> at com.liferay.mcp.server.rest.internal.util.ToolSetUtil.getTool(ToolSetUtil.java:76) ~[bundleFile:?]
> at com.liferay.mcp.server.rest.internal.servlet.MCPServerServlet._getTool(MCPServerServlet.java:458) ~[bundleFile:?]
> 
> ```

 ![04-openapi-json-headless-delivery-200](https://europe1.discourse-cdn.com/flex014/uploads/liferay/original/2X/0/082fb4378ec8feba6849e64507954932ab8395b8.png)

 ![03-tool-summaries-admin-server-400](https://europe1.discourse-cdn.com/flex014/uploads/liferay/original/2X/b/bbd7140fbde22dc9bd398448b736bbf7f847607f.png)

 ![02-tool-summaries-headless-delivery-400](https://europe1.discourse-cdn.com/flex014/uploads/liferay/original/2X/1/1dad2b896277634958322f9051f4a50ee2b2b357.png)

 ![05-tool-sets-list-200](https://europe1.discourse-cdn.com/flex014/uploads/liferay/original/2X/c/cb0080397726cd85fb06d9158d78a19777476510.png)
