Nyan Parlor: Tarot, I Ching & BaZi

Working · 1.8 s

io.github.nyan-parlor/nyan-parlor-mcpv0.2.0

Real random tarot draws, card meanings, I Ching casting, BaZi charts and Chinese zodiac (EN/JA).

Entertainment & Games

Source Website Registry entry

Maintain this server? Claim it

Try it

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

https://www.tarotoper.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.

bazi_chart

Calculate a BaZi / Four Pillars of Destiny chart from a birth date, optional birth time and the birthplace time zone. Uses solar-term boundaries (the year changes at the Start of Spring, Li Chun) via an astronomical calendar engine. Returns the four pillars with Ten Gods, the Day Master, five-element balance, luck pillars and the coming years.

timezonestring, required

IANA time zone of the birthplace, e.g. "America/New_York" or "Asia/Shanghai".

birth_datestring, required

Gregorian birth date, YYYY-MM-DD (local date at the birthplace).

genderstring

Needed only for the direction of the luck pillars.

languagestring

Output language. Use "ja" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise "en".

birth_timestring

Local clock time HH:mm. Omit if unknown (gives a three-pillar chart).

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (6)

bazi_chart

Argument	Type	Description
gender	string	Needed only for the direction of the luck pillars.
language	string	Output language. Use "ja" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise "en".
timezone*	string	IANA time zone of the birthplace, e.g. "America/New_York" or "Asia/Shanghai".
birth_date*	string	Gregorian birth date, YYYY-MM-DD (local date at the birthplace).
birth_time	string	Local clock time HH:mm. Omit if unknown (gives a three-pillar chart).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "birth_date",
    "timezone"
  ],
  "properties": {
    "gender": {
      "enum": [
        "male",
        "female"
      ],
      "type": "string",
      "description": "Needed only for the direction of the luck pillars."
    },
    "language": {
      "enum": [
        "en",
        "ja"
      ],
      "type": "string",
      "default": "en",
      "description": "Output language. Use \"ja\" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise \"en\"."
    },
    "timezone": {
      "type": "string",
      "maxLength": 64,
      "minLength": 3,
      "description": "IANA time zone of the birthplace, e.g. \"America/New_York\" or \"Asia/Shanghai\"."
    },
    "birth_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Gregorian birth date, YYYY-MM-DD (local date at the birthplace)."
    },
    "birth_time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}$",
      "description": "Local clock time HH:mm. Omit if unknown (gives a three-pillar chart)."
    }
  },
  "additionalProperties": false
}

cast_i_ching

Cast an I Ching reading with the traditional three-coin method (six tosses, bottom line first). Returns the primary hexagram, any changing lines and the relating (transformed) hexagram, with links to each hexagram's meaning. Use this instead of making up a hexagram.

Argument	Type	Description
language	string	Output language. Use "ja" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise "en".
question	string	The question being asked (echoed back only; not stored).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "language": {
      "enum": [
        "en",
        "ja"
      ],
      "type": "string",
      "default": "en",
      "description": "Output language. Use \"ja\" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise \"en\"."
    },
    "question": {
      "type": "string",
      "maxLength": 500,
      "description": "The question being asked (echoed back only; not stored)."
    }
  },
  "additionalProperties": false
}

chinese_zodiac

Find a person's Chinese zodiac animal from a birth year or date (handles the Lunar New Year and Start of Spring boundaries for January–February births) and return the 2027 Year of the Fire Goat forecast for that sign: love, career, money and a tip.

Argument	Type	Description
language	string	Output language. Use "ja" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise "en".
timezone	string	IANA time zone of the birthplace (e.g. "America/New_York"). Only matters for births near the Start of Spring in early February.
birth_date*	string	Birth year (YYYY) or full date (YYYY-MM-DD). A full date is needed to be exact for January–February births.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "birth_date"
  ],
  "properties": {
    "language": {
      "enum": [
        "en",
        "ja"
      ],
      "type": "string",
      "default": "en",
      "description": "Output language. Use \"ja\" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise \"en\"."
    },
    "timezone": {
      "type": "string",
      "maxLength": 64,
      "minLength": 3,
      "description": "IANA time zone of the birthplace (e.g. \"America/New_York\"). Only matters for births near the Start of Spring in early February."
    },
    "birth_date": {
      "type": "string",
      "pattern": "^\\d{4}(-\\d{2}-\\d{2})?$",
      "description": "Birth year (YYYY) or full date (YYYY-MM-DD). A full date is needed to be exact for January–February births."
    }
  },
  "additionalProperties": false
}

draw_tarot_cards

Draw tarot cards at random from a full 78-card Rider–Waite–Smith deck (cryptographically random, no repeats). Returns each card with its position, upright/reversed orientation, keywords and a link to its full meaning. Use this instead of inventing cards when a user asks for a tarot reading.

Argument	Type	Description
count	integer	How many cards to draw (1–10). 1 = single card / yes-no, 3 = past-present-future.
language	string	Output language. Use "ja" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise "en".
question	string	The question being asked (echoed back only; not stored).
positions	array	Optional position names in order, e.g. ["Past", "Present", "Future"].
allow_reversed	boolean	Whether cards can come up reversed.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "count": {
      "type": "integer",
      "default": 3,
      "maximum": 10,
      "minimum": 1,
      "description": "How many cards to draw (1–10). 1 = single card / yes-no, 3 = past-present-future."
    },
    "language": {
      "enum": [
        "en",
        "ja"
      ],
      "type": "string",
      "default": "en",
      "description": "Output language. Use \"ja\" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise \"en\"."
    },
    "question": {
      "type": "string",
      "maxLength": 500,
      "description": "The question being asked (echoed back only; not stored)."
    },
    "positions": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "maxItems": 10,
      "description": "Optional position names in order, e.g. [\"Past\", \"Present\", \"Future\"]."
    },
    "allow_reversed": {
      "type": "boolean",
      "default": true,
      "description": "Whether cards can come up reversed."
    }
  },
  "additionalProperties": false
}

get_hexagram

Look up one of the 64 I Ching hexagrams by number (1–64), English name ("The Wanderer"), Chinese character (旅), Japanese name (火山旅) or pinyin (ambiguous pinyin like "lu" returns the candidates). Returns its essence, judgment, image, love and career readings, guidance and the six line texts.

Argument	Type	Description
lines	array	Changing line numbers to highlight (1 = bottom).
hexagram*	string	Number 1–64, English name, Japanese name or pinyin.
language	string	Output language. Use "ja" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise "en".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "hexagram"
  ],
  "properties": {
    "lines": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 6,
        "minimum": 1
      },
      "maxItems": 6,
      "description": "Changing line numbers to highlight (1 = bottom)."
    },
    "hexagram": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1,
      "description": "Number 1–64, English name, Japanese name or pinyin."
    },
    "language": {
      "enum": [
        "en",
        "ja"
      ],
      "type": "string",
      "default": "en",
      "description": "Output language. Use \"ja\" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise \"en\"."
    }
  },
  "additionalProperties": false
}

get_tarot_card_meaning

Look up the meaning of a tarot card: keywords, upright and reversed meaning, love, feelings, career and money readings, and whether it leans yes or no. Accepts names like "The Tower", "3 of Cups", "Queen of Swords" or "ace of coins".

Argument	Type	Description
card*	string	Card name, e.g. "The Moon", "Five of Wands", 「月」 or 「ワンドの5」.
topic	string	Which aspect to return.
language	string	Output language. Use "ja" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise "en".
orientation	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "card"
  ],
  "properties": {
    "card": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Card name, e.g. \"The Moon\", \"Five of Wands\", 「月」 or 「ワンドの5」."
    },
    "topic": {
      "enum": [
        "general",
        "love",
        "feelings",
        "career",
        "money",
        "all"
      ],
      "type": "string",
      "default": "all",
      "description": "Which aspect to return."
    },
    "language": {
      "enum": [
        "en",
        "ja"
      ],
      "type": "string",
      "default": "en",
      "description": "Output language. Use \"ja\" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise \"en\"."
    },
    "orientation": {
      "enum": [
        "upright",
        "reversed",
        "both"
      ],
      "type": "string",
      "default": "both"
    }
  },
  "additionalProperties": false
}