The DynamicWeb MCP exposes a large set of tools across 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_safefor enrichment flows.update_productsresets 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 | |
assign_data_model_to_products_and_groups |
Assign data models to products and groups in a single call | |
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 |
Product Images & Assets
Manages product images and related asset metadata — listing images, adding or removing individual image records, setting a primary image, and importing or uploading new images.
| Tool | Description |
|---|---|
get_product_asset_categories |
List the asset categories defined on the solution |
get_product_images |
Get all image records for a product |
add_product_image |
Add a single image record to a product |
remove_product_image |
Remove an image record from a product |
set_product_primary_image |
Set which image is the primary image for a product |
import_product_images_from_urls |
Download one or more images from URLs and attach them to a product |
upload_product_images |
Upload one or more base64-encoded images and attach them to a product |
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 |
save_conditions_to_discounts |
Create or update conditions on existing discounts. Supports update-by-ID and exposes both InputValue (machine value) and DisplayValue (human-friendly value) on parameters |
delete_conditions_from_discounts |
Remove conditions from discounts |
save_rewards_to_discounts |
Create or update rewards on existing discounts. Supports update-by-ID and exposes both InputValue and DisplayValue on parameters |
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, create, update, and delete commerce orders. Includes workflow-state transitions, cart-to-order conversion, and price/discount recalculation.
| Tool | Description |
|---|---|
get_order_by_id |
Get an order by ID including all order lines |
get_orders_by_ids |
Get multiple orders in a single call |
get_order_versions |
Get all stored versions of an order |
create_orders |
Create one or more orders |
update_orders |
Update order fields such as customer details, comments, and track & trace number |
delete_order |
Soft-delete an order, or hard-delete it when hardDelete=true |
complete_order |
Mark an order as complete |
is_order_complete |
Check whether an order is marked as complete |
convert_cart_to_order |
Convert a cart to a confirmed order (assigns order number and default state) |
set_order_state |
Set the workflow state on an order |
set_order_payment_method |
Assign a payment method to an order |
recalculate_discounts |
Recalculate all discounts on an order |
force_price_recalculation |
Force a full price recalculation on an order |
validate_order_prices |
Validate that the prices on an order are still consistent |
Order Lines
Manage the individual lines on an order — products, fixed-charge lines, and order-level or product-level discount lines.
| Tool | Description |
|---|---|
get_order_line |
Get a single order line by its ID |
get_order_lines |
Get all order lines for a given order |
add_products |
Add one or more product lines to an order |
add_products_by_sku |
Add product lines to an order by SKU |
add_fixed_lines |
Add fixed (free-text) lines for fees, surcharges, or custom charges |
add_order_discounts |
Add order-level discount lines to an order |
add_product_line_discounts |
Add product-line discounts to an order |
update_order_line |
Update quantity and/or unit price on an existing order line |
delete_order_line |
Delete a single order line by ID |
delete_all_order_lines |
Delete all order lines on an order |
Order Fields
Manage the schema for custom fields on order records.
| Tool | Description |
|---|---|
get_order_fields |
Get all custom order-field definitions |
get_order_field_by_id |
Get a single custom order-field definition |
create_order_field |
Create a new custom order-field definition |
delete_order_field |
Delete a custom order-field definition |
Order States & Flows
Manage order workflow flows and the states inside them.
| Tool | Description |
|---|---|
get_order_flows |
Get order flows, optionally filtered by order type |
get_order_states |
Get order states, optionally filtered by order type |
get_order_state_by_id |
Get a single order state by ID |
create_order_state |
Create a new order state inside an existing flow |
delete_order_state |
Delete an order state by ID |
Payment Methods
Read payment method configurations. Use set_order_payment_method (under Orders) to assign a method to an order.
| Tool | Description |
|---|---|
get_payment_methods |
Get all payment methods, optionally filtering to active only |
get_payment_method_by_id |
Get a single payment method by ID |
Shipping Methods
Manage shipping method records. Region- and provider-specific rate rules are managed elsewhere.
| Tool | Description |
|---|---|
get_shipping_methods |
Get all shipping methods, optionally filtering to active only |
get_shipping_method_by_id |
Get a single shipping method by ID |
create_shipping_method |
Create a new shipping method |
delete_shipping_method |
Delete a shipping method by ID |
RMA
Manage Return Merchandise Authorizations (RMAs) and their workflow states.
| Tool | Description |
|---|---|
get_all_rmas |
Get all RMAs |
get_rma_by_id |
Get a single RMA by ID |
get_rmas_by_order_id |
Get all RMAs associated with an order |
get_rma_states |
Get all available RMA states |
create_rma |
Create a new RMA, optionally pre-populated from an order's customer details |
set_rma_state |
Update the state of an RMA |
close_rma |
Close an RMA |
delete_rma |
Soft-delete an RMA |
Recurring Orders
Read and manage recurring-order schedules.
| Tool | Description |
|---|---|
get_recurring_order_by_id |
Get a recurring order by its own numeric ID |
get_recurring_order_by_base_order_id |
Get a recurring order by the ID of the base/template order |
get_recurring_orders_for_user |
Get all recurring orders for a user |
end_recurring_order |
End a recurring order by setting its end date to now |
delete_recurring_order |
Delete a recurring order |
Track & Trace
Manage carrier/provider track-and-trace URL templates used on orders.
| Tool | Description |
|---|---|
get_track_and_traces |
Get all track-and-trace configurations |
get_track_and_trace_by_id |
Get a single track-and-trace configuration |
save_track_and_trace |
Create or update a track-and-trace configuration |
delete_track_and_trace |
Delete a track-and-trace configuration |
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 |