{"schema_version":"2026-06-29","name":"alser-kz-readonly-mcp","title":"ALSER.kz Read-only MCP","description":"Public read-only Model Context Protocol endpoint for ALSER.kz product and promotion discovery.","publisher":{"name":"ALSER.kz","url":"https://alser.kz"},"server":{"url":"https://alser.kz/mcp","transport":"streamable-http","protocol":"model-context-protocol","protocol_versions":["2025-06-18","2025-03-26"],"methods":["POST"],"content_types":{"request":"application/json","response":"application/json"}},"capabilities":{"tools":true,"resources":false,"prompts":false,"sampling":false,"read_only":true},"auth":{"type":"none","required":false,"note":"Only public read-only site data is exposed. User account and checkout operations are not available."},"tools":[{"name":"get_product_detail","title":"Get ALSER.kz product detail","read_only":true,"description":"Read public product price, availability, delivery terms, specifications, and optional description, reviews, and store availability by sku or product keyword."},{"name":"search_products","title":"Search ALSER.kz products","read_only":true,"description":"Search public products by a text query."},{"name":"list_promos","title":"List ALSER.kz promotions","read_only":true,"description":"Read public promotions for a city/location."},{"name":"get_promo_products","title":"Get ALSER.kz promotion products","read_only":true,"description":"Read public products attached to a promotion."},{"name":"get_shops","title":"Get ALSER.kz shops","read_only":true,"description":"Read public shop pickup points by city code."},{"name":"get_cities","title":"Get ALSER.kz cities","read_only":true,"description":"Read the public list of cities and the codes other tools expect (city_code, location_id)."},{"name":"get_homepage_blocks","title":"Get ALSER.kz homepage blocks","read_only":true,"description":"Read public homepage blocks: product of the day, sale, best sellers, new products, popular products, popular categories, and articles."},{"name":"get_catalog_tree","title":"Get ALSER.kz catalog tree","read_only":true,"description":"Read the public catalog category hierarchy."},{"name":"get_catalog_products","title":"Get ALSER.kz catalog products","read_only":true,"description":"Read and filter public products in a catalog category."},{"name":"get_catalog_filters","title":"Get ALSER.kz catalog filters","read_only":true,"description":"Read available filters, prices, promotions, product types, and sorting for a category."}],"safety":{"data_classification":"public","side_effects":"none","pii":false,"payments":false,"checkout":false},"links":{"self":"https://alser.kz/.well-known/mcp-server","json":"https://alser.kz/.well-known/mcp-server.json","mcp":"https://alser.kz/mcp","api_catalog":"https://alser.kz/.well-known/api-catalog","llms":"https://alser.kz/llms.txt","status":"https://alser.kz/api/hc"}}