LsTuvi - Tử Vi & Lịch âm

Builds Vietnamese Tử Vi (Purple Star) birth charts, converts lunar and solar dates, gives lunar calendar info for a day, finds good days and checks age compatibility. Remote HTTP endpoint, no sign-in. Results are in Vietnamese.

Hosted MCP Server

npx add-mcp 'https://lstuvi.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Tài liệu API và MCP

Gốc API: https://api.lstuvi.com/api. Tất cả là GET, trả JSON, không cần đăng nhập. Mô tả đầy đủ ở /openapi.json (OpenAPI 3.1), danh mục máy đọc ở /.well-known/api-catalog.

  • GET /health Trạng thái dịch vụ
  • GET /posts``?limit=1..100 Danh sách bài viết đã đăng
  • GET /posts/{slug} Một bài viết theo slug
  • GET /settings/public Giá luận giải (xu) và số câu chat miễn phí
  • GET /chat/packages Gói Chat Tử Vi
  • GET /wallet/packages Gói nạp xu (VND)

Máy chủ MCP cho trợ lý AI

Địa chỉ: https://lstuvi.com/mcp (Streamable HTTP, không cần đăng nhập, miễn phí). Trợ lý AI dùng được các công cụ dưới đây để trả lời bằng dữ liệu của lstuvi.com. Mỗi kết quả có đường dẫn về trang tương ứng trên lstuvi.com để xem lá số đầy đủ và luận giải chi tiết.

Thêm vào Claude

  1. Trên claude.ai hoặc ứng dụng Claude: Cài đặt → Connectors → Add custom connector, dán https://lstuvi.com/mcp.
  2. Claude Code: claude mcp add --transport http lstuvi https://lstuvi.com/mcp
  3. Hỏi bình thường, ví dụ: “Lập lá số tử vi cho tôi, nam, sinh 15/8/1990 lúc 10 giờ sáng”.

ChatGPT dùng https://lstuvi.com/mcp?client=chatgpt. Ứng dụng khác hỗ trợ MCP (Cursor…) dùng địa chỉ chính. Thông tin máy đọc ở /.well-known/mcp/server-card.json.

Công cụ

  • create_tuvi_chart Create Tử Vi chart Builds a Vietnamese Tử Vi Đẩu Số (Purple Star) birth chart from Gregorian birth date, birth time and gender: lunar date, can chi, nạp âm, cục, the 12 palaces with their stars, and a short rule-based reading of each palace. Use when the user wants their Tử Vi chart or asks what their chart says.
  • convert_lunar_solar Convert lunar and solar dates Converts a date between the Gregorian calendar and the Vietnamese lunar calendar (with leap months, 1900–2100), and gives the can chi of the day, month and year plus the solar term.
  • get_lunar_day Get lunar calendar day Returns the Vietnamese lunar calendar entry for one Gregorian date (default today): lunar date, can chi, hoàng đạo or hắc đạo day, trực, lunar mansion, ages that clash with the day, taboo days and the auspicious hours.
  • find_good_days Find good days in a month Ranks the days of one Gregorian month for an activity (wedding, opening a shop, moving house, signing a contract, travel…) by Vietnamese day-selection rules, optionally checked against the birth years of the people involved. Returns the best days with reasons and good hours, and the days to avoid.
  • check_age_compatibility Check age compatibility Compares two people by birth year and gender using Vietnamese age-matching (nạp âm element, heavenly stem, earthly branch, Bát Trạch cung phi, zodiac animal) and returns a score out of 100 with each factor explained.
  • find_compatible_birth_years Find compatible birth years For one person's birth year and gender, scores every partner birth year within a range by the same Vietnamese age-matching rules and returns the best and worst matching years.
  • get_2027_forecast_by_birth_year Get 2027 outlook by birth year Returns the traditional facts for a birth year in the lunar year 2027 (Đinh Mùi): age, relation of the birth branch and stem with the year, element relation, Tam Tai, Kim Lâu, and the yearly palace for men and women.
  • search_articles Search lstuvi articles Searches the Vietnamese articles published on lstuvi.com about Tử Vi, palaces, stars, the lunar calendar and yearly outlooks. Returns titles, slugs and short descriptions.
  • get_article Read an lstuvi article Returns the summary of one lstuvi.com article by slug (from search_articles): the short answer, key points and FAQ, or the opening of the article.
  • get_pricing Get lstuvi prices Returns which lstuvi.com features are free and the current prices of the paid ones: detailed chart reading, couple reading, Tử Vi chat packages and coin top-up packages.

Dữ liệu

Công cụ chỉ nhận thông tin cần để tính (ngày giờ sinh, giới tính, năm sinh, tháng cần xem, từ khóa) và không lưu lại. Chi tiết ở chính sách quyền riêng tư.

Luận giải chi tiết và Chat Tử Vi cần tài khoản nên không mở qua API hay MCP. Cần dùng nhiều hơn, gửi thư tới lienhe@lstuvi.com.