Bluestone PIM MCP tool reference

This reference lists the 111 tools available through the Production US Bluestone PIM product MCP server.

Your MCP client displays each tool's parameters, required fields, and result details. Tools run with the authenticated user's organization and permissions.

The full tool definitions, including input schemas, are available as JSON in MCP tools/list format: mcp-tools.prod-us.json.

This page is generated from the MCP server. Last updated: 2026-11-03T09:35:46Z.

Products and attributes

Create, retrieve, and update products, variants, attribute definitions, and attribute values.

Tool	Summary
`add_product_variant`	Assign product variant.
`change_products_archive_status`	Archive products by IDs.
`change_products_publish_state`	Change product states.
`count_attribute_definitions`	Get number of attribute definitions for given query.
`count_dictionary_attribute_definition_values`	Get number of dictionary values for given query.
`count_products`	Get number of products for given query.
`count_select_attribute_definition_values`	Get number of select values for given query.
`create_attribute_definition`	Create a new simple attribute definition.
`create_product`	Create new product.
`create_product_variant_group`	Create variant group.
`delete_product_variant`	Unassign product variant.
`find_attribute_definition_ids`	Search for attribute definitions for given query.
`find_attribute_definitions`	Search attribute definitions by a filter and return the matching ones as a paged list.
`find_dictionary_attribute_definition_values`	Search for dictionary values for given query.
`find_products`	Search for products for given query.
`find_select_attribute_definition_values`	Search for select values for given query.
`get_attribute_definition`	Show details of attribute definition.
`get_product`	Show product details.
`get_product_attributes`	Retrieve the attributes associated with a product.
`update_product`	Update product main details, supports partial update.
`update_products_attributes`	Upsert the values of one attribute across many products in a single bulk operation.

Catalogs, categories, and contexts

Work with catalog hierarchy, product-category assignments, and localization contexts.

Tool	Summary
`add_product_categories`	Assigns an existing product to one or more existing catalog categories.
`count_categories`	Get number of categories or catalogs for given query.
`create_catalog_node`	Create a catalog node (category) or a top-level catalog.
`create_catalog_node_attribute`	Create a simple Category Level Attribute (CLA) and schedule propagation task.
`create_catalog_node_column_attribute`	Create column Category Level Attribute (CLA) and schedule propagation task.
`create_catalog_node_compound_attribute`	Create compound Category Level Attribute (CLA) and schedule propagation task.
`create_catalog_node_dictionary_attribute`	Create dictionary Category Level Attribute (CLA) and schedule propagation task.
`create_catalog_node_matrix_attribute`	Create matrix Category Level Attribute (CLA) and schedule propagation task.
`delete_catalog_node`	Delete a catalog node (category) and its entire subtree.
`delete_catalog_node_attribute`	Delete Category Level Attribute (CLA) from catalog node/category.
`delete_product_category`	Unassigns a product from a single catalog category.
`find_catalog_node_attributes`	List Category Level Attributes (CLA) across all catalog nodes/categories.
`find_catalog_node_children`	List the direct child nodes (categories) of a catalog node.
`find_catalog_nodes_by_attribute_definition`	List all catalog nodes/categories that use the attribute definition in a Category Level Attribute (CLA).
`find_catalogs`	List top-level catalogs.
`find_categories`	Search categories or catalogs for given query.
`find_context_definitions`	List context definitions for the current organization.
`find_context_definitions_by_names`	List context definitions by names.
`get_catalog_node`	Describe catalog node/category.
`get_catalog_node_attributes`	List the Category Level Attributes (CLA) of one catalog node/category.
`get_context_definition`	Get a single context definition by id.
`update_catalog_node`	Partially update a catalog node's (category's) main details.
`update_catalog_node_attribute`	Update the value or the propagation, lock and mandatory flags of a Category Level Attribute (CLA) and schedule propagation task.
`update_catalog_node_column_attribute`	Update column Category Level Attribute (CLA) and schedule propagation task.
`update_catalog_node_dictionary_attribute`	Set values for dictionary Category Level Attribute (CLA) and schedule propagation task.
`update_catalog_node_matrix_attribute`	Update matrix Category Level Attribute (CLA) and schedule propagation task.

Assets

Manage media-bank assets, uploads, asset metadata, asset attributes, and asset labels.

Tool	Summary
`add_asset_attribute`	Assign attribute to asset.
`add_product_asset_by_id`	Attach a single existing asset to a product, identified by asset ID in the path.
`add_product_assets`	Attach several existing assets to a product in one call.
`change_asset_publish_status`	Update asset published flag.
`complete_asset_upload`	Complete asset creation.
`count_asset_labels`	Get number of asset labels for given query.
`create_asset_upload`	Create new empty asset.
`create_media_label`	Create a custom type of media label.
`delete_asset`	Mark current asset as deleted.
`delete_asset_label`	Removes given label from the asset's labels.
`delete_product_asset`	Detach an asset from a product, removing only the link between them.
`find_asset_labels`	Search for asset labels for given query.
`find_media_labels`	Lists labels.
`get_asset_attributes`	Get list of attributes associated to asset.
`get_asset_views`	Retrieve a single asset together with the requested views.
`get_assets_views_by_ids`	Show list of assets filtered by ids with details from given views.
`get_product_assets`	Retrieve the IDs of the assets associated with a product, in their display order and paginated.
`update_asset_description`	Update asset description.
`update_asset_dictionary_attribute`	Set values to dictionary asset's attribute
`update_asset_labels`	Sets the assets labels attribute.
`update_asset_name`	Update asset name.
`update_asset_select_attribute`	Set values to select asset's attribute
`update_asset_simple_attribute`	Set value to simple asset's attribute

Labels and relations

Work with product labels, relation definitions, and product-to-product connections.

Tool	Summary
`add_product_labels`	Add product labels to a product.
`count_product_labels`	Get number of labels for given query.
`count_relations`	Get number of relations for given query.
`create_label`	Create a new label.
`create_product_connection`	Relate a product to another product under a relation definition.
`delete_label`	Delete a label.
`delete_product_connections`	Remove every relation of one relation definition from a product.
`delete_product_labels`	Remove a set of labels from a product.
`find_labels`	List labels.
`find_product_labels`	Search for labels for given query.
`find_relations`	Search for relations for given query.
`get_product_connections`	List the relation definitions a product participates in, each with its direction(s).
`update_label`	Update a label.

Publishing

Create and complete publish sessions, and review their issues and reports.

Tool	Summary
`add_products_to_publish_session`	Add products to session.
`complete_publish_session`	Close session.
`create_publish_session`	Create a new sync session.
`get_publish_session`	Get sync session.
`get_publish_session_asset_issues`	Get assets issues for the session.
`get_publish_session_entity_issues`	Get entities issues for the session.
`get_publish_session_product_issues`	Get products issues for the session.
`get_publish_session_report`	Get a session report.

Completeness

Retrieve completeness scores and the requirements used to calculate them.

Tool	Summary
`find_completeness_score_requirements`	List requirements.
`find_completeness_scores`	Get scores.
`get_completeness_score`	Get detailed scores for single entity.
`get_completeness_score_requirements`	Get requirements for single entity.

History and audit events

Inspect recorded history and audit events for PIM entities.

Tool	Summary
`find_history_entries`	Retrieve the history (audit log) events recorded for one specific entity instance.

Asynchronous jobs

Inspect the state and result details of asynchronous work.

Tool	Summary
`get_async_task_status`	Read the status of a background task.

Tasks and users

Manage tasks, task products, comments, assignees, and organization users.

Tool	Summary
`add_task_comment`	Add a comment for given task
`add_task_products`	Assign products to task.
`complete_task`	Complete task by id of logged in user.
`complete_task_product`	Complete product in scope of a task.
`create_task`	Create new task.
`delete_task_product`	Delete product from task scope.
`find_task_comments`	List all comments with replies for given task.
`find_users`	Returns the list of users in the caller's organization.
`get_user`	Returns the user.
`update_task`	Update task data.
`update_task_assignee`	Assign task.

Platform guidance

Search and retrieve indexed Bluestone platform guidance and recently updated content.

Tool	Summary
`get_latest_platform_guidance_content`	Retrieve the most recently updated indexed pages.
`get_platform_guidance_content_details`	Retrieve full content by its ID.
`search_platform_guidance`	Search indexed documentation by semantic meaning and keywords.