Managing MCP Server Prompts

Liferay DXP 2026.Q4+ Release Feature

A prompt is a block of text an AI application requests from Liferay DXP over the Model Context Protocol (MCP), using the prompt’s Identifier. The MCP server returns the text as written, and a client can’t pass values into it. Create a prompt for instructions you want MCP clients to reuse, such as a standard way to summarize a page.

Prompts are in the MCP Server application, which appears when you enable LPD-63311, the release feature flag named Liferay Model Context Protocol (MCP) Server. To enable the MCP server for a virtual instance, see Enabling the MCP Server.

Creating a Prompt

Navigate to Control Panel → MCP Server → Prompts.
Click New Prompt.
(Optional) Set Prompt Status to Active.

Only active prompts are available to MCP clients, and a new prompt starts Inactive.
Enter a Name.

Liferay DXP generates the Identifier from the Name as you type, and you can edit it.
Enter a Description, and enter the text the MCP server returns in the Prompt field.
Click Save.

The Name and the Identifier must each be unique. The Identifier can contain only lowercase letters, numbers, and single hyphens between them. For example, a prompt named Summarize Page gets the Identifier summarize-page, and its Prompt text could be Summarize the page the user is viewing in three bullets. Accented characters become hyphens in the generated Identifier, so the Name Résumé generates r-sum. Edit the Identifier when this occurs.

To confirm that an active prompt reaches clients, list the server’s prompts with the MCP Inspector.

Editing, Activating, Duplicating, and Deleting a Prompt

To edit a prompt, click its name in the Prompts list, make your changes, and click Save. Changing the Name doesn’t change the Identifier.

To activate or deactivate a prompt, open it, set Prompt Status to Active or Inactive, and click Save. Only active prompts are available to MCP clients.

To copy a prompt, click Actions () for it and select Duplicate. The copy starts Inactive, with Copy of before its Name and copy-of- before its Identifier. Rename the copy before you duplicate the same prompt again, because a second copy would get the same Name and Identifier.

Warning

Deleting a prompt is permanent. MCP clients that request it receive an error from then on.

To delete a prompt, click Actions () for it and select Delete.

How MCP Clients Use Prompts

Every profile endpoint serves the same active prompts. Profiles set the tools and data masks a client gets, not its prompts.
An inactive prompt doesn’t appear in a client’s list of prompts, and requesting it returns an error.
A client sees a new or changed prompt the next time it lists or requests prompts. The MCP server doesn’t notify connected clients.
In the MCP protocol, a prompt’s name is its Identifier and its title is its Name. Its text arrives as a single message with the role USER.
Prompts belong to a virtual instance. They’re entries of the MCP Server Prompt system object, available through REST at /o/mcp/server-prompts, and object definition permissions control who can add or read them.

Upgrading Existing Prompts

If you created MCP server prompts before Liferay DXP 2026.Q4, upgrading gives each prompt an Identifier based on its Name and sets the prompt to Active. This ensures prompts that have already served clients continue to work. When two prompts would get the same Identifier, Liferay DXP adds a number to the later one, such as my-prompt-2. Update any client that requests that prompt.