MCP Server

KaliCart Global (UCP Catalog)

io.github.giuseppesocci-bot/kalicart-global-ucp
Commerce & Retail Public & reachable MCP 2025-11-25

What this MCP does

Searches independent WooCommerce catalogs and retrieves product details, live prices, and availability.

get_product
Get product detail with live price and availability (UCP Catalog)
UCP Catalog product detail by product or variant id. Reads variants, price and availability live from the merchant KaliCart Bridge within a short time budget; if the merchant does not answer in time the indexed snapshot is returned and marked as such. The product url is the merchant storefront where the purchase happens.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['catalog'], 'properties': {'meta': {'type': 'object', 'properties': {'ucp-agent': {'type': 'object', 'properties': {'profile': {'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'catalog': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'context': {'type': 'object', 'properties': {'intent': {'type': 'string'}, 'currency': {'type': 'string'}, 'language': {'type': 'string'}, 'postal_code': {'type': 'string'}, 'address_region': {'type': 'string'}, 'address_country': {'type': 'string'}}, 'additionalProperties': True}, 'filters': {'type': 'object', 'properties': {'brand': {'type': 'string'}, 'color': {'type': 'string'}, 'price': {'type': 'object', 'properties': {'max': {'type': 'integer', 'minimum': 0}, 'min': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': True}, 'gender': {'enum': ['female', 'male', 'unisex'], 'type': 'string'}, 'available': {'type': 'boolean'}, 'categories': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': True}, 'signals': {'type': 'object', 'additionalProperties': {}}, 'selected': {'type': 'array'}, 'attribution': {'type': 'object', 'additionalProperties': {}}, 'preferences': {'type': 'array'}}, 'additionalProperties': True}}, 'additionalProperties': True}
lookup_catalog
Look up products or variants by id (UCP Catalog)
UCP Catalog lookup by product or variant identifier (gid://kalicart/Product/... or gid://kalicart/ProductVariant/...). Up to 25 ids. Reads price and availability live from each merchant when possible (metadata.kalicart.source = "live"), otherwise returns the indexed snapshot and says so. Unknown ids are reported as not_found messages.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['catalog'], 'properties': {'meta': {'type': 'object', 'properties': {'ucp-agent': {'type': 'object', 'properties': {'profile': {'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'catalog': {'type': 'object', 'required': ['ids'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1}, 'context': {'type': 'object', 'properties': {'intent': {'type': 'string'}, 'currency': {'type': 'string'}, 'language': {'type': 'string'}, 'postal_code': {'type': 'string'}, 'address_region': {'type': 'string'}, 'address_country': {'type': 'string'}}, 'additionalProperties': True}, 'filters': {'type': 'object', 'properties': {'brand': {'type': 'string'}, 'color': {'type': 'string'}, 'price': {'type': 'object', 'properties': {'max': {'type': 'integer', 'minimum': 0}, 'min': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': True}, 'gender': {'enum': ['female', 'male', 'unisex'], 'type': 'string'}, 'available': {'type': 'boolean'}, 'categories': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': True}, 'signals': {'type': 'object', 'additionalProperties': {}}, 'attribution': {'type': 'object', 'additionalProperties': {}}}, 'additionalProperties': True}}, 'additionalProperties': True}
search_catalog
Search products across merchants (UCP Catalog)
UCP Catalog search across independent WooCommerce merchants in KaliCart Global. catalog.query is free text; catalog.filters.categories accepts KaliCart canonical category values as returned in products[].categories (taxonomy "kalicart", e.g. "home.bedroom.pillows"); filters.price is in ISO 4217 minor units of catalog.context.currency (default EUR). Results are indexed snapshots with the seller on every variant; verify the chosen product with get_product before quoting price or stock.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['catalog'], 'properties': {'meta': {'type': 'object', 'properties': {'ucp-agent': {'type': 'object', 'properties': {'profile': {'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'catalog': {'type': 'object', 'properties': {'query': {'type': 'string'}, 'context': {'type': 'object', 'properties': {'intent': {'type': 'string'}, 'currency': {'type': 'string'}, 'language': {'type': 'string'}, 'postal_code': {'type': 'string'}, 'address_region': {'type': 'string'}, 'address_country': {'type': 'string'}}, 'additionalProperties': True}, 'filters': {'type': 'object', 'properties': {'brand': {'type': 'string'}, 'color': {'type': 'string'}, 'price': {'type': 'object', 'properties': {'max': {'type': 'integer', 'minimum': 0}, 'min': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': True}, 'gender': {'enum': ['female', 'male', 'unisex'], 'type': 'string'}, 'available': {'type': 'boolean'}, 'categories': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': True}, 'signals': {'type': 'object', 'additionalProperties': {}}, 'pagination': {'type': 'object', 'properties': {'limit': {'type': 'integer', 'minimum': 1}, 'cursor': {'type': 'string'}}, 'additionalProperties': True}, 'attribution': {'type': 'object', 'additionalProperties': {}}}, 'additionalProperties': True}}, 'additionalProperties': True}
Added
get_product
Sept. 27, 2026, 2:40 a.m.
Added
lookup_catalog
Sept. 27, 2026, 2:40 a.m.
Added
search_catalog
Sept. 27, 2026, 2:40 a.m.