The Full access profile advertises 71 tools. The Read-only profile advertises the read subset and filters out every write tool. Together they cover Catalog data, schema, layouts and changelogs, plus DAM images and non-image files.
You do not call these tools as HTTP endpoints. Your AI assistant selects and calls them through Model Context Protocol. Tools marked Write are available only under the Full access profile. See Access profiles and permissions.
Catalog tools use the Catalog REST API. DAM tools use the DAM REST API. REST rules for filtering, field selection, pagination, and errors still define the underlying behavior.
| Tool | Group | Access |
|---|---|---|
version | Server | Read |
validate_token | Metadata and schema | Read |
get_catalog_info | Metadata and schema | Read |
get_catalog_locales | Metadata and schema | Read |
get_metadata | Metadata and schema | Read |
get_entity_fields | Metadata and schema | Read |
get_table_info | Metadata and schema | Read |
get_attribute_sets | Attribute Sets | Read |
get_attribute_set | Attribute Sets | Read |
create_attribute_set | Attribute Sets | Write |
update_attribute_set | Attribute Sets | Write |
delete_attribute_set | Attribute Sets | Write |
get_categories | Categories | Read |
get_category_products | Categories | Read |
get_category_layout | Categories | Read |
get_category_metadata | Categories | Read |
get_categories_changelog | Categories | Read |
get_category_changelog | Categories | Read |
create_category | Categories | Write |
update_category | Categories | Write |
delete_category | Categories | Write |
update_category_layout | Categories | Write |
get_products | Products | Read |
search_products | Products | Read |
get_product_variants | Products | Read |
get_product_metadata | Products | Read |
get_products_changelog | Products | Read |
get_product_changelog | Products | Read |
create_product | Products | Write |
update_product | Products | Write |
delete_product | Products | Write |
get_variants | Variants | Read |
get_variant_metadata | Variants | Read |
get_variants_changelog | Variants | Read |
get_variant_changelog | Variants | Read |
create_variant | Variants | Write |
update_variant | Variants | Write |
delete_variant | Variants | Write |
list_custom_entities | Custom Entities | Read |
get_custom_entity | Custom Entities | Read |
get_custom_entity_metadata | Custom Entities | Read |
get_custom_entity_layout | Custom Entities | Read |
get_custom_entity_changelog | Custom Entities | Read |
get_custom_entity_item_changelog | Custom Entities | Read |
create_custom_entity | Custom Entities | Write |
update_custom_entity | Custom Entities | Write |
delete_custom_entity | Custom Entities | Write |
update_custom_entity_layout | Custom Entities | Write |
search_catalog | Search and analysis | Read |
build_dynamic_query | Search and analysis | Read |
suggest_optimal_query | Search and analysis | Read |
analyze_data_structure | Search and analysis | Read |
get_total_count | Counts and pagination | Read |
get_entity_counts | Counts and pagination | Read |
get_pagination_info | Counts and pagination | Read |
get_next_page | Counts and pagination | Read |
help_troubleshoot | Diagnostics and cache | Read |
help_search_multilingual | Diagnostics and cache | Read |
cache_stats | Diagnostics and cache | Read |
cache_clear | Diagnostics and cache | Write |
cache_control | Diagnostics and cache | Write |
dam_filter_images | DAM Images | Read |
dam_get_image | DAM Images | Read |
dam_create_image | DAM Images | Write |
dam_update_image | DAM Images | Write |
dam_delete_image | DAM Images | Write |
dam_filter_files | DAM Files | Read |
dam_get_file | DAM Files | Read |
dam_create_file | DAM Files | Write |
dam_update_file | DAM Files | Write |
dam_delete_file | DAM Files | Write |
Use these tools to establish which catalog, languages, entities, and fields are available before you read or write records.
| Tool | Purpose | Main parameters |
|---|---|---|
version | Returns the MCP Server version for diagnostics. | None |
validate_token | Validates catalog access and identifies the connected catalog. | None |
get_catalog_info | Summarizes catalog languages and multilingual fields. | None |
get_catalog_locales | Returns structured locale data and multilingual fields per entity. | None |
get_metadata | Returns the root Catalog service metadata. | force_refresh |
get_entity_fields | Lists fields, titles, types, multilingual flags, and enum values for an entity. | entity; optional field filters |
get_table_info | Combines counts, fields, languages, and pagination guidance for one entity. | entity; optional filters |
Use get_category_metadata, get_product_metadata, get_variant_metadata, or get_custom_entity_metadata when you need metadata for one specific resource. For a custom entity, pass its exact entity_name.
The main collection tools are entity-specific:
| Tool | Reads | Main parameters |
|---|---|---|
get_categories | Categories | filters, select, top, expand, orderby, include, expand_cultures, smart_select, show_all_fields |
get_products | Products | filters, select, top, expand, orderby, include, expand_cultures, smart_select, show_all_fields |
get_variants | Variants | filters, select, top, include, expand_cultures, smart_select, show_all_fields |
get_custom_entity | Items from one custom entity | entity_name, filters, select, top, expand_cultures, smart_select, show_all_fields |
Page-size limits vary by entity. Ask the assistant to call get_pagination_info; do not assume a fixed $top value.
Use internal field names in filters and payloads, but use the human-readable field titles returned in metadata when presenting results. Common prefixes are cat_ for Categories, prod_ for Products, and frmt_ for Variants. Custom Entity prefixes differ by catalog.
get_category_products reads the products below one category and requires numeric category_id. get_product_variants reads the variants below one product and requires numeric product_id. Resolve a business reference with get_categories or get_products first when necessary.
The following tools support OData filtering, ordering, and pagination over changelog records:
| Scope | All records | One record |
|---|---|---|
| Categories | get_categories_changelog | get_category_changelog with category_id |
| Products | get_products_changelog | get_product_changelog with product_id |
| Variants | get_variants_changelog | get_variant_changelog with variant_id |
| Custom Entities | get_custom_entity_changelog with entity_name | get_custom_entity_item_changelog with entity_name and id |
These endpoints do not support field selection or navigation expansion.
Attribute Sets v2 control the Product layout and, optionally, the Variant layout assigned to a set of products.
| Tool | Purpose | Main parameters |
|---|---|---|
get_attribute_sets | Lists attribute set identifiers and names. | None |
get_attribute_set | Gets the complete Product and Variant layout for one set. | id, including default |
create_attribute_set | Creates a set using existing attributes. | name; optional productLayout, variantLayout |
update_attribute_set | Renames a set or replaces either layout. | id; optional name, productLayout, variantLayout |
delete_attribute_set | Deletes a non-default set. | id, optional deleteAssociatedProductsAndVariants |
A supplied layout is a full structure, not a merge. Attribute IDs must already exist in the catalog. Before setting deleteAssociatedProductsAndVariants: true, note that the products and variants assigned to the set are deleted rather than reassigned to the default set.
Categories have one shared layout. Custom Entity layouts are selected by entity_name.
| Tool | Access | Behavior |
|---|---|---|
get_category_layout | Read | Returns the Category form layout. |
update_category_layout | Write | Fully replaces the Category form layout. |
get_custom_entity_layout | Read | Returns the layout for one Custom Entity. |
update_custom_entity_layout | Write | Fully replaces an existing Custom Entity layout. |
Call the corresponding get_*_layout tool first. Layout updates replace the full stored layout; they do not merge individual rows or fields.
| Tool | Purpose | Main parameters |
|---|---|---|
search_catalog | Searches title and reference fields in Categories, Products, or Variants. | query; optional entity, filters, top |
search_products | Searches Product titles with category, status, price, and Variant options. | query; optional structured filters |
build_dynamic_query | Builds and runs an OData query from a goal and key-value filters. | entity; optional search_term, filters, include_related, smart_select, max_results |
suggest_optimal_query | Recommends a query shape without changing data. | entity; optional user_intent, performance_priority |
analyze_data_structure | Samples records and reports fields, types, values, and total count. | entity; optional sample_size, analyze_custom_fields |
Plain text search targets the default catalog language. For another language, query its suffixed field explicitly, such as prod_title_es, or use help_search_multilingual.
| Tool | Purpose | Main parameters |
|---|---|---|
get_total_count | Counts one standard or custom entity without downloading its records. | entity; optional filters, custom_entity_name |
get_entity_counts | Counts several comma-separated entities in one request. | entities |
get_pagination_info | Reports or probes current pagination limits. | optional entity, detect_limits |
get_next_page | Follows an @nextLink from a previous response. | next_url; optional entity_type |
help_troubleshoot | Returns guidance for a described problem. | optional issue |
help_search_multilingual | Returns language-aware search guidance. | optional entity, search_context |
cache_stats | Reports cache use and performance. | optional detailed |
cache_clear | Clears cached data after confirmation. | optional entity, confirm |
cache_control | Enables, disables, or reports cache state. | action |
cache_clear and cache_control change server runtime state, so they require Full access even though they do not modify Catalog or DAM records.
Use the dedicated tool for the entity you are changing. Discover fields with get_entity_fields or the resource metadata tool first; Catalog schemas and multilingual configuration vary by tenant.
| Entity | Create | Update | Delete |
|---|---|---|---|
| Categories | create_category | update_category | delete_category |
| Products | create_product | update_product | delete_product |
| Variants | create_variant | update_variant | delete_variant |
| Custom Entities | create_custom_entity | update_custom_entity | delete_custom_entity |
Category, Product, and Variant create/update tools execute when called. Their delete tools require a second call with confirm: true. Deleting a Product also deletes its Variants.
Custom Entity create, update, and delete tools use a two-step preview and confirmation flow. Pass entity_name and use the entity's real metadata to build data. Updates and deletes accept either numeric id or business ref, but not both. Custom Entity deletion does not check relationships.
Full access is not a substitute for review: some write tools do not have a server-side preview. Use a client that asks before tool execution and test write workflows against a non-production catalog.
DAM Images are separate from Catalog records and from the DAM Files library.
| Tool | Access | Purpose | Main parameters |
|---|---|---|---|
dam_filter_images | Read | Lists and filters images with pagination. | optional filter, orderby, top, skip |
dam_get_image | Read | Gets one image and its processing status. | reference |
dam_create_image | Write | Imports an image from a public HTTP or HTTPS URL. | url; optional tags |
dam_update_image | Write | Replaces image content and/or tags without changing its reference. | reference; url and/or tags |
dam_delete_image | Write | Permanently deletes an image. | reference |
Image import and content replacement are asynchronous. Use dam_get_image until the status is Ok or Er. A replacement URL may use a different filename, but the image keeps its existing reference and the replacement's actual file type must match. Omitting tags leaves them unchanged; send an empty array to clear them.
DAM Files cover non-image assets such as documents, spreadsheets, archives, presentations, video, and design files.
| Tool | Access | Purpose | Main parameters |
|---|---|---|---|
dam_filter_files | Read | Lists and filters files with pagination. | optional filter, orderby, top, skip |
dam_get_file | Read | Gets one file, including its numLinks value. | reference |
dam_create_file | Write | Imports a file from a public HTTP or HTTPS URL. | url; optional tags |
dam_update_file | Write | Replaces file content and/or tags without changing its reference. | reference; url and/or tags |
dam_delete_file | Write | Permanently deletes a file. | reference |
Files are available immediately; they do not use the background image-processing flow. Before deleting a file, inspect numLinks: the delete tool does not repoint Catalog records that still reference it.
Older clients may still know the generic tools get_table_items, create_item, update_item, and delete_item. They remain routable for compatibility but are hidden from tool discovery. New connections should use the dedicated entity tools documented on this page.