Product: Liferay DXP 2026.Q3.0 (Build 7413, GitHash: a9f1e04db4a23a5fa2afc788b329d58a01ae0756)
Components:
- MCP Server (
com.liferay.mcp.server.rest.impl1.0.5/com.liferay.mcp.server.rest.api2.0.0) - REST Builder / Vulcan (
com.liferay.portal.vulcan.impl5.0.157/com.liferay.portal.remote.rest.extender6.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:
- Calling
GET /o/mcp-server/v1.0/tool-sets/{toolSetName}/tool-summariesreturns HTTP 400IllegalArgumentException: OpenAPI document has no "paths" objectfor every REST application (headless-delivery-v1.0,admin-server-v1.0,headless-admin-user-v1.0, etc.) as an authenticated Administrator. - Connecting to the MCP endpoint logs
ERROR [MCPServerServlet:190] Skipping MCP tool …for every single tool, including all four tools of its ownmcp-server-v1.0tool set. - 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, 298paths, 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
-
Perform a cold JVM start of a Liferay DXP 2026.Q3.0 bundle.
-
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.
– dnebingThanks for the suggestion Dave! I checked the 2026.q3.9 bundle and
– Himanshu_Chauhancom.liferay.mcp.server.rest.impl(1.0.5) andportal.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, andToolSetUtilstill permanently caches path-less OpenAPI docs there too.