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