{"mcp_version":"2024-11-05","name":"Osmo Commerce Public MCP","version":"1.0.0","description":"Public MCP server endpoints for discovering products, previewing pricing, and placing orders.","transport":{"type":"sse","endpoint":"https://api.osmo.vn/api/v1/client/mcp/sse"},"capabilities":{"tools":{"list":[{"name":"search_products","description":"Tìm kiếm sản phẩm bằng ngôn ngữ tự nhiên thông qua Vector Search (RAG).","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Từ khóa hoặc mô tả nhu cầu tìm sản phẩm"},"limit":{"type":"integer","default":5,"description":"Số kết quả tối đa"}},"required":["query"]}},{"name":"search_articles","description":"Tìm kiếm bài viết, hướng dẫn, chính sách bán hàng bằng ngôn ngữ tự nhiên.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Câu hỏi hoặc nội dung cần tra cứu"},"limit":{"type":"integer","default":5}},"required":["query"]}},{"name":"preview_pricing","description":"Tính toán báo giá đơn hàng trước khi mua (áp dụng điểm loyalty, ship fee).","inputSchema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string"},"variant_id":{"type":"string"},"quantity":{"type":"integer"}},"required":["product_id"]}},"points_to_redeem":{"type":"integer","default":0},"available_points":{"type":"integer","default":0}},"required":["items"]}},{"name":"stealth_checkout","description":"Tạo đơn hàng mua sắm tự động không cần tài khoản (guest checkout).","inputSchema":{"type":"object","properties":{"customer_name":{"type":"string"},"customer_phone":{"type":"string"},"customer_address":{"type":"string"},"total_amount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string"},"variant_id":{"type":"string"},"quantity":{"type":"integer"},"price":{"type":"number"}},"required":["product_id","price"]}},"idempotency_key":{"type":"string"},"sandbox":{"type":"boolean"},"callback_url":{"type":"string","description":"Webhook URL nhận trạng thái đơn"}},"required":["customer_name","customer_phone","customer_address","total_amount","items"]}},{"name":"get_product_detail","description":"Lấy thông tin chi tiết sản phẩm: giá, variants (combo tiers), stock, FAQs, thành phần, đánh giá.","inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"URL slug của sản phẩm"},"product_id":{"type":"string","description":"UUID của sản phẩm"}}}},{"name":"get_article_detail","description":"Lấy chi tiết bài viết/tin tức: tiêu đề, tóm tắt, metadata, FAQs, tags.","inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"URL slug của bài viết"},"article_id":{"type":"string","description":"UUID của bài viết"}}}},{"name":"get_promotions","description":"Xem danh sách khuyến mãi đang hoạt động: combo deals (mua X tặng Y, bundle) và voucher giảm giá.","inputSchema":{"type":"object","properties":{}}},{"name":"get_loyalty_policy","description":"Xem chính sách tích điểm, hạng thành viên (Silver/Gold/Platinum), quy đổi điểm, phí ship.","inputSchema":{"type":"object","properties":{}}},{"name":"chat_with_helen","description":"Chat với Helen AI — tư vấn sản phẩm, hỏi chính sách, đặt hàng qua hội thoại tự nhiên.","inputSchema":{"type":"object","properties":{"message":{"type":"string","description":"Nội dung tin nhắn"},"product_slug":{"type":"string","description":"Slug sản phẩm đang xem (optional context)"},"session_id":{"type":"string","description":"Session ID để duy trì cuộc hội thoại"},"customer_name":{"type":"string"},"customer_phone":{"type":"string"}},"required":["message"]}}]}}}