Tools

The DynamicWeb MCP exposes 151 tools across 17 tool classes, grouped into two domains. Which tools are available to a given agent depends on the permissions configured in DynamicWeb settings.

Tip

We keep adding tools to the DynamicWeb MCP Server. Check the App Store for the latest version.

Products Domain

Countries

Manages countries and their sub-regions, identified by ISO codes.

Tool	Description
get_countries	Get all countries
get_country	Get a country by its 2-letter ISO code
get_regions_by_country_code	Get all regions for a country
get_region	Get a specific region by country and region code
save_countries	Create or update countries and regions
delete_countries	Delete countries and their regions
delete_regions	Delete specific regions
update_country_codes	Rename country codes and update all relations
delete_country_translations	Delete translations for countries in specific languages

Currencies

Manages currencies using ISO 4217 codes (e.g. USD, EUR).

Tool	Description
get_currencies	Get all currencies
get_currency	Get a single currency by ISO code
save_currencies	Create or update currencies
delete_currencies	Delete currencies by ISO code

Languages

Manages eCommerce languages (e.g. en-US, da-DK).

Tool	Description
get_languages	Get all eCommerce languages
get_language	Get a language by ID
save_languages	Create or update languages
delete_languages	Delete languages by ID

Product Groups

Manages the product group hierarchy. Groups can be nested. Deleting a group also deletes all its subgroups and products.

Tool	Description
get_groups	Get all product groups as a flat list
get_group_by_id	Get a product group by ID
get_subgroups	Get direct subgroups of a group
save_groups	Create or update groups
delete_groups	Delete groups, subgroups, and their products
get_groups_for_product	Get all groups a product belongs to
assign_products_to_group	Assign products to a group
remove_products_from_group	Remove products from a group

Shops

Manages shops — the top-level container for data model hierarchies.

Tool	Description
get_shops	Get all shops including their data model hierarchy
get_shop	Get a single shop by ID
save_shops	Create or update shops
delete_shops	Delete shops by ID

Products

Core product management. Supports creating, reading, updating, and deleting products.

Note: Use patch_products_safe for enrichment flows. update_products resets every omitted field to its default value.

Tool	Description
get_products	Get a paginated list of products
get_product_by_id	Fetch a product by ID
get_product_by_external_id	Fetch a product by external ID
get_product_by_auto_id	Get a product by its numeric auto-generated ID
get_products_by_group	Get all products in a group
get_products_by_sku	Get products matching a SKU
get_products_by_query	Execute a saved product query against the search index
get_products_by_search_filter	Execute a search filter and return matching products
create_products	Create one or more products
update_products	Full replacement update — omitted fields are reset
patch_products_safe	Safe partial update — only provided fields are written. Recommended for enrichment
delete_products	Delete one or more products

Assortments

Manages assortments — named collections controlling product visibility per user or user group.

Tool	Description
get_assortments	Get all assortments
get_assortment	Get a single assortment by ID
get_assortments_for_build	Get assortments flagged for rebuild
get_assortments_by_product	Get assortments containing a specific product
get_anonymous_assortment_ids	Get assortment IDs available to anonymous users
save_assortments	Create or update assortments
delete_assortments	Delete assortments by ID
flag_assortments_for_rebuild	Flag assortments for rebuild
build_assortments	Trigger an immediate rebuild of assortments
get_assortment_relations	Get all relations for an assortment
get_assortment_relations_by_product	Get assortment-product relations for a product
get_assortment_relations_by_group	Get assortment-group relations for a group
get_assortment_relations_by_shop	Get assortment-shop relations for a shop
assign_products_to_assortment	Add product relations to assortments
remove_products_from_assortment	Remove product relations from assortments
assign_groups_to_assortment	Add group relations to assortments
remove_groups_from_assortment	Remove group relations from assortments
assign_shops_to_assortment	Add shop relations to assortments
remove_shops_from_assortment	Remove shop relations from assortments
get_assortment_ids_by_user	Get assortment IDs a user has access to
get_assortment_permissions_by_user	Get assortment permissions for a user
get_assortment_permissions	Get user and user-group permissions for an assortment
assign_permissions_to_assortment	Add permissions to assortments
remove_permissions_from_assortment	Remove permissions from assortments

Data Models

Manages the PIM data modelling layer: shops, data model hierarchies, categories, fields, and bulk structure creation.

Tool	Description
get_field_types	Returns available product field types
get_standard_fields	Returns all product fields (built-in and custom)
get_product_category_fields	Returns all custom category fields
get_product_category_field_options	Returns all custom category fields including configured Options for list-based fields. Useful before creating or deleting field options.	—
get_product_reference_fields	Returns all custom reference fields from SystemFields categories. Use SystemName in queries, completeness rules, and field-option operations.	—
get_product_reference_field	Returns a single reference field by system name or field ID.	fieldName: string
get_completion_rules	Returns all completeness rules
create_shops	Create shops to hold data models
create_data_models	Create data model nodes or folders
create_categories	Create product categories to hold custom fields
create_category_fields	Create fields inside categories
create_field_options	Create options on list-based product or category/reference fields. Returns created option values and default flags.	requests: List<FieldOptionCreateRequest>
create_product_fields	Create standard product fields available on all products
create_data_model_structure	Composite tool — creates a full structure (shop, folders, data models, categories, fields, completeness rules, workflow states) in a single call
patch_data_models	Patch existing data models
assign_categories_to_data_models	Associate a category with a data model
assign_data_model_to_products	Assign data models to products in bulk
delete_data_models	Delete data models or folders
delete_categories	Delete product categories and all their fields
delete_category_fields	Delete specific fields from categories
delete_product_fields	Delete custom standard product fields
delete_field_options	Delete one or more options from list-based product or category/reference fields. Irreversible.	requests: List<FieldOptionDeleteRequest>
update_category_fields	Update existing category fields. Supports visibility/editing flags such as shared across languages/variants, required, read-only, do-not-render, and use-as-facet.	requests: List<CategoryFieldUpdateModel>
update_reference_fields	Update existing reference fields in SystemFields categories. Supports name, description, template tag, list presentation, and the same visibility/editing flags as category fields.	requests: List<ReferenceFieldUpdateModel>

Completeness & Workflow

Manages product completeness rules and editorial workflows.

Tool	Description
get_completion_rules	Get all completeness rules
get_workflow_states	Get all workflows and their states
create_or_update_completeness_rules	Create or update completeness rules
create_or_update_workflow_states	Create or update workflow states
assign_completion_rules_to_shops	Assign completion rules to shops (replaces existing)
assign_completion_rules_to_groups	Assign completion rules to groups (replaces existing)
delete_completion_rules	Delete completeness rules
delete_workflows	Delete workflows and all their states
delete_workflow_states	Delete individual workflow states

Product Queries

Manages saved product queries used in the admin and on storefront catalog pages.

Tool	Description
get_macro_fields	Returns all supported macro action fields for query expressions
get_product_queries	Returns all saved product queries with their expressions and completeness rules
create_or_update_product_queries	Create or update product queries
delete_product_queries	Delete product queries by ID

Dashboards

Manages DynamicWeb admin dashboards and their widget configurations.

Tool	Description
get_dashboard_areas	Returns all available dashboard areas
get_available_widgets	Returns all registered widget types
get_widget_parameters	Returns configurable parameters for a specific widget type
get_dashboards	Returns all dashboard configurations
create_dashboards	Create dashboards for given areas
delete_dashboards	Delete dashboard configurations
get_dashboard_widgets	Returns all widget instances on a dashboard
add_widgets_to_dashboards	Add widgets to existing dashboards
remove_widgets_from_dashboards	Remove widgets from dashboards

Variants

Manages variant groups (e.g. Color, Size) and their options (e.g. Red, Blue, XL).

Tool	Description
get_variant_groups	Get all variant groups
get_variant_group_by_id	Get a variant group by ID
get_variant_groups_by_product_id	Get variant groups assigned to a product
save_variant_groups	Create or update variant groups
delete_variant_groups	Delete variant groups and all their options
get_variant_options	Get all variant options for a variant group
get_variant_option_by_id	Get a variant option by ID
save_variant_options	Create or update variant options
delete_variant_options	Delete variant options by ID

---

Commerce Domain

Discounts

Tool	Description
get_discount_condition_types	Returns all available condition types with their parameter schemas
get_discount_reward_types	Returns all available reward types with their parameter schemas
get_adjustment_discounts	Get all adjustment discounts
get_adjustment_discount	Get full detail for a single discount
create_adjustment_discounts	Create discount headers
update_adjustment_discounts	Update header fields on existing discounts
delete_adjustment_discounts	Permanently delete discounts including conditions and rewards
add_conditions_to_discounts	Add conditions to existing discounts
delete_conditions_from_discounts	Remove conditions from discounts
add_rewards_to_discounts	Add rewards to existing discounts
delete_rewards_from_discounts	Remove rewards from discounts

Note

The discount tools only work with the New Discount Experience in DynamicWeb. Make sure your solution is using the new experience before using these tools.

Units

Manages units of measure (e.g. PCS, KG).

Tool	Description
get_units	Get all units of measure
get_unit	Get a unit by ID
save_units	Create or update units
delete_units	Delete units by ID

Manufacturers

Manages product manufacturers and brands.

Tool	Description
get_manufacturers	Get all manufacturers
get_manufacturer	Get a manufacturer by ID
save_manufacturers	Create or update manufacturers
delete_manufacturers	Delete manufacturers by ID

Orders

Read and update commerce orders.

Tool	Description
get_order	Get an order by ID including all order lines
search_orders	Search orders with optional filters
update_orders	Update order state, comments, and track & trace number

Prices

Manages product prices across currencies, customer groups, and quantity tiers.

Tool	Description
get_prices_by_product	Get all price tiers for a product
get_price	Get a price by ID
save_prices	Create or update prices
delete_prices	Delete prices by ID
delete_prices_for_products	Delete all prices for one or more products