Nyan Parlor: Tarot, I Ching & BaZi

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.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 3,
      "description": "How many cards to draw (1–10). 1 = single card / yes-no, 3 = past-present-future."
    },
    "allow_reversed": {
      "type": "boolean",
      "default": true,
      "description": "Whether cards can come up reversed."
    },
    "positions": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "maxItems": 10,
      "description": "Optional position names in order, e.g. [\"Past\", \"Present\", \"Future\"]."
    },
    "question": {
      "type": "string",
      "maxLength": 500,
      "description": "The question being asked (echoed back only; not stored)."
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "ja"
      ],
      "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,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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".

{
  "type": "object",
  "properties": {
    "card": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Card name, e.g. \"The Moon\", \"Five of Wands\", 「月」 or 「ワンドの5」."
    },
    "orientation": {
      "type": "string",
      "enum": [
        "upright",
        "reversed",
        "both"
      ],
      "default": "both"
    },
    "topic": {
      "type": "string",
      "enum": [
        "general",
        "love",
        "feelings",
        "career",
        "money",
        "all"
      ],
      "default": "all",
      "description": "Which aspect to return."
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "ja"
      ],
      "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\"."
    }
  },
  "required": [
    "card"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "maxLength": 500,
      "description": "The question being asked (echoed back only; not stored)."
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "ja"
      ],
      "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,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "hexagram": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "description": "Number 1–64, English name, Japanese name or pinyin."
    },
    "lines": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 1,
        "maximum": 6
      },
      "maxItems": 6,
      "description": "Changing line numbers to highlight (1 = bottom)."
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "ja"
      ],
      "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\"."
    }
  },
  "required": [
    "hexagram"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "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)."
    },
    "timezone": {
      "type": "string",
      "minLength": 3,
      "maxLength": 64,
      "description": "IANA time zone of the birthplace, e.g. \"America/New_York\" or \"Asia/Shanghai\"."
    },
    "gender": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Needed only for the direction of the luck pillars."
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "ja"
      ],
      "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\"."
    }
  },
  "required": [
    "birth_date",
    "timezone"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "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."
    },
    "timezone": {
      "type": "string",
      "minLength": 3,
      "maxLength": 64,
      "description": "IANA time zone of the birthplace (e.g. \"America/New_York\"). Only matters for births near the Start of Spring in early February."
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "ja"
      ],
      "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\"."
    }
  },
  "required": [
    "birth_date"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}