AsterNym

Working · 1.5 s

com.asternym/asternymv1.2.0 Domain verified

Birth charts for agents: BaZi, Chinese and Western zodiac, numerology. Keyless and read-only.

Entertainment & Games

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://asternym.com/mcp

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.

asternym_bazi Read-only

Pillars, day master, hidden stems (藏干) with their ten gods (十神), element counts, dominant and missing elements, na yin, the twelve stages and the void branches. The year turns at Li Chun, not at 1 January or Lunar New Year. Without a time there is no hour pillar and the response says so. The same thing over HTTP: POST https://asternym.com/api/v1/bazi.

datestring, required

Local civil date, YYYY-MM-DD. Required.

tzstring

IANA time zone, e.g. Asia/Singapore. Required when lat and lng are given.

timestring

Local clock time, HH:MM. Omit if unknown; nothing is assumed and noon is never substituted.

agentstring

Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified.

sexCategorystring

Echoed back. Only the luck-pillar cycle reads it, and this endpoint does not return luck pillars.

Tools (6)

asternym_bazi

read-only

Argument	Type	Description
tz	string	IANA time zone, e.g. Asia/Singapore. Required when lat and lng are given.
date*	string	Local civil date, YYYY-MM-DD. Required.
time	string	Local clock time, HH:MM. Omit if unknown; nothing is assumed and noon is never substituted.
agent	string	Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified.
sexCategory	string	Echoed back. Only the luck-pillar cycle reads it, and this endpoint does not return luck pillars.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "date"
  ],
  "properties": {
    "tz": {
      "type": "string",
      "description": "IANA time zone, e.g. Asia/Singapore. Required when lat and lng are given."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Local civil date, YYYY-MM-DD. Required."
    },
    "time": {
      "type": "string",
      "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
      "description": "Local clock time, HH:MM. Omit if unknown; nothing is assumed and noon is never substituted."
    },
    "agent": {
      "type": "string",
      "maxLength": 80,
      "description": "Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified."
    },
    "sexCategory": {
      "enum": [
        "F",
        "M",
        "both"
      ],
      "type": "string",
      "description": "Echoed back. Only the luck-pillar cycle reads it, and this endpoint does not return luck pillars."
    }
  }
}

asternym_bazi_hours

The twelve 時辰 of a day, each with its hour pillar, hidden stems, ten god and the element counts of the whole chart at that hour. The 23:00-00:00 slot is returned separately as lateZi: from 23:00 the hour pillar has already turned to the next day's 子 (早子時) while the day pillar has not, so it differs from the 00:00-01:00 slot on the same date. These are the Chinese double-hours, not the Western planetary hours. The same thing over HTTP: POST https://asternym.com/api/v1/bazi/hours.

read-only

Argument	Type	Description
tz	string	IANA time zone, e.g. Asia/Singapore. Required when lat and lng are given.
date*	string	Local civil date, YYYY-MM-DD. Required.
agent	string	Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified.
element	string	Optional: rank the hours by how much of this element the chart carries.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "date"
  ],
  "properties": {
    "tz": {
      "type": "string",
      "description": "IANA time zone, e.g. Asia/Singapore. Required when lat and lng are given."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Local civil date, YYYY-MM-DD. Required."
    },
    "agent": {
      "type": "string",
      "maxLength": 80,
      "description": "Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified."
    },
    "element": {
      "enum": [
        "Wood",
        "Fire",
        "Earth",
        "Metal",
        "Water"
      ],
      "type": "string",
      "description": "Optional: rank the hours by how much of this element the chart carries."
    }
  }
}

asternym_natal

Ten planets with sign, degree, whole-sign house and retrograde flag; the Ascendant, midheaven and their opposites; the twelve whole-sign houses; the mean lunar nodes; the five major aspects with orb and whether each is applying or separating; plus stelliums, retrogrades and the Moon's phase. Tropical zodiac, geocentric apparent positions, astronomy-engine. This is the one endpoint that requires lat, lng and tz: the angles and houses are a place on the Earth meeting the sky. A time is optional, and without one the angles and houses are null rather than taken from noon, and the Moon is a noon estimate the notes warn about. The same thing over HTTP: POST https://asternym.com/api/v1/natal.

read-only

Argument	Type	Description
tz*	string	IANA time zone, e.g. Asia/Singapore. Required when lat and lng are given.
lat*	number	Decimal degrees.
lng*	number	Decimal degrees.
date*	string	Local civil date, YYYY-MM-DD. Required.
time	string	Local clock time, HH:MM. Omit if unknown; nothing is assumed and noon is never substituted.
agent	string	Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified.

asternym_numerology

Pythagorean numerology: Life Path, birthday number and its components, and with a name the expression, soul urge, personality, cornerstone, capstone and hidden passion. Master numbers are kept where the position allows. The same thing over HTTP: POST https://asternym.com/api/v1/numerology.

read-only

Argument	Type	Description
date*	string	Local civil date, YYYY-MM-DD. Required.
name	string	Optional given name. Without it the name numbers are omitted rather than guessed. Used and discarded; never stored.
agent	string	Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified.
surname	string	Optional surname, used with the given name where the method uses the full name.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Local civil date, YYYY-MM-DD. Required."
    },
    "name": {
      "type": "string",
      "maxLength": 120,
      "description": "Optional given name. Without it the name numbers are omitted rather than guessed. Used and discarded; never stored."
    },
    "agent": {
      "type": "string",
      "maxLength": 80,
      "description": "Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified."
    },
    "surname": {
      "type": "string",
      "maxLength": 120,
      "description": "Optional surname, used with the given name where the method uses the full name."
    }
  }
}

asternym_reading

Sun sign, Chinese animal and element, BaZi day master and pillars, Life Path and the AsterNym identity, from the same engine as every page on the site. The same thing over HTTP: POST https://asternym.com/api/v1/reading.

read-only

Argument	Type	Description
tz	string	IANA time zone, e.g. Asia/Singapore. Required when lat and lng are given.
lat	number	Decimal degrees.
lng	number	Decimal degrees.
date*	string	Local civil date, YYYY-MM-DD. Required.
time	string	Local clock time, HH:MM. Omit if unknown; nothing is assumed and noon is never substituted.
agent	string	Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "date"
  ],
  "properties": {
    "tz": {
      "type": "string",
      "description": "IANA time zone, e.g. Asia/Singapore. Required when lat and lng are given."
    },
    "lat": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Decimal degrees."
    },
    "lng": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Decimal degrees."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Local civil date, YYYY-MM-DD. Required."
    },
    "time": {
      "type": "string",
      "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
      "description": "Local clock time, HH:MM. Omit if unknown; nothing is assumed and noon is never substituted."
    },
    "agent": {
      "type": "string",
      "maxLength": 80,
      "description": "Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified."
    }
  }
}

asternym_zodiac

The Sun's sign from its apparent ecliptic longitude, with a cusp reported rather than resolved by assuming noon, and the Chinese animal, element and polarity with the Lunar New Year boundary. Note the two calendars differ on purpose: the Chinese year here turns at Lunar New Year, while the BaZi year pillar turns at Li Chun. The same thing over HTTP: POST https://asternym.com/api/v1/zodiac.

read-only

Argument	Type	Description
tz	string	IANA time zone, e.g. Asia/Singapore. Required when lat and lng are given.
lat	number	Decimal degrees.
lng	number	Decimal degrees.
date*	string	Local civil date, YYYY-MM-DD. Required.
time	string	Local clock time, HH:MM. Omit if unknown; nothing is assumed and noon is never substituted.
agent	string	Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "date"
  ],
  "properties": {
    "tz": {
      "type": "string",
      "description": "IANA time zone, e.g. Asia/Singapore. Required when lat and lng are given."
    },
    "lat": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Decimal degrees."
    },
    "lng": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Decimal degrees."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Local civil date, YYYY-MM-DD. Required."
    },
    "time": {
      "type": "string",
      "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
      "description": "Local clock time, HH:MM. Omit if unknown; nothing is assumed and noon is never substituted."
    },
    "agent": {
      "type": "string",
      "maxLength": 80,
      "description": "Optional: the name of the agent or product calling. Logged for usage counts; never required, never verified."
    }
  }
}