MCP Server
HPControl Industrial Catalog
pl.hpcontrol/catalog
What this MCP does
Searches an industrial product catalogue for valves and pneumatic equipment, retrieves live pricing and availability, configures products, and manages carts.
Capabilities
Tools
8
tools
cancel_cart
Cancel shopping cart
Cancel an active cart when the customer no longer wants it. This operation is idempotent.
Destructive
Idempotent
Input schema
{'type': 'object', 'required': ['cart_ref'], 'properties': {'cart_ref': {'type': 'string', 'pattern': '^[0-9a-f]{32}$'}}, 'additionalProperties': False}
Output schema
{'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.
Idempotent
Input schema
{'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}
Output schema
{'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.
Idempotent
Input schema
{'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}
Output schema
{'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.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['cart_ref'], 'properties': {'cart_ref': {'type': 'string', 'pattern': '^[0-9a-f]{32}$'}}, 'additionalProperties': False}
Output schema
{'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.
Read only
Idempotent
Input schema
{'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}
Output schema
{'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.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['skus'], 'properties': {'skus': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'maxItems': 20, 'minItems': 1}}, 'additionalProperties': False}
Output schema
{'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.
Read only
Idempotent
Input schema
{'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}
Output schema
{'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.
Destructive
Idempotent
Input schema
{'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}
Output schema
{'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}
History
Recent tool changes
Added
cancel_cart
Sept. 17, 2026, 12:54 p.m.
Added
get_cart
Sept. 17, 2026, 12:54 p.m.
Added
update_cart
Sept. 17, 2026, 12:54 p.m.
Added
create_cart
Sept. 17, 2026, 12:54 p.m.
Added
configure_product
Sept. 17, 2026, 12:54 p.m.
Added
get_product
Sept. 17, 2026, 12:54 p.m.
Added
lookup_catalog
Sept. 17, 2026, 12:54 p.m.
Added
search_catalog
Sept. 17, 2026, 12:54 p.m.
Discover
Similar MCP servers
AgentLot Marketplace
io.agentlot/marketplace
Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.
zobrx
com.zobrx/zobrx
Provides read-only ecommerce operations and analytics for orders, inventory, marketplace performance, advertising, settlements, t…
SupplySlate
com.supplyslate/sourcing
Supports component sourcing, fabrication requests, supplier RFQs, catalog imports, quotes, purchase planning, checkout handoffs, …
Obriym CRM
com.obriym-crm/mcp
Manages CRM records, sales pipelines, activities, orders, products, inventory, and marketplace catalog operations.
velora
com.somosvelora/velora
Provides Argentine commerce operations including catalog and inventory, customer and supplier management, cash register tracking,…
Shopify
io.github.pipeworx-io/shopify
Provides read access to Shopify Admin data for store operations through the Shopify REST API.
Woocommerce
io.github.pipeworx-io/woocommerce
Provides access to WooCommerce store data through the WooCommerce REST API.
Troostwijk
io.github.pipeworx-io/troostwijk
Searches European industrial and insolvency liquidation auctions and retrieves auction lot details.