Vietnamese Tử Vi charts, lunar calendar, good-day finder and age compatibility. Free, no sign-in.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http tuvi https://lstuvi.com/mcp
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.
| Argument | Type | Description |
|---|---|---|
| person1* | object | |
| person2* | object |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"person1",
"person2"
],
"properties": {
"person1": {
"type": "object",
"required": [
"birth_year",
"gender"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40
},
"gender": {
"enum": [
"nam",
"nu"
],
"type": "string",
"description": "\"nam\" = male, \"nu\" = female"
},
"birth_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1920
}
}
},
"person2": {
"type": "object",
"required": [
"birth_year",
"gender"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40
},
"gender": {
"enum": [
"nam",
"nu"
],
"type": "string",
"description": "\"nam\" = male, \"nu\" = female"
},
"birth_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1920
}
}
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| date* | string | YYYY-MM-DD; for lunar_to_solar this is the lunar year, month and day |
| direction* | string | |
| leap_month | boolean | lunar_to_solar only: true if the lunar month is a leap month |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"direction",
"date"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD; for lunar_to_solar this is the lunar year, month and day"
},
"direction": {
"enum": [
"solar_to_lunar",
"lunar_to_solar"
],
"type": "string"
},
"leap_month": {
"type": "boolean",
"description": "lunar_to_solar only: true if the lunar month is a leap month"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| name | string | |
| gender* | string | "nam" = male, "nu" = female |
| view_year | integer | Gregorian year to read the yearly luck for; default is the current year |
| birth_date* | string | Gregorian birth date, YYYY-MM-DD |
| birth_time* | string | Local clock time of birth in Vietnam time, HH:MM 24-hour. Use 12:00 if unknown and say so. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"birth_date",
"birth_time",
"gender"
],
"properties": {
"name": {
"type": "string",
"maxLength": 60
},
"gender": {
"enum": [
"nam",
"nu"
],
"type": "string",
"description": "\"nam\" = male, \"nu\" = female"
},
"view_year": {
"type": "integer",
"maximum": 2200,
"minimum": 1900,
"description": "Gregorian year to read the yearly luck for; default is the current year"
},
"birth_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Gregorian birth date, YYYY-MM-DD"
},
"birth_time": {
"type": "string",
"pattern": "^([01]?\\d|2[0-3]):[0-5]\\d$",
"description": "Local clock time of birth in Vietnam time, HH:MM 24-hour. Use 12:00 if unknown and say so."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| range | integer | years around the birth year to scan, default 10 |
| gender* | string | "nam" = male, "nu" = female |
| birth_year* | integer | |
| partner_gender | string | default: the opposite gender |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"birth_year",
"gender"
],
"properties": {
"range": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "years around the birth year to scan, default 10"
},
"gender": {
"enum": [
"nam",
"nu"
],
"type": "string",
"description": "\"nam\" = male, \"nu\" = female"
},
"birth_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1920
},
"partner_gender": {
"enum": [
"nam",
"nu"
],
"type": "string",
"description": "default: the opposite gender"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| year* | integer | Gregorian year |
| month* | integer | Gregorian month |
| activity* | string | Activity: viec-chung = Việc chung; cuoi-hoi = Cưới hỏi; an-hoi = Ăn hỏi; khai-truong = Khai trương; nhap-trach = Nhập trạch, chuyển nhà; dong-tho = Động thổ; lam-nha = Làm nhà, sửa nhà; mua-xe = Mua xe; ky-hop-dong = Ký hợp đồng; xuat-hanh = Xuất hành |
| birth_year | integer | Birth year of the person doing it (for weddings: the bride) |
| partner_birth_year | integer | Weddings and engagements only: birth year of the groom |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"activity",
"month",
"year"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Gregorian year"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Gregorian month"
},
"activity": {
"enum": [
"viec-chung",
"cuoi-hoi",
"an-hoi",
"khai-truong",
"nhap-trach",
"dong-tho",
"lam-nha",
"mua-xe",
"ky-hop-dong",
"xuat-hanh"
],
"type": "string",
"description": "Activity: viec-chung = Việc chung; cuoi-hoi = Cưới hỏi; an-hoi = Ăn hỏi; khai-truong = Khai trương; nhap-trach = Nhập trạch, chuyển nhà; dong-tho = Động thổ; lam-nha = Làm nhà, sửa nhà; mua-xe = Mua xe; ky-hop-dong = Ký hợp đồng; xuat-hanh = Xuất hành"
},
"birth_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1920,
"description": "Birth year of the person doing it (for weddings: the bride)"
},
"partner_birth_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1920,
"description": "Weddings and engagements only: birth year of the groom"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| birth_year* | integer | Gregorian birth year (the person's lunar year of birth) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"birth_year"
],
"properties": {
"birth_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1920,
"description": "Gregorian birth year (the person's lunar year of birth)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| slug* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,120}$"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| date | string | Gregorian date YYYY-MM-DD; default is today in Vietnam |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Gregorian date YYYY-MM-DD; default is today in Vietnam"
}
}
}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.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query | string | Vietnamese or unaccented keywords; empty lists the newest articles |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 100,
"description": "Vietnamese or unaccented keywords; empty lists the newest articles"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 9, 2026.