Servidor MCP

HPControl Industrial Catalog

pl.hpcontrol/catalog
Negocio y operaciones Comercio y retail Requiere autenticación MCP 2025-11-25

Qué hace este MCP

Searches an industrial product catalogue for valves and pneumatic equipment, retrieves live pricing and availability, configures products, and manages carts.

cancel_cart
Cancel shopping cart
Cancel an active cart when the customer no longer wants it. This operation is idempotent.
Destructivo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['cart_ref'], 'properties': {'cart_ref': {'type': 'string', 'pattern': '^[0-9a-f]{32}$'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['status', 'last_state'], 'properties': {'status': {'enum': ['canceled'], 'type': 'string'}, 'last_state': {'type': 'object', 'required': ['cart_ref', 'status', 'items', 'totals'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object'}}, 'status': {'type': 'string'}, 'totals': {'type': 'object'}, 'cart_ref': {'type': 'string'}, 'expires_at': {'type': ['string', 'null']}, 'continue_url': {'type': ['string', 'null']}, 'idempotent_replay': {'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}
configure_product
Configure a catalog product
Validate public bundle selections and create a temporary configuration handle. Use only public_value_id values returned by search_catalog.
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['product_sku', 'selections'], 'properties': {'selections': {'type': 'array', 'items': {'type': 'object', 'required': ['public_value_id'], 'properties': {'qty': {'type': 'integer', 'default': 1, 'maximum': 10000, 'minimum': 1}, 'public_value_id': {'type': 'string', 'pattern': '^pv_[A-Za-z0-9_-]{24}$', 'description': 'Value ID returned in configuration_options by search_catalog.'}}, 'additionalProperties': False}, 'maxItems': 20, 'description': 'Selected public values. Required catalog defaults are applied automatically when exactly one default exists.'}, 'product_sku': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'minLength': 1, 'description': 'Stable caller key to reuse when retrying this operation.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['status', 'errors', 'applied_selections'], 'properties': {'errors': {'type': 'array', 'items': {'type': 'string'}}, 'status': {'enum': ['ok', 'invalid'], 'type': 'string'}, 'expires_at': {'type': ['string', 'null']}, 'unit_price': {'type': ['object', 'null']}, 'price_breakdown': {'type': 'array', 'items': {'type': 'object'}}, 'applied_selections': {'type': 'array', 'items': {'type': 'object'}}, 'configuration_handle': {'type': ['string', 'null']}}, 'additionalProperties': False}
create_cart
Create a shopping cart
Create an HPControl cart. Simple products use SKU; configurable bundle products require a configuration_handle.
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'oneOf': [{'not': {'required': ['configuration_handle']}, 'required': ['sku']}, {'not': {'required': ['sku']}, 'required': ['configuration_handle']}], 'required': ['qty'], 'properties': {'qty': {'type': 'integer', 'maximum': 10000, 'minimum': 1}, 'sku': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'configuration_handle': {'type': 'string', 'pattern': '^[0-9a-f]{48}$'}}, 'additionalProperties': False}, 'maxItems': 20, 'minItems': 1}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'minLength': 1}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['cart_ref', 'status', 'items', 'totals'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object'}}, 'status': {'type': 'string'}, 'totals': {'type': 'object'}, 'cart_ref': {'type': 'string'}, 'expires_at': {'type': ['string', 'null']}, 'continue_url': {'type': ['string', 'null']}, 'idempotent_replay': {'type': 'boolean'}}, 'additionalProperties': False}
get_cart
Get shopping cart
Read the current items, totals and status of a cart.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['cart_ref'], 'properties': {'cart_ref': {'type': 'string', 'pattern': '^[0-9a-f]{32}$'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['cart_ref', 'status', 'items', 'totals'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object'}}, 'status': {'type': 'string'}, 'totals': {'type': 'object'}, 'cart_ref': {'type': 'string'}, 'expires_at': {'type': ['string', 'null']}, 'continue_url': {'type': ['string', 'null']}, 'idempotent_replay': {'type': 'boolean'}}, 'additionalProperties': False}
get_product
Get live product details
Get live product description, media, categories and bundle options, together with current price and availability.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['sku'], 'properties': {'sku': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'fields': {'type': 'array', 'items': {'enum': ['description', 'media', 'categories', 'bundle_options'], 'type': 'string'}, 'maxItems': 4}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['store_id', 'currency', 'item'], 'properties': {'item': {'type': 'object'}, 'currency': {'type': 'string'}, 'store_id': {'type': 'integer'}}, 'additionalProperties': False}
lookup_catalog
Look up live catalog products
Look up up to 20 products by SKU using live Magento availability, visibility, prices and tier prices.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['skus'], 'properties': {'skus': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'maxItems': 20, 'minItems': 1}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['store_id', 'currency', 'items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object'}}, 'currency': {'type': 'string'}, 'store_id': {'type': 'integer'}}, 'additionalProperties': False}
search_catalog
Search HPControl catalog
Search the catalog for the selected storefront by name, SKU, EAN, model code or technical requirement. Bundle results expose public configuration_options; never infer compatibility from missing fields.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 20, 'minimum': 1}, 'query': {'type': 'string', 'default': '', 'maxLength': 256, 'description': 'Product name, SKU, EAN, model code or technical requirement.'}, 'cursor': {'type': 'string', 'maxLength': 2048}, 'context': {'type': 'object', 'properties': {'intent': {'type': 'string', 'maxLength': 64}, 'currency': {'type': 'string', 'maxLength': 3, 'minLength': 3}, 'language': {'type': 'string', 'maxLength': 12, 'minLength': 2}, 'address_country': {'type': 'string', 'maxLength': 2, 'minLength': 2}}, 'additionalProperties': False}, 'filters': {'type': 'object', 'properties': {'category': {'type': 'string', 'maxLength': 128}, 'price_max': {'type': 'integer', 'minimum': 0, 'description': 'Maximum price in minor currency units.'}, 'price_min': {'type': 'integer', 'minimum': 0, 'description': 'Minimum price in minor currency units.'}, 'category_ids': {'type': 'array', 'items': {'type': 'integer', 'minimum': 1}, 'maxItems': 20}, 'available_only': {'type': 'boolean', 'default': False}}, 'additionalProperties': False}, 'requested_quantity': {'type': 'integer', 'maximum': 10000, 'minimum': 1}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schema_version', 'store_id', 'items', 'total'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object'}}, 'query': {'type': 'string'}, 'total': {'type': 'object'}, 'took_ms': {'type': 'integer'}, 'store_id': {'type': 'integer'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'next_cursor': {'type': ['string', 'null']}, 'schema_version': {'type': 'string'}, 'catalog_version': {'type': ['string', 'null']}, 'normalized_query': {'type': 'string'}}, 'additionalProperties': True}
update_cart
Replace shopping cart items
Replace the complete item set of an existing cart. Existing lines omitted from items are removed.
Destructivo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['cart_ref', 'items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'oneOf': [{'not': {'required': ['configuration_handle']}, 'required': ['sku']}, {'not': {'required': ['sku']}, 'required': ['configuration_handle']}], 'required': ['qty'], 'properties': {'qty': {'type': 'integer', 'maximum': 10000, 'minimum': 1}, 'sku': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'configuration_handle': {'type': 'string', 'pattern': '^[0-9a-f]{48}$'}}, 'additionalProperties': False}, 'maxItems': 20, 'minItems': 1, 'description': 'Complete replacement set. Omitted existing lines are removed.'}, 'cart_ref': {'type': 'string', 'pattern': '^[0-9a-f]{32}$'}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'minLength': 1}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['cart_ref', 'status', 'items', 'totals'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object'}}, 'status': {'type': 'string'}, 'totals': {'type': 'object'}, 'cart_ref': {'type': 'string'}, 'expires_at': {'type': ['string', 'null']}, 'continue_url': {'type': ['string', 'null']}, 'idempotent_replay': {'type': 'boolean'}}, 'additionalProperties': False}
Añadido
cancel_cart
17 de September de 2026 a las 12:54
Añadido
get_cart
17 de September de 2026 a las 12:54
Añadido
update_cart
17 de September de 2026 a las 12:54
Añadido
create_cart
17 de September de 2026 a las 12:54
Añadido
configure_product
17 de September de 2026 a las 12:54
Añadido
get_product
17 de September de 2026 a las 12:54
Añadido
lookup_catalog
17 de September de 2026 a las 12:54
Añadido
search_catalog
17 de September de 2026 a las 12:54