Skip to main content
POST
/
wp-json
/
getmcp
/
v1
/
servers
/
{server_id}
/
prompts
curl --request POST \
     --url https://yoursite.com/wp-json/getmcp/v1/servers/1/prompts \
     --header 'Authorization: Bearer gmcp_your_api_key' \
     --header 'content-type: application/json' \
     --data '
{
  "name": "summarize_article",
  "description": "Summarize an article in a specified style and length",
  "arguments": [
    {"name": "article_text", "description": "The full article text", "required": true},
    {"name": "style", "description": "Summary style: bullet points or paragraph", "required": false},
    {"name": "max_words", "description": "Maximum word count for the summary", "required": false}
  ],
  "template_content": "Summarize the following article in {{style}} format, keeping it under {{max_words}} words:\n\n{{article_text}}"
}
'

{
  "id": 2,
  "server_id": 1,
  "name": "summarize_article",
  "description": "Summarize an article in a specified style and length",
  "arguments": [
    {"name": "article_text", "description": "The full article text", "required": true},
    {"name": "style", "description": "Summary style", "required": false},
    {"name": "max_words", "description": "Maximum word count", "required": false}
  ],
  "template_content": "Summarize the following article in {{style}} format...",
  "server_uuid": "836995ae-1cff-41ec-823e-a4f07ccca3a0",
  "created_at": "2025-03-18T10:00:00Z",
  "updated_at": "2025-03-18T10:00:00Z"
}

​
Path Parameters

​
server_id
string
required
The numeric ID of the server to add the prompt to.

​
Body Parameters

​
name
string
required
Machine-readable prompt name (e.g., write_product_description). Use snake_case.
​
description
string
Description of what this prompt does.
​
arguments
array
Array of argument objects. Each argument has:
  • name (string, required) — argument identifier
  • description (string) — what the argument is for
  • required (boolean) — whether it must be provided
​
template_content
string
required
The prompt text with {{argument_name}} placeholders.
curl --request POST \
     --url https://yoursite.com/wp-json/getmcp/v1/servers/1/prompts \
     --header 'Authorization: Bearer gmcp_your_api_key' \
     --header 'content-type: application/json' \
     --data '
{
  "name": "summarize_article",
  "description": "Summarize an article in a specified style and length",
  "arguments": [
    {"name": "article_text", "description": "The full article text", "required": true},
    {"name": "style", "description": "Summary style: bullet points or paragraph", "required": false},
    {"name": "max_words", "description": "Maximum word count for the summary", "required": false}
  ],
  "template_content": "Summarize the following article in {{style}} format, keeping it under {{max_words}} words:\n\n{{article_text}}"
}
'

{
  "id": 2,
  "server_id": 1,
  "name": "summarize_article",
  "description": "Summarize an article in a specified style and length",
  "arguments": [
    {"name": "article_text", "description": "The full article text", "required": true},
    {"name": "style", "description": "Summary style", "required": false},
    {"name": "max_words", "description": "Maximum word count", "required": false}
  ],
  "template_content": "Summarize the following article in {{style}} format...",
  "server_uuid": "836995ae-1cff-41ec-823e-a4f07ccca3a0",
  "created_at": "2025-03-18T10:00:00Z",
  "updated_at": "2025-03-18T10:00:00Z"
}