[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)

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:

    GET /o/mcp-server/v1.0/tool-sets?pageSize=5
    GET /o/mcp-server/v1.0/tool-sets/headless-delivery-v1.0/tool-summaries?pageSize=2
    GET /o/mcp-server/v1.0/tool-sets/admin-server-v1.0/tool-summaries?pageSize=2
    

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

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:?]

Have you tried this on 2026.q3.9? The .0 releases are never as dependable as the patch releases.

–

Thanks for the suggestion Dave! I checked the 2026.q3.9 bundle and com.liferay.mcp.server.rest.impl (1.0.5) and portal.vulcan.impl (5.0.157) are byte-identical to q3.0, so I expect the same behavior. The master fix (LPD-103956) isn't in q3.9/q3.10 release notes, and ToolSetUtil still permanently caches path-less OpenAPI docs there too.

–