Sitecore Marketer MCP a deep dive - Available tools and fields details - Part 1

The Sitecore Marketer MCP server is one of the most anticipated MCP servers released by Sitecore. It enables both marketers and developers to interact with a connected Sitecore instance more efficiently using AI-powered agents.

With the Marketer MCP server, marketers can simply use natural language prompts to ask the AI agent to perform tasks such as:

  • Creating and updating pages
  • Creating and updating components
  • Managing languages
  • Listing available sites
Performing various other content-related operations

The Sitecore Marketer MCP server provides a collection of tools that allow marketers and developers to explore and execute actions within the connected Sitecore environment.

These tools act as the bridge between the AI agent and the Sitecore instance, enabling the agent to understand the request and perform the appropriate operation.

Available Tools in the Marketer MCP Server:

Currently, there are 42 tools available in the Sitecore Marketer MCP server. Each tool is designed to handle a specific operation within the Sitecore environment.

Available tools and their purpose:

The table below provides an overview of all the available tools, including:

  • The tool name
  • Its purpose
  • The input parameters required
  • Whether each parameter is required or optional
This information helps both developers and marketers understand how each tool can be used when interacting with the Sitecore environment.

#Tool NameDescriptionTotal FieldsRequiredOptional
1list_sitesList all sites with name and target hostname000
2get_site_informationGet site information by site ID110
3get_site_id_from_itemGet site ID from item ID110
4search_siteSearch site pages by title321
5get_all_languagesGet all available languages in the system000
6get_all_pages_by_siteGet all pages by site211
7get_page_path_by_live_urlGet page path by live URL110
8get_page_htmlGet page HTML content321
9get_page_preview_urlGet the preview URL for a specific page220
10get_page_template_by_idGet page template by id including available fields110
11create_pageCreate a new page532
12get_pageGet page details by ID and language211
13add_language_to_pageAdd a language to a page220
14get_page_screenshotGet a screenshot of a page523
15add_component_on_pageAdd component to a page642
16get_allowed_components_by_placeholderGet allowed components by placeholder321
17remove_component_on_pageRemove component from page330
18move_component_within_placeholderMove component within placeholder440
19list_componentsList all components for a site110
20get_componentGet component details including datasource requirements110
21get_components_by_placeholderGet components available for a placeholder110
22get_components_on_pageGet all components on a page312
23set_component_datasourceSet datasource for a component on a page431
24create_component_datasourceCreate component datasource532
25search_component_datasourcesSearch component datasources220
26list_available_insertoptionsList available insert options for an item211
27create_child_itemCreate child item under parent550
28delete_child_itemDelete child item220
29create_content_itemCreate content item532
30update_fields_on_content_itemUpdate fields on content item220
31update_contentUpdate content item523
32delete_contentDelete content item211
33get_content_item_by_pathGet content item by path312
34get_content_item_by_idGet content item by ID211
35search_assetsSearch assets by name, type, or tags404
36get_asset_informationGet asset information by ID110
37update_assetUpdate asset information532
38upload_assetUpload asset file with metadata using multipart form data660
39create_personalization_versionCreate a personalization version for a page752
40get_personalization_versions_by_pageGet all personalization versions for a page211
41get_personalization_condition_templatesGet available personalization condition templates000
42get_personalization_condition_template_by_idGet personalization condition template by ID110


Tool Parameter Details:

The table below provides a detailed overview of the input parameters for each tool. This information helps both developers and marketers understand how specific actions are executed based on the request or prompt provided to the Sitecore Marketer MCP server.

By reviewing these parameters, we can clearly identify which fields are required, which are optional, and how each parameter is used to execute the action within the connected Sitecore environment.

 
#Tool NameTool DescriptionField NameTypeField DescriptionRequiredDefault
1list_sitesList all sites with name and target hostname(no input fields)No
2get_site_informationGet site information by site IDsiteIdstringID of the siteYes
3get_site_id_from_itemGet site ID from item IDitemIdstringID of the itemYes
4
search_site
Search site pages by title
search_querystringSearch query for pagesYes
languagestringLanguage codeNoen
site_namestringName of the site to searchYes
5get_all_languagesGet all available languages in the system(no input fields)No
6
get_all_pages_by_site
Get all pages by site
siteNamestringName of the siteYes
languagestringLanguage codeNoen
7get_page_path_by_live_urlGet page path by live URLliveUrlstringLive URL of the pageYes
8
get_page_html
Get page HTML content
pageIdstringPage IDYes
languagestringLanguage codeYes
versionnumberVersion numberNo
9
get_page_preview_url
Get the preview URL for a specific page
pageIdstringPage IDYes
languagestringLanguage codeYes
10get_page_template_by_idGet page template by id including available fieldstemplateIdstringTemplate IDYes
11
create_page
Create a new page
templateIdstringTemplate IDYes
parentIdstringParent IDYes
namestringPage nameYes
languagestringLanguage codeNoen
fieldsarrayArray of field objectsNo
12
get_page
Get page details by ID and language
pageIdstringPage IDYes
languagestringLanguage code (default: en)Noen
13
add_language_to_page
Add a language to a page
pageIdstringPage IDYes
language_requestobjectLanguage request bodyYes
14
get_page_screenshot
Get a screenshot of a page
pageIdstringPage IDYes
versionnumberVersion numberYes
languagestringLanguage codeNoen
widthnumberScreenshot widthNo1200
heightnumberScreenshot heightNo800
15
add_component_on_page
Add component to a page
pageIdstringPage IDYes
componentRenderingIdstringComponent rendering IDYes
placeholderPathstringPlaceholder pathYes
componentItemNamestringComponent item nameYes
languagestringLanguage codeNoen
fieldsobjectField valuesNo
16
get_allowed_components_by_placeholder
Get allowed components by placeholder
pageIdstringPage IDYes
placeholderNamestringPlaceholder nameYes
languagestringLanguage code (default: en)Noen
17
remove_component_on_page
Remove component from page
pageIdstringPage IDYes
componentIdstringComponent IDYes
placeholderIdstringPlaceholder IDYes
18
move_component_within_placeholder
Move component within placeholder
pageIdstringPage IDYes
placeholderIdstringPlaceholder IDYes
oldIndexnumberOld position indexYes
newIndexnumberNew position indexYes
19list_componentsList all components for a sitesite_namestringSite nameYes
20get_componentGet component details including datasource requirementscomponent_idstringComponent IDYes
21get_components_by_placeholderGet components available for a placeholderplaceholder_idstringPlaceholder IDYes
22
get_components_on_page
Get all components on a page
pageIdstringPage IDYes
languagestringLanguage codeNoen
versionnumberVersion numberNo
23
set_component_datasource
Set datasource for a component on a page
pageIdstringPage IDYes
componentIdstringComponent IDYes
datasourceIdstringDatasource IDYes
languagestringLanguage codeNoen
24
create_component_datasource
Create component datasource
siteNamestringSite nameYes
componentIdstringComponent IDYes
dataFieldsobjectDatasource field valuesYes
languagestringLanguage code (default: en)Noen
childrenarrayChild datasourcesNo
25
search_component_datasources
Search component datasources
component_idstringComponent IDYes
termstringSearch termYes
26
list_available_insertoptions
List available insert options for an item
itemIdstringItem IDYes
languagestringLanguage codeNoen
27
create_child_item
Create child item under parent
parentIdstringParent item IDYes
templateIdstringTemplate IDYes
namestringItem nameYes
pathstringItem pathYes
fieldsobjectField valuesYes
28
delete_child_item
Delete child item
parentIdstringParent item IDYes
childIdstringChild item ID to deleteYes
29
create_content_item
Create content item
namestringItem nameYes
templateIdstringTemplate IDYes
parentIdstringParent IDYes
languagestringLanguage codeNoen
fieldsobjectField valuesNo
30
update_fields_on_content_item
Update fields on content item
itemIdstringItem IDYes
fieldsobjectField valuesYes
31
update_content
Update content item
itemIdstringItem IDYes
fieldsobjectField valuesNo
languagestringLanguage codeNoen
createNewVersionbooleanCreate new versionNoFalse
siteNamestringSite nameYes
32
delete_content
Delete content item
itemIdstringItem IDYes
languagestringLanguage codeNoen
33
get_content_item_by_path
Get content item by path
itemPathstringContent item pathYes
languagestringLanguage code (default: en)Noen
failOnNotFoundbooleanFail if item not found (default: true)NoTrue
34
get_content_item_by_id
Get content item by ID
itemIdstringItem IDYes
languagestringLanguage codeNo
35
search_assets
Search assets by name, type, or tags
querystringSearch queryNo
typestringAsset typeNo
languagestringLanguage code (default: en)No
tagsarrayAsset tagsNo
36get_asset_informationGet asset information by IDasset_idstringAsset IDYes
37
update_asset
Update asset information
asset_idstringAsset IDYes
fieldsobjectAsset fields as key-value pairsYes
languagestringLanguage codeYes
namestringAsset nameNo
altTextstringAlternative text for the assetNo
38
upload_asset
Upload asset file with metadata using multipart form data
filePathstringLocal file path to uploadYes
namestringAsset nameYes
itemPathstringItem path where the asset will be storedYes
languagestringLanguage codeYes
extensionstringFile extension (e.g., jpg, png, pdf)Yes
siteNamestringSite name where the asset belongsYes
39
create_personalization_version
Create a personalization version for a page
pageIdstringPage IDYes
namestringPersonalization version nameYes
languagestringLanguage code (default: en)Noen
variantNamestringVariant nameYes
audienceNamestringAudience nameYes
conditionTemplateIdstringCondition template ID (uuid)Yes
conditionParamsobjectAdditional properties for condition parametersNo
40
get_personalization_versions_by_page
Get all personalization versions for a page
pageIdstringPage IDYes
languagestringLanguage codeNoen
41get_personalization_condition_templatesGet available personalization condition templates(no input fields)No
42get_personalization_condition_template_by_idGet personalization condition template by IDtemplateIdstringCondition template ID (uuid)Yes

Let's learn and grow together, happy programming 😊

Comments

Popular posts from this blog

Sitecore Search - API Crawler with Edge Pagination

Sitecore Upgrade from 8.1 XP to 10.4 XM Scaled - Part 1

Seamless Media Migration to XM Cloud: A Step-by-Step Guide from Sitecore XP 10.4 and Content Hub Integration - Part 1