MCP prompts are reusable prompt templates defined by the server and surfaced to users by an agent. On selection of a prompt, the required inputs are provided, and a structured set of messages are generated for the LLM to perform a specific task. Prompts can accept dynamic arguments, include context from resources and chain multiple interactions. They enable servers to standardise common LLM interactions so they are consistent and reusable across any connected agent.
When to use MCP prompts
Use MCP prompts when you want AI agents to perform the same task consistently without rewriting instructions every time. A prompt template stores the task and required context on the MCP server, so users only need to provide the necessary input.
MCP prompts are useful when you want to:
-
Standardize repetitive AI tasks across your organization
-
Reuse shared business context, such as policies, schemas, or guidelines
-
Simplify AI interactions for users who aren't familiar with prompt writing
-
Update a prompt in one place without changing every application or workflow that uses it
Example use cases
MCP prompts can be used for many common business processes, such as:
-
Contract review: Generate consistent summaries of contract changes and highlight potential risks
-
RFP responses: Create draft responses using approved product information and pricing
-
Quarterly business reviews: Generate executive summaries from business metrics and performance data
-
Employee onboarding: Create personalized onboarding briefs based on an employee's role and team
-
Customer success: Summarize account health using CRM, product usage, and support data
-
Vendor assessments: Evaluate vendor responses against predefined business or security requirements and generate a standardized report
Note
An MCP prompt defines the instructions necessary to carry a given task. At runtime, the AI agent supplies the input values and uses the prompt provided by MCP Server to complete the request.
How agents use prompts
Agents typically follow this sequence:
-
Use prompt/list to discover available prompts
-
Use prompts/get to retrieve a specific prompt with resolved arguments
The prompts/get call returns the final set of message that an agent uses during execution.
While creating an MCP server, on the right side, in the Capabilities section click Add. The Add capabilities page is displayed.
On the top of the page, click Prompts. If you don’t have any existing prompts click Create prompt.
If you have previously created a prompt, click + Create prompt on the upper right side of the page.
In the Create prompt page, enter the details in the following sections.
General
-
Name: Provide an unique identifier for the prompt to be referenced easily.
Note
Use only alphanumeric characters, hyphens (-), underscores (_), and dots (.). spaces and other special characters are not allowed.
-
Title (optional): Provide a user friendly label that appears in the UI.
-
Description (optional): Explain what the prompt does and when to use it.
Prompts
This section allows you to define one or more message templates used during a conversation. In MCP, each prompt represents a message with a specific role such as User and Assistant.
To add a message template:
-
Select either User or Assistant as a role.
-
Enter the message for the prompt template.
-
Click + to add another message template.
Each prompt template you add becomes part of the final sequence of messages used.
Template syntax
Prompt message templates support Handlebars syntax, allowing you to use placeholders such as {{accountId}}, {{timeRange}}. When the prompt runs, these placeholders are replaced with the corresponding values from input arguments.
Arguments
Arguments are the inputs used to replace placeholders (Handlebars syntax) in your prompt messages. For example, a placeholder like {{accountId}} is replaced with the value provided for that argument when the prompt runs.
To add an argument:
-
Enter the argument name. This must match the placeholder used in your prompt (for example, accountId).
-
(Optional) Add a description to help users understand what value to provide.
For each prompt you have options to:
-
Click + to add a new argument.
-
Click the trash icon to delete an argument.
-
Click the gear icon to add or edit the argument description.
Note
These arguments act as input parameters that are passed when the prompt is executed (for example, during a prompts/get request).
In the Create prompt page, the left side is for configuring the prompt and the right side for execution and performance preview. To see how import requests will look click within the Input tab. You can directly edit the input field to modify the prompt if you haven't yet configured your prompt.
You can test your prompt before saving or using it:
-
In the Preview tab, click Test to validate if your prompt is created properly or not.This renders the message templates with your provided argument values so you can verify the final resolved messages.
-
Click Save&close.
-
A new entry is added in the Prompts tab.
In the Prompts tab, you can view the details related to each prompt such as Name, Description, Arguments, and Actions. For each prompt, click (...) in the Actions column, to select the options to Edit or Delete a prompt.