{"$schema":"https://modelcontextprotocol.io/schema/server-card.json","specVersion":"1.0","name":"vieton-mcp-server","displayName":"Vieton Celebrity & Ranking MCP Server","description":"Cung cấp các công cụ tra cứu thông tin tiểu sử, sự nghiệp, năm sinh, quê quán, vợ/chồng, gia đình và bảng xếp hạng người nổi tiếng Việt Nam.","homepage":"https://www.vieton.net","documentationUrl":"https://www.vieton.net/llms.txt","transport":{"type":"http","url":"https://www.vieton.net/api/mcp"},"capabilities":{"tools":{"listChanged":false}},"tools":[{"name":"get_celebrity_personal_info","description":"Tra cứu thông tin cá nhân, tiểu sử, ngày sinh, quê quán, tuổi tác, bạn đời/vợ chồng, gia đình, giải thưởng, sự nghiệp và thứ hạng của nhân vật nổi tiếng trên Vieton.","inputSchema":{"type":"object","properties":{"name":{"type":"string","description":"Tên nghệ danh, tên thật hoặc slug của nhân vật (ví dụ: 'Trấn Thành', 'Sơn Tùng M-TP', 'Hari Won')"},"topic":{"type":"string","description":"Chủ đề tra cứu cụ thể: 'all' (tổng hợp đầy đủ), 'bio' (tiểu sử), 'birthday' (ngày sinh), 'hometown' (quê quán), 'age' (tuổi tác), 'spouse' (vợ/chồng), 'family' (gia đình), 'awards' (giải thưởng & thành tựu), 'career' (sự nghiệp & tác phẩm), 'ranking' (thứ hạng)","enum":["all","bio","birthday","hometown","age","spouse","family","awards","career","ranking"],"default":"all"},"referenceDate":{"type":"string","description":"Ngày tham chiếu dùng để tính tuổi chính xác theo chuẩn YYYY-MM-DD (mặc định là ngày hiện tại)"}},"required":["name"]}},{"name":"search_profiles","description":"Tìm kiếm hoặc hỏi đáp thông minh về người nổi tiếng, bảng xếp hạng và các danh mục trên Vieton bằng ngôn ngữ tự nhiên (ví dụ: 'tiểu sử ca sĩ Sơn Tùng M-TP', 'ai đứng đầu danh mục Âm nhạc', 'giải thích các yếu tố ảnh hưởng đến thứ hạng', 'vợ của Trấn Thành là ai').","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Câu hỏi tự nhiên hoặc từ khóa cần tra cứu (ví dụ: 'tiểu sử Sơn Tùng', 'vợ Trấn Thành là ai', 'ai đứng đầu danh mục Âm nhạc', 'giải thưởng của Sơn Tùng')"},"referenceDate":{"type":"string","description":"Ngày tham chiếu dùng để tính tuổi chính xác theo chuẩn YYYY-MM-DD (mặc định là ngày hiện tại)"}},"required":["query"]}},{"name":"get_category_rankings","description":"Tra cứu bảng xếp hạng và các nhân vật nổi bật theo danh mục cụ thể (ví dụ: 'Âm nhạc', 'Giải trí', 'Điện ảnh & Truyền hình', 'Social Media', 'Kinh doanh', 'Thể thao') trên Vieton.","inputSchema":{"type":"object","properties":{"category":{"type":"string","description":"Tên danh mục hoặc slug (ví dụ: 'Âm nhạc', 'am-nhac', 'Giải trí', 'giai-tri', 'Điện ảnh & Truyền hình')"},"limit":{"type":"number","description":"Số lượng nhân vật cần lấy (mặc định: 5, tối đa: 20)","default":5},"sortBy":{"type":"string","description":"Tiêu chí sắp xếp: 'rawScore' (điểm tổng hợp), 'views' (lượt xem), 'trendingScore' (thịnh hành)","enum":["rawScore","views","trendingScore"],"default":"rawScore"}},"required":["category"]}},{"name":"explain_ranking_factors","description":"Giải thích các nguyên tắc và nhóm tín hiệu chính cấu thành thứ hạng người nổi tiếng trên Vieton theo tài liệu chính thức how-vieton-ranks.","inputSchema":{"type":"object","properties":{"focus":{"type":"string","description":"Nhóm tín hiệu cần giải thích: 'all' (toàn bộ nguyên tắc), 'views' (lượt xem & quan tâm), 'social' (mạng xã hội), 'awards' (thành tích), 'platform' (tín hiệu Vieton)","enum":["all","views","social","awards","platform"],"default":"all"}}}},{"name":"compare_celebrities","description":"So sánh đối đầu giữa 2 hoặc nhiều người nổi tiếng trên Vieton dựa trên dữ liệu xác thực: thứ hạng, lượt xem, tuổi, nghề nghiệp, giải thưởng.","inputSchema":{"type":"object","properties":{"names":{"type":"string","description":"Danh sách tên các nhân vật cần so sánh, cách nhau bằng dấu phẩy (ví dụ: 'Sơn Tùng M-TP, Trấn Thành')"},"first":{"type":"string","description":"Tên nhân vật thứ nhất cần so sánh"},"second":{"type":"string","description":"Tên nhân vật thứ hai cần so sánh"}},"required":["names"]}}]}